How maa1999/m9a works
M9A is a MaaFramework-driven game automation assistant. Its principal workflow starts an agent runtime, registers custom automation components, and uses image recognition and simulated controls to carry out game tasks. The README lists a broad set of task capabilities, represented here by feature families because most individual action implementations were not sampled. The graph also shows resource versioning and hot updates as a supporting runtime layer. Feature-family paths identify their exact source directory; detailed dispatch wiring is not visible in the excerpts.
Main entry points: agent_runtime.py Agent lifecycle · __init__.py Custom registration · combat.py Combat farming · manifest_checker.py Manifest checks
Components 20
Agent runtime
- Agent entry
agent/main.py - Agent lifecycle
agent/agent_runtime.py - Custom registration
agent/custom/__init__.py
Game automation
- Daily tasks
agent/custom/action - Combat farming
agent/custom/action/combat.py - Promotion navigation
agent/custom/reco/auto_promotion.py - Trail recognition
agent/custom/reco/auto_trail.py - Event automation
agent/custom/action - Silence event
agent/custom/action/syndrome_of_silence.py - General recognition
agent/custom/reco/general.py - Combat recognition
agent/custom/reco/combat.py
Runtime support
- Manifest checks
agent/utils/manifest_checker.py - Resource updater
agent/utils/resource_updater.py - HTTP session
agent/utils/http_session.py - Runtime paths
agent/utils/runtime_paths.py - Parameter parsing
agent/utils/params.py - Recognition types
agent/utils/maa_types.py - Logging
agent/utils/logger.py
Other components
- User / client
- MaaFramework
Connections 19
- Agent entry → Agent lifecycle: calls
agent/main.py - Agent lifecycle → Custom registration: registers
agent/agent_runtime.py - Agent lifecycle → MaaFramework: starts agent
agent/agent_runtime.py - Custom registration → Daily tasks: registers actions
agent/custom/__init__.py - Custom registration → General recognition: registers recognitions
agent/custom/__init__.py - Custom registration → Combat recognition: registers recognitions
agent/custom/__init__.py - MaaFramework → Combat farming: invokes task
- MaaFramework → Promotion navigation: invokes recognition
- Combat farming → Combat recognition: uses recognition
agent/custom/action/combat.py - Promotion navigation → Trail recognition: resets state
agent/custom/reco/auto_promotion.py - Silence event → MaaFramework: runs recognition
agent/custom/action/syndrome_of_silence.py - Agent lifecycle → Manifest checks: checks resources
agent/agent_runtime.py - Agent lifecycle → Resource updater: requests updates
agent/agent_runtime.py - Manifest checks → HTTP session: uses session
agent/utils/manifest_checker.py - Resource updater → HTTP session: uses session
agent/utils/resource_updater.py - Manifest checks → Runtime paths: uses paths
agent/utils/manifest_checker.py - Resource updater → Runtime paths: uses paths
agent/utils/resource_updater.py - Combat farming → Parameter parsing: parses parameters
agent/custom/action/combat.py - Combat farming → Recognition types: uses result types
agent/custom/action/combat.py