Inspiaaa/UnityHFSM

Health v2 · maintenance only

Adoption not part of the score

1599 stars · 155 forks observed · 2026-08-28

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

UnityHFSM is a lightweight, hierarchical finite state machine library for the Unity game engine, written in C#. It supports both class-based states and lambda-based rapid prototyping, with a focus on timing-sensitive state transitions and zero GC allocations after setup.

Use cases

• implement NPC AI behavior states in Unity
• manage player character states like walk, run, sneak, jump
• organize complex game logic such as weapon handling with firing, cooling, and reloading
• build hierarchical state machines to reduce duplicate code between states
• prototype game logic quickly with lambda-based states
• handle timing and synchronization sensitive state transitions
• use state machines with Unity coroutines

When to choose

• you are building a Unity game and need to organize state-based logic like AI or character behavior
• you want a state machine with no GC allocations during state changes to avoid lag spikes
• you need hierarchical states to share logic between related states
• you want fast prototyping with lambda states and easy migration to class-based states
• you need precise control over state transition timing

When to avoid

• you need a visual node-based state machine editor rather than a code API
• your project does not use Unity or .NET/C#
• you need behavior trees or utility AI rather than finite state machines
• you want a full-featured AI framework with pathfinding and sensing built in

Facets

library · maturity stable

game-engine developer-tools gaming-tools cross-platform game-engine cross-platform unity fsm finite-state-machine hierarchical csharp gamedev coroutines ai-behavior no-gc-allocations game-development

Member repositories

For agents

markdown · JSON · MCP: product_card(name="Inspiaaa/UnityHFSM")