state-machine-architect

What problem does it solve?

This Skill eliminates the repetitive and error-prone work of hand-writing state management and transition logic by providing a reusable, type-safe state machine architecture and scaffolding for game controllers, AI, and UI flows.

Core Features & Use Cases

• Modular generic StateMachine, IState, and StateBase templates designed for Unity C# projects and similar environments.
• A Python generator script to scaffold context controllers and individual state classes with namespace support and multiple states.
• Supports hierarchical and history-aware transitions, event hooks for OnStateChanged, and clear separation of state responsibilities.
• Common use cases include player movement controllers (Idle, Walk, Run, Jump), enemy AI (Patrol, Chase, Attack), and game flow management (MainMenu, Playing, Paused, GameOver).

Quick Start

Run the included state_gen.py to scaffold a PlayerController with states Idle,Walk,Run,Jump in the Game.Player namespace by supplying the context, states, and namespace arguments to the generator.