thefuntastic/Unity3d-Finite-State-Machine

Health v2 · maintenance only

Adoption not part of the score

1691 stars · 237 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A lightweight, intuitive finite state machine (FSM) library for Unity written in C#. It lets developers define states as enums and implement state behavior via underscore-convention methods inside MonoBehaviours, with reflection-based wiring and zero garbage allocation after initialization.

Use cases

• manage game state like game over, restart, and continue in Unity
• implement NPC and enemy AI behaviour states
• handle UI button states such as hover and press
• drive animation state transitions for game actors
• replace boilerplate-heavy C# state machine implementations with a simple enum-driven API
• build state machines that work on iOS, Android, and IL2CPP builds

When to choose

• you are building a Unity game and need a simple, low-overhead FSM
• you want state logic colocated inside your MonoBehaviour with minimal boilerplate
• you need a battle-tested library that ships in production and supports mobile/IL2CPP
• you prefer convention-based state methods over verbose configuration

When to avoid

• you need a general-purpose C# state machine outside of Unity
• you require hierarchical or pushdown state machines with advanced transition graphs
• you need hierarchical state machines or async/await-driven state flows
• your project no longer targets Unity 2019.4-era APIs and the unmaintained library breaks

Facets

library · maturity maintenance

game-engine concurrency developer-tools gaming-tools cross-platform game-engine cross-platform unity finite-state-machine fsm csharp monobehaviour game-ai state-management game-development mobile desktop

Member repositories

For agents

markdown · JSON · MCP: product_card(name="thefuntastic/Unity3d-Finite-State-Machine")