MaaAssistantArknights
MaaAssistantArknights
简体中文 | 繁體中文 | English | 日本語 | 한국어
MAA means MAA Assistant Arknights
An Arknights assistant
Based on image recognition, helps you to complete daily quests efficiently!
Development in progress ✿✿ヽ(°▽°)ノ✿
Features
- Auto-battle, drop items recognition, auto-uploading to Penguin Stats.
- Auto-shifting in the Base, auto efficiency calculation of operators, optimal solution in single room.
- Auto-recruitment, support for expedited plan. Auto-uploading recruitment data to Penguin Stats, Yituliu.
- Visiting friends, collecting credits and purchasing items, collecting daily rewards, completing daily quests in one click!
- Auto-battle for Integrated Strategy (I.S.) for collecting originium ingots and candles.
- Importing JSON task file for auto-battle! Video
- Depot recognition and upports exporting to Penguin Stats Planner, Arknight Tools, and ARK-NIGHTS Operator Builds
- Support C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP and other interfaces, easy to integrate and call, customize your MAA!
Talk is cheap. Show me the pictures!
Download
How to Use
Basic Settings
- Please refer to Emulator Supports to configure your emulator.
- Change your emulator resolution to
1280 * 720
or higher, the maximum is2K
, with16:9
aspect ratio.
For YostarEN, due to game interfaces issues, we recommend changing the resolution to1920 * 1080
. - Enjoy it!
See also: User Manual
FAQ
- The program crashes immediately when I try to run it.
- Connection error/not knowing how to fill in ADB path.
- Connected successfully, then it got stuck.
- Custom connection settings.
- Download speed is too slow, or the mirror site is not accessible.
- Download halfway and prompt "login"/"authentication"
Please refer to: FAQ
Supports for overseas clients
At present, most of the functions of the International client (US client), Japanese client, Korean client, and traditional Chinese client have been supported. However, due to the small number of overseas users and the shortage of project personnel, many functions have not been fully tested, so please experience it yourself.
If you encounter a bug, or have a strong demand for a certain function, welcome to Issues and Discussions to ask questions. And feel free to join us in building the MAA! Please refer to Overseas Clients Adaptation
Associated Projects
- New Framework: MaaFramework
- New GUI: MaaAsstElectronUI
- Co-pilot (auto-battle) site: frontend
- Backend: MaaBackendCenter
- Website: frontend
- Deep Learning: MaaAI
Acknowledgements
Open-source Libraries
- Image recognition: opencv
OCR: chineseocr_lite- OCR: PaddleOCR
- ML Deployment: FastDeploy
- ML accelerator: onnxruntime
Item drop recognition: Penguin Stats recognizer- Map tile recognition: Arknights-Tile-Pos
- C++ JSON library: meojson
- C++ operator parser: calculator
C++ Base64 encoding/decodingcpp-base64- C++ ZIP library: zlib
- C++ Gzip library: gzip-hpp
- Touch event producer for Android: minitouch
- Touch event producer for Android: MaaTouch
- WPF MVVM framework: Stylet
- WPF control library: HandyControl
- C# JSON library: Newtonsoft.Json
- Downloader: aria2
Data Source
Recruitment data: ArkToolsOperators and infrastructure data: PRTS Arknights Wiki (Chinese)- Stage data: Penguin Stats
- Gamedata and resources: Arknights Game Resource
Gamedata: Arknights Game Data
Contributors
Thanks to all friends who contribute to development/testing for making MAA better! (*´▽`)ノノ
Development Related Information
Windows
Download pre-built third-party libraries.
python maadeps-download.py
Open
MAA.sln
with Visual Studio 2022, right-clickMaaWpfGui
and set it as the startup project.Right-click
MaaWpfGui
- Properties - Debugging - Enable Local Debugging (so you can hang the breakpoint on the C++ Core).(Optional) If you are going to submit a PR, I recommend you enable clang-format support.
Linux/MacOS
Please refer to Linux Tutorial
API
- C interface: Integration Example
- Python interface: Integration Example
- Golang interface: Integration Example
- Dart interface
- Java interface: Integration Example
- Java HTTP interface
- Rust interface: HTTP interface
- TypeScript interface
- Integration Documentation
- Callback Schema
- Task Schema
- Copilot Schema
Overseas Clients Adaptation
Please refer to Overseas clients Adaptation. For the functions already supported by the CN client, most of the overseas clients adaptation tasks only need screenshots and simple JSON modification.
For Novice Users of GitHub
Issue Bot
Please refer to Issue Bot Usage
Disclaimer
- The logo of this software is NOT granted rights under AGPL 3.0 License. 耗毛 and Vie, the two artists and all developers of the software reserves all rights. The logo of the software shall not be used without authorization even if the project has an AGPL 3.0 License. Nor shall the logo be used for commercial purposes without authorization.
- The software is an open-source, free of charge software only for studying and communication purposes. There is no agreement or understanding between the developers of the software and the 3rd party person who uses this software as an assistant and charges you. In that case, the developers of the software is not responsible for the problems and consequences caused.
Advertisement
User Group: Telegram, QQ Group
Copilot JSON Sharing
Bilibili Live: live coding on this program
Technical Discussion (QQ Group)
Dev Group(QQ Group)
Please click "Star" if you consider it helpful! Thank you for your support!