MAA_Punish is an open-source automation assistant for "Punishing Gray Raven," designed to automate daily tasks and in-game activities using image recognition and simulated control. Powered by the MaaFramework, it aims to significantly reduce manual player effort.

How It Works

The assistant analyzes game visuals via image recognition and simulates user input to execute actions. It leverages the MaaFramework, a dedicated game automation engine, enabling black-box interaction with the game client without direct integration.

Quick Start & Requirements

• Installation: Download pre-compiled releases from GitHub Releases. For Windows, extract the zip file and run FOS.exe. For macOS, extract the tarball and run FOS. Specific instructions cater to different architectures (x86_64, aarch64) and extraction methods.
• Prerequisites: Windows requires the latest Microsoft Visual C++ Redistributable. Android emulators may need a 1280x720 resolution with 240DPI. macOS users might need to bypass Gatekeeper security for unsigned applications.
• Building from Source: Requires recursive git clone, downloading MaaFramework releases to deps, and running python ./tools/ci/install.py.

Highlighted Details

• Automates numerous in-game tasks: daily logins, gacha pulls, dormitory commissions, various combat modes (Simulated Extermination, Warzone, Phantom Pain Cage), resource farming, mail claiming, shop purchases, and stamina collection.
• Supports automated "Roguelike" modes across multiple expansions.
• Includes a framework for custom automated combat logic per character, with many characters already supported.

Maintenance & Community

The project is community-driven, with feedback and issues directed to a QQ group (965061066). It is built upon and acknowledges contributions to the MaaFramework.

Licensing & Compatibility

Released under the MIT license, it's an independent component. Commercial use is permitted, provided no official endorsement is implied.

Limitations & Caveats

• Android automation may require specific emulator configurations (1280x720, 240DPI).
• macOS users must handle Gatekeeper security restrictions for unsigned applications.
• The project is provided "as is" with no warranty; users assume all risks.