python-action-guide

What problem does it solve?

This skill eliminates the guesswork and common errors developers face when writing Python CustomActions for MaaNTE, ensuring code integrates correctly with MaaFramework and follows project coding standards.

Core Features & Use Cases

• Full Development Lifecycle Coverage: Provides guidance on architecture design, action registration, naming conventions, Controller API usage, Pipeline integration, error handling, and logging for MaaNTE Python custom actions.
• Pre-built Component References: Documents built-in common actions (click_override, alt_click) and shared utility functions to reduce redundant code development.
• Use Case: Use this skill when implementing complex game automation logic like image-based state detection, audio triggers, or rhythm game mechanics that cannot be handled by standard Pipeline JSON configurations.

Quick Start

Consult this guide when writing or modifying Python custom actions for MaaNTE to ensure proper registration, correct MaaFramework API usage, and alignment with project coding standards.