CLI-Tool
MaaAssistantArknights/MaaAssistantArknights avatar
MaaAssistantArknights/MaaAssistantArknights

MAA: Der bilderkennungsbasierte Tagesassistent für Arknights

| Ein Ein-Klick-Tool für die täglichen Aufgaben von Arknights, das alle Kunden unterstützt.

23.264 Sterne2.841 ForksC++AGPL-3.0

Auf einen Blick

Was ist das?
MAA Assistant Arknights ist ein in C++ geschriebener Helfer, der Tagesaufgaben im Handyspiel Arknights per Bilderkennung automatisiert, Daten an Statistikdienste meldet und über viele Schnittstellen integrierbar ist.
Für wen ist es gedacht?
MAA ist für Spieler von Arknights gedacht, die tägliche Routinen wie Materialfarmen, Basisplanung, Rekrutierung und Freundesbesuche an ein werkzeugbasiertes Programm abgeben wollen; wer die Kundenträger International, Japan, Korea oder Traditionell-Chinesisch nutzt, muss wegen unvollständiger Tests einzelne Funktionen selbst prüfen. Wer Bedenken gegen automatisierte Zugriffe im Spiel hat, sollte die Nutzungsbedingungen seiner Plattform klären.
Darf ich es kommerziell nutzen?
Ja, unter strengen Bedingungen. AGPL-3.0 ist eine Lizenz mit Netzwerk-Copyleft: Wenn andere eine veränderte Version über ein Netzwerk nutzen, etwa als gehosteten Dienst, müssen Sie ihnen den Quellcode unter derselben Lizenz anbieten.
Wird es noch gepflegt?
Ja. Die letzten Commits kamen vor 1 Tag.
In welcher Sprache ist es geschrieben?
Hauptsächlich C++, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

Was hinter der Abkürzung MAA steckt

MAA steht für MAA Assistant Arknights. Das Repository beschreibt das Programm als Ein-Klick-Werkzeug für die Tagesaufgaben des Spiels, das alle Clients unterstützt. Laut README arbeitet es über Bilderkennung, und das Ziel ist formuliert als: alle täglichen Aufgaben mit einem Klick erledigen. Die primäre Sprache ist C++, der Standardzweig heißt dev-v2, und das Projekt wird laufend weiterentwickelt.

Die Einordnung ist nötig: MAA bedient nicht den strategischen Teil des Spiels, sondern den Wiederholungsalltag. Die Automatisierung liest den Bildschirm, erkennt Spielzustände und steuert das Spiel. Welche Funktionen dabei konkret entstehen, schreibt das README in einer Liste der herausgehobenen Fähigkeiten, in der wahrscheinlich jede Gruppe von Spielern etwas für sich findet.

Download, Neulingsanleitung und CLI für Server ohne GUI

Installationsschritte enthält das README nicht. Es verweist zuerst auf die Neulingsseite der Dokumentation, danach auf die offizielle Website maa.plus oder die GitHub-Releases, und für die Einrichtung noch einmal auf dieselbe Neulingsanleitung. Die Dokumentation ist unter docs.maa.plus in mehreren Sprachen verfügbar, darunter Deutsch nicht; vertreten sind Chinesisch, Traditionell-Chinesisch, Englisch, Japanisch und Koreanisch.

Für Betrieb ohne Oberfläche gibt es eine Kommandozeilen-Schnittstelle, die laut README unter Linux, macOS und Windows läuft. Das macht MAA für Skripte und für Server ohne grafische Umgebung interessant. Ein eigener CLI-Leitfaden in der Dokumentation erklärt die Bedienung; im README steht dazu nur der Verweis.

Kampf, Dropraten und Werkzeug-Exporte

Ein zentraler Block sind die Einsätze: MAA führt Kampfoperationen aus, erkennt die abfallenden Materialien und lädt die Ergebnisse auf die Statistikportale penguin-stats und yituliu hoch. Dazu gehört die Erkennung von Anbaumaterialien aus der eigenen Sammlung, die sich in den Planer von penguin-stats, die Arknights-Werkzeugkiste unter arkntools.app und die ARK-NIGHTS-Operatorliste exportieren lässt.

Diese Anbindung ist mehr als Kosmetik. Die Statistikseiten sammeln gemeinschaftlich Dropraten, und MAA speist diese Daten am Ende wieder ein. Wer die Datenübertragung lieber unterlässt, muss das in den Einstellungen des Programms berücksichtigen; das README listet keine lokalen Schalter, sondern beschreibt die Uploads als Teil der Funktionen.

Basisplanung, Rekrutierung und Operatorlisten

