Cách làm tool auto game cho mọi game Android trong MAS

Hướng dẫn này chỉ cách làm tool auto game cho bất kỳ game Android nào trong Macro Automation Studio (MAS), từ một game đã cài đến một bot chạy theo lịch, trên một hoặc nhiều tài khoản. Bot MAS làm việc từ màn hình: chúng tìm nút bằng ảnh, đọc bộ đếm bằng OCR, và chạm với nhịp giống người, đó là cốt lõi của cách làm tool auto game bền. Trang dành cho người lần đầu làm bot trên Windows hoặc Mac.

Play

How to make a bot for any game

Trước khi bắt đầu

• MAS đã cài và bạn đã đăng nhập với bản dùng thử miễn phí hoặc gói. Xem Cài đặt MAS.
• Game chạy trên thiết bị MAS điều khiển được: giả lập trên máy tính này, thiết bị cloud, hoặc điện thoại của bạn. Xem Thiết bị.
• Thiết bị nằm trong một nhóm thiết bị và thẻ của nó hiển thị Đã dừng, không phải Lỗi. Trang Bắt đầu hướng dẫn thêm thiết bị.
• Với cách dùng Python, bạn không cần gì thêm. MAS mang theo môi trường Python riêng với gói mas.

Cách làm tool auto game Android: ba cách

Cài từ Marketplace

Cách nhanh nhất khi đã có người dựng bot cho game của bạn.

1. Mở Marketplace và tìm game.
2. Mở mục đó và nhấn Tải xuống. Bot xuất hiện trong Macro.
3. Trong Nhóm thiết bị, mở nhóm của bạn, chọn bot trong ô Macro của thiết bị và nhấn Bắt đầu.

Hướng dẫn đầy đủ kèm ảnh chụp là Cách chạy macro từ Marketplace. Bot làm sẵn có cho Whiteout Survival, Kingshot và Last Asylum: Plague.

Nhờ MAS Agent

Cách không cần viết mã cho game chưa có trên Marketplace.

1. Mở Agent và chọn thiết bị.
2. Mô tả thao tác trong một câu, gồm cả lúc nào nên dừng, và nhấn Viết macro.
3. Trả lời khi agent hỏi. Nó dừng lại hỏi thay vì đoán.
4. Khi macro vượt qua 3 lần chạy kiểm chứng, nhấn Thêm vào Macro của tôi.

Việc viết tiêu tốn credit AI; chạy macro đã hoàn thành thì không tốn gì. Kết quả là một dự án Python bình thường mà bạn mở và chỉnh được. Xem MAS Agent.

Tự dựng bằng Python

Toàn quyền kiểm soát mọi quyết định của bot. Phần còn lại của trang này là cách này.

Auto game Android bằng Python

1. Liệt kê những gì bot phải thấy

Chơi thao tác đó một lần bằng tay và ghi lại mọi màn hình nó đi qua. Đó là nút bạn nhấn, các popup chen ngang, bộ đếm hiển thị năng lượng, và thông báo cho biết bạn đã xong. Mỗi mục trở thành một ảnh mẫu hoặc một vùng OCR. Bot biết trạng thái dừng của mình thì không bao giờ chạy mù.

2. Tạo dự án

1. Mở Macro và nhấn Tạo dự án mới.
2. Chọn Code-Based, đặt Thiết bị đích là mobile, đặt tên dự án và nhấn Tạo dự án.
3. Mở dự án. Code Editor hiển thị src/app.py, tệp mà MAS chạy.

3. Chụp ảnh mẫu trong Asset Lab

1. Khởi động game trên thiết bị và đi tới màn hình có nút.
2. Trong Code Editor, mở bảng Tài nguyên và nhấn Mở Asset Helper. Asset Lab mở với màn hình đang chạy.
3. Cắt một hình chữ nhật sát quanh nút và lưu. Nó vào Thư viện ảnh của bạn với một ID dạng số.
4. Lặp lại cho nút đóng popup, nút xác nhận và thông báo “hết năng lượng”.
5. Quay lại bảng Tài nguyên, dùng Sao chép ID trên từng ảnh và dán các ID vào mas.images ở đầu mã của bạn.

