# MaaAssistantArknights/MaaAssistantArknights **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/maaassistantarknights-maaassistantarknights).** 19,613 stars · 2,494 forks · C++ · agpl-3.0 ## Links - GitHub: https://github.com/MaaAssistantArknights/MaaAssistantArknights - Homepage: https://maa.plus - awesome-repositories: https://awesome-repositories.com/repository/maaassistantarknights-maaassistantarknights.md ## Topics `arknights` `computer-vision` `maa` ## Description MaaAssistantArknights is a cross-platform automation engine designed for mobile games, utilizing computer vision and input simulation to perform routine tasks. It functions as an Android emulator controller, managing game lifecycles, resource farming, and infrastructure optimization through structured, scripted workflows. The project distinguishes itself through a modular configuration system that allows users to define complex automation logic via external instruction files. This framework supports dynamic task modification, configuration inheritance, and schema validation, ensuring that custom strategies and combat sequences remain consistent and reusable. By leveraging template-based image recognition, the tool adapts to localized game interfaces and varying hardware environments, providing a flexible approach to mobile game interaction. Beyond its core automation capabilities, the system includes a headless interface for programmatic execution and integration with external applications. It provides an API for real-time status callbacks and data synchronization, enabling users to export inventory and progress information to community databases. The engine also handles emulator connectivity and dependency management, offering a comprehensive suite of tools for debugging and monitoring task execution. ## Tags ### Game Development - [Mobile Game Automation Tools](https://awesome-repositories.com/f/game-development/mobile-game-automation-tools.md) — Automates repetitive daily tasks and resource farming in mobile games using image recognition and simulated touch inputs. - [Emulators](https://awesome-repositories.com/f/game-development/web-retro-environments/emulators.md) — Connects to and controls mobile device emulators to automate game application lifecycles. - [Gaming Platform Integrations](https://awesome-repositories.com/f/game-development/online-multiplayer/gaming-platform-integrations.md) — Extracts inventory and progress information to update external community databases and planning tools. ([source](https://docs.maa.plus/en-us/)) ### Mobile Development - [Android Automation Frameworks](https://awesome-repositories.com/f/mobile-development/automation-qa/android-automation-frameworks.md) — Uses image recognition and input simulation to perform routine tasks in mobile games. ### Development Tools & Productivity - [Task Automation Tools](https://awesome-repositories.com/f/development-tools-productivity/task-automation-tools.md) — Automates repetitive daily tasks and resource farming through scripted instructions. ([source](https://docs.maa.plus/en-us/)) - [Automation Execution Frameworks](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/automation-execution-frameworks.md) — Provides structured environments to build, standardize, and execute automated combat sequences. ([source](https://docs.maa.plus/en-us/protocol/copilot-schema.html)) - [Workflow Automation APIs](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-apis.md) — Provides programmatic interfaces for external applications to trigger tasks and receive status callbacks. ([source](https://docs.maa.plus/en-us/)) - [Custom Scripting Engines](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/system-integration-interfaces/automation-integration/custom-scripting-engines.md) — Provides environments for defining and executing custom combat strategies and task workflows. - [Task Composition Engines](https://awesome-repositories.com/f/development-tools-productivity/task-scheduling/task-composition-engines.md) — Constructs complex automation sequences using expression-based operators to control execution flow. ([source](https://docs.maa.plus/en-us/protocol/task-schema.html)) - [Workflow Automations](https://awesome-repositories.com/f/development-tools-productivity/workflow-automations.md) — Enables headless execution of game management tasks via command-line interfaces. - [Build Automation Engines](https://awesome-repositories.com/f/development-tools-productivity/build-automation-engines.md) — Manages core engine dependencies and game resource files to ensure the automation environment remains functional. ([source](https://docs.maa.plus/en-us/manual/cli/)) - [Headless Execution Environments](https://awesome-repositories.com/f/development-tools-productivity/headless-execution-environments.md) — Executes automation tasks on servers or within scripts using a command-line interface. ([source](https://docs.maa.plus/en-us/)) ### DevOps & Infrastructure - [Game Lifecycle Controllers](https://awesome-repositories.com/f/devops-infrastructure/game-server-management-panels/game-lifecycle-controllers.md) — Launches and terminates game applications automatically, including support for multi-account and regional switching. ([source](https://docs.maa.plus/en-us/protocol/integration.html)) - [Combat Stage Automators](https://awesome-repositories.com/f/devops-infrastructure/deployment-stage-management/combat-stage-automators.md) — Runs combat stages repeatedly with configurable limits on resource consumption and battle counts. ([source](https://docs.maa.plus/en-us/protocol/integration.html)) - [Browser-Based Workflow Automations](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/workflow-engines/browser-based-workflow-automations.md) — Automates base operations by scheduling room layouts and shift rotations during daily gameplay cycles. ([source](https://docs.maa.plus/en-us/protocol/base-scheduling-schema.html)) - [Parallel Execution Strategies](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/automation-frameworks/action-execution/parallel-execution-strategies.md) — Executes user-defined stage clearing sequences by processing external instruction files. ([source](https://docs.maa.plus/en-us/)) ### Hardware & IoT - [Input Simulation Bridges](https://awesome-repositories.com/f/hardware-iot/design-lifecycle-management/hardware-engineering-management/hardware-management/input-simulation-bridges.md) — Maps desktop peripheral events into native mobile input signals for direct hardware manipulation. ### Artificial Intelligence & ML - [Computer Vision Libraries](https://awesome-repositories.com/f/artificial-intelligence-ml/computer-vision-systems/computer-vision/development-orchestration-tools/computer-vision-libraries.md) — Processes visual data from game interfaces to execute complex sequences of user-defined actions. - [Visual Recognition Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-templates/macro-based-templating/visual-recognition-templates.md) — Identifies game interface elements by matching screen captures against a library of predefined visual assets. ### Graphics & Multimedia - [Headless Automation](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/video-analysis-processing/media-automation/headless-automation.md) — Provides a command-line interface for programmatic game task execution and status callbacks. ### Software Engineering & Architecture - [External Application Integrations](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/workflow-automation-integrations/external-application-integrations.md) — Enables data flow and task synchronization between the automation engine and external applications. ([source](https://docs.maa.plus/en-us/protocol/callback-schema.html)) - [Task Execution Engines](https://awesome-repositories.com/f/software-engineering-architecture/task-execution-engines.md) — Manages and executes background automation tasks using structured configuration files. - [Automated Task Execution Engines](https://awesome-repositories.com/f/software-engineering-architecture/automated-task-execution-engines.md) — Executes predefined game automation routines programmatically to manage daily activities. ([source](https://docs.maa.plus/en-us/manual/cli/)) - [Event-Driven Messaging Hooks](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/reactive-messaging/reactive-event-driven-systems/event-driven-messaging-hooks.md) — Provides standardized interfaces for real-time communication between external systems and core automation logic. - [Tree-Based Optimization](https://awesome-repositories.com/f/software-engineering-architecture/trees/tree-node-templates/tree-based-optimization.md) — Calculates optimal operator assignments to facilities to maximize resource production. ([source](https://docs.maa.plus/en-us/)) ### User Interface & Experience - [Interface Localization](https://awesome-repositories.com/f/user-interface-experience/interface-localization.md) — Updates image templates and text definitions to align automation behavior with localized game interfaces. ([source](https://docs.maa.plus/en-us/develop/overseas-client-adaptation.html))