derkork/godot-statecharts

Health v2 · maintenance only

Adoption not part of the score

1605 stars · 78 forks observed · 2026-08-28

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

A state charts extension for Godot Engine 4 that lets developers model game logic as hierarchical state charts using Godot nodes and signals. It avoids the state explosion problem of traditional finite state machines and supports both GDScript and C#.

Use cases

• manage game character AI states in Godot
• replace finite state machines with state charts in Godot 4
• build enemy behavior states without state explosion
• create cooldowns and delayed transitions in game logic
• debug and inspect game states while the game is running
• model UI or gameplay flow as declarative states and transitions

When to choose

• You are building a Godot 4 game and need robust state management beyond a simple FSM
• You want declarative, node-based states and transitions with guards and delayed transitions
• You need in-editor error checking and a runtime debug view for your state logic

When to avoid

• You are not using Godot Engine
• Your state logic is trivial and a hand-rolled enum-based FSM is sufficient
• You need state charts in a non-game application outside the Godot runtime

Facets

plugin · maturity active

state-management game-engine game-engine godot godot-4 gdscript c-sharp statecharts finite-state-machine game-ai editor-plugin game-development

Member repositories

For agents

markdown · JSON · MCP: product_card(name="derkork/godot-statecharts")