Giữ mẩu cắt nhỏ và đặc trưng. Cả một màn hình chỉ khớp đúng màn hình đó; một nút thì khớp ở bất cứ đâu nút xuất hiện. Ảnh mẫu có thể là jpg, png, gif hoặc webp, tối đa 10 MB mỗi tệp. Trang Asset Lab nói chi tiết về công cụ.

4. Chụp vùng OCR

1. Trong Asset Lab, vẽ một khung quanh bộ đếm bạn muốn đọc.
2. Chạy kiểm thử OCR trực tiếp và thu hẹp khung cho đến khi các chữ số trả về sạch.
3. Chép tọa độ vào một Region(x1, y1, x2, y2) trong mã của bạn.

Hướng dẫn OCR giải thích các chế độ phân đoạn và chuyển đổi màu nếu chữ đọc kém.

5. Viết vòng lặp

Vòng lặp bên dưới là hình dạng mà mọi bot game đều có chung. Mỗi dòng ứng với một lời gọi SDK:

• find_object_retry tìm nút tối đa total_tries=3 lần, cách nhau time_sleep=2.0 giây, và trả về None khi không khớp gì.
• click(x, y, delay_ms=1000) chạm vào điểm giữa kết quả khớp và chờ một giây cho game phản ứng.
• read_text(region, psm=7) đọc bộ đếm như một dòng đơn.
• time.sleep(random.uniform(0.8, 2.0)) thêm một khoảng nghỉ giống người giữa các lượt.
• mas.save và mas.retrieve giữ bộ đếm lượt, nên lần chạy bị dừng sẽ tiếp tục từ chỗ đã dừng.
• Điều kiện dừng kết thúc vòng lặp. Ví dụ dùng năm điều kiện: số lượt tối đa, ngân sách thời gian, ảnh mẫu “hết năng lượng”, bộ đếm thấp, và quá nhiều lần trượt liên tiếp.

6. Chạy và đọc nhật ký

Chọn thiết bị trong Code Editor và nhấn Chạy (F5). Mọi dòng mas.log xuất hiện trong bảng điều khiển chạy. Dừng là Shift+F5. Sửa từng thứ một: khi không tìm thấy ảnh mẫu, cắt lại trước khi đụng đến logic.

7. Lập lịch

1. Mở Lập lịch và nhấn Tạo lịch mới.
2. Điền Tên, chọn Macro và Cổng giả lập, đặt Ngày và Giờ.
3. Đặt Chu kỳ là Hằng ngày và nhấn Tạo lịch.

Ứng dụng phải mở; bộ lập lịch chạy bên trong nó. Xem Bộ lập lịch và Vòng lặp và lập lịch.

8. Chạy trên nhóm thiết bị

Thêm instance giả lập của mỗi tài khoản làm một thiết bị trong một nhóm, gán bot cho từng thiết bị và nhấn Bắt đầu tất cả. Giá trị riêng cho từng thiết bị như tên tài khoản đến từ hồ sơ cài đặt. Xem Nuôi acc đa nhiệm.

Một bot ví dụ hoàn chỉnh

Thay ID ảnh và vùng bằng những gì bạn đã chụp. Mã này cày tài nguyên cho đến khi năng lượng xuống thấp, hết ngân sách thời gian, hoặc đủ ba mươi lượt, và nó sống sót qua khởi động lại.

import random
import sys
import time

import mas
from mas import Region

images = mas.images({
    "attack_button": 101,
    "confirm_button": 102,
    "close_popup": 103,
    "out_of_energy": 104,
})

ENERGY_REGION = Region(x1=380, y1=20, x2=520, y2=60)
TASK = "farm_bot"
MAX_ROUNDS = 30
TIME_BUDGET_S = 20 * 60
MIN_ENERGY = 10


def pause(low=0.8, high=2.0):
    time.sleep(random.uniform(low, high))


def read_energy():
    result = mas.read_text(region=ENERGY_REGION, psm=7)
    digits = "".join(ch for ch in result.text if ch.isdigit())
    return int(digits) if digits else None


def clear_popups():
    popup = mas.find_any_object([images.close_popup, images.confirm_button])
    if popup:
        mas.click(popup.x, popup.y, delay_ms=800)
        return True
    return False