Die Basisautomatik plant laut README den Schichtwechsel: MAA berechnet die Effizienz der Operatoren, sucht die günstigste Einteilung und unterstützt sogar Kombinationen über mehrere Einrichtungen hinweg. Wer selbst planen will, kann eigene Schichtpläne über ein JSON-Schema hochladen, das in den Protokoll-Unterseiten beschrieben ist.

Die Rekrutierung wird automatisch abgeschlossen, optional mit beschleunigenden Genehmigungen, und die Rekrutierungsdaten gehen ebenfalls an penguin-stats und yituliu. Daneben erkennt MAA die Operatorliste, zählt vorhandene und fehlende Operatoren samt Potenzialstufen und zeigt das Ergebnis in der Rekrutierungsansicht an. Für wertvolle hohe Rekrutierungen gibt es eine manuelle Erkennung der Rekrutierungsansicht, damit der Spieler selbst entscheiden kann.

Auto-Battle, Roguelike und der Alltagsrest

Für schwierige Stufen gibt es die Kopilot-Funktion: Man wählt eine JSON-Datei mit einer Beschreibung der Schlacht aus, und MAA führt die Operation aus. Das README verlinkt ein Videobeispiel auf Bilibili. Der Roguelike-Modus sammelt automatisch Material und Stufenaufstiege, erkennt Operatoren samt Trainingsstand und kann den Start neu würfeln, um eine günstige Anfangsauswahl zu erhalten.

Den Rest des Alltags übernimmt die Sammlung der täglichen Erledigungen: Freunde besuchen, Guthaben abholen, Einkäufe tätigen und Tagesbelohnungen abgreifen. Genau dieser Teil macht das Versprechen eines Klicks für den Tagesablauf aus, weil die häufigsten Wiederholungen zusammengefasst sind.

Schnittstellen für die eigene Integration

Der Kern ist über mehrere Sprachbindungen ansprechbar. Das README listet C über die Include-Datei AsstCaller.h, Python über src/Python/asst/asst.py, Golang, Java, Rust sowie Java-HTTP und Rust-HTTP, dazu eine Dart-Bindung, eine TypeScript-Bindung über das MaaX-Projekt und eine Woolang-Bindung. Zu jeder Bindung nennt das README Beispielcode im Repository.

Für die Kommunikation definiert die Dokumentation Protokolle: die Integration selbst, das Rückrufnachrichten-Schema, das Aufgabenablauf-Schema und das Auto-Battle-Schema. Rund um MAA stehen verwandte Projekte, darunter das neue Framework MaaFramework, Frontend und Backend der Job-Sharing-Seite prts.plus, das Frontend von maa.plus und MaaAI für maschinelles Lernen.

Serverunterstützung, Lizenz und GPU-Hinweis

Für Übersee-Clients erklärt das README: Die meisten Funktionen unterstützen internationalen, japanischen, koreanischen und traditionell-chinesischen Server, aber wegen geringer Nutzerzahlen und knapper Kapazität sind viele Funktionen nicht umfassend getestet. Fehler und Wünsche kann man über Issues und Diskussionsseiten melden; eine Anleitung zur Anpassung für Übersee-Server liegt in der Dokumentation.

MAA steht unter der GNU Affero General Public License v3.0 only und bringt eine zusätzliche Nutzervereinbarung im Repository mit. Ausdrücklich nicht unter AGPL steht das Logo: Die Urheberinnen und alle Entwickler behalten die Rechte daran, und eine kommerzielle Nutzung ohne Genehmigung ist untersagt. Für GPU-Beschleunigung unter Windows nutzt MAA laut README die Microsoft-Komponente DirectML, die nicht zum Open-Source-Code gehört; eine DirectML.dll wird mitgeliefert und kann entfernt werden, wenn keine Beschleunigung nötig ist.

Redaktionelles Fazit

MAA ist für Spieler von Arknights gedacht, die tägliche Routinen wie Materialfarmen, Basisplanung, Rekrutierung und Freundesbesuche an ein werkzeugbasiertes Programm abgeben wollen; wer die Kundenträger International, Japan, Korea oder Traditionell-Chinesisch nutzt, muss wegen unvollständiger Tests einzelne Funktionen selbst prüfen. Wer Bedenken gegen automatisierte Zugriffe im Spiel hat, sollte die Nutzungsbedingungen seiner Plattform klären. Als erste Schritte empfiehlt sich die Neulingsanleitung unter docs.maa.plus, dann ein Testlauf auf einem unterstützten Client, bevor man MAA an eigene Skripte anbindet; die AGPL-3.0 verlangt bei Verteilung von Änderungen die Freigabe des Quellcodes.

Offizielle Quellen

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Community-Notizen

Community-Notizen