def main():
    rounds = mas.retrieve(TASK).get("rounds", 0)
    misses = 0
    started = time.monotonic()
    mas.log(f"Starting at round {rounds}")

    while rounds < MAX_ROUNDS:
        if time.monotonic() - started > TIME_BUDGET_S:
            mas.log("Time budget reached", level="warning")
            break
        if clear_popups():
            continue
        if mas.find_object(images.out_of_energy):
            mas.log("Out of energy, stopping")
            break
        energy = read_energy()
        if energy is not None and energy < MIN_ENERGY:
            mas.log(f"Energy {energy} is below {MIN_ENERGY}, stopping")
            break
        button = mas.find_object_retry(images.attack_button, total_tries=3, time_sleep=2.0)
        if button is None:
            misses += 1
            mas.log(f"Attack button not found ({misses})", level="warning")
            if misses >= 5:
                mas.log("Giving up after 5 misses", level="error")
                sys.exit(2)
            continue
        misses = 0
        mas.click(button.x, button.y, delay_ms=1000)
        pause()
        rounds += 1
        mas.save(TASK, {"rounds": rounds})
        mas.log(f"Round {rounds} of {MAX_ROUNDS}")

    if rounds >= MAX_ROUNDS:
        mas.clear(TASK)
    mas.log(f"Finished with {rounds} rounds")


if __name__ == "__main__":
    main()

sys.exit(2) đánh dấu lần chạy là thất bại, nên webhook đăng ký macro.failed sẽ biết. Thoát sạch báo macro.completed. Xem Webhook.

Mẹo giữ bot ổn định

• Độ phân giải. Ảnh mẫu và vùng gắn với độ phân giải và DPI lúc bạn chụp. Giữ mọi thiết bị chạy bot ở cùng cài đặt; các hướng dẫn giả lập dùng 540x960 ở chế độ dọc và 240 DPI làm chuẩn cơ sở.
• Vệ sinh ảnh mẫu. Chỉ cắt nút, không bao giờ cắt nền quanh nó. Cắt lại sau khi bản cập nhật game đổi hình. Khi một nút có hai kiểu hiển thị, chụp cả hai và tìm bằng find_any_object.
• Điều kiện dừng. Mỗi vòng lặp cần ít nhất hai: một bộ đếm hoặc ngân sách thời gian, và một trạng thái màn hình nghĩa là “xong”. Bot không có chúng sẽ chạy cho đến khi bạn để ý.
• Chậm lại. Khoảng nghỉ một đến hai giây giữa các lượt tốn rất ít mà trông ít máy móc hơn.
• Ghi lại quyết định, không phải cú chạm. mas.log("Energy 8, stopping") cho bạn biết vì sao lần chạy kết thúc; nhật ký của một trăm cú nhấp thì không.

Điều gì có thể sai

Không bao giờ tìm thấy nút

Mẩu cắt quá lớn, ngưỡng quá chặt với hình vẽ, hoặc thiết bị chạy ở độ phân giải khác với lúc bạn chụp. Cắt lại sát hơn, rồi thử threshold=0.7 trên lời gọi. Hướng dẫn nhận diện hình ảnh có danh sách kiểm tra đầy đủ.

Bộ đếm đọc sai số

Vùng bao gồm một biểu tượng bên cạnh, hoặc chữ sáng trên nền tối. Thu hẹp khung trong Asset Lab và truyền color_conversion=ColorConversion.BLACK_WHITE. Hướng dẫn OCR chỉ cách kiểm tra độ tin cậy.

Bot dừng ngay lập tức vào ngày thứ hai

Bộ đếm đã lưu đang ở mức giới hạn. Ví dụ xóa bộ nhớ khi đạt MAX_ROUNDS; nếu bạn đã đổi điều đó, gọi mas.clear("farm_bot") một lần từ một đoạn mã nháp.

Cú nhấp rơi cạnh nút

Độ phân giải hoặc DPI của giả lập đã đổi sau khi chụp, hoặc cửa sổ không ở chế độ dọc. Đặt lại màn hình giả lập về cài đặt lúc chụp và chụp lại bất cứ thứ gì vẫn trượt.

Không có công cụ tự động hóa nào an toàn 100%, vì vậy hãy tự động hóa một cách có trách nhiệm và theo quyết định của riêng bạn.