# derkork/godot-statecharts

A state charts extension for Godot 4

Repository: https://github.com/derkork/godot-statecharts
Canonical: https://ross.abutalabs.com/products/godot-statecharts
Homepage: https://derkork.github.io/godot-statecharts/
Language: GDScript
License: MIT
License Family: permissive
Last push: 2026-06-26T09:12:05+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 89, release rhythm 78, longevity 91
- inputs: {"age_days": 1274, "days_push": 68, "days_rel": 68, "gap_med": 37, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1605, forks 78 (observed 2026-08-28T04:05:10.315376+00:00)

## What it is
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
- artifact type: plugin
- maturity: active
- function: state-management, game-engine
- domain: -
- platform: game-engine
- tags: godot, godot-4, gdscript, c-sharp, statecharts, finite-state-machine, game-ai, editor-plugin, game-development

## Member repositories
- derkork/godot-statecharts (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:10.315376+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:52:16.486627+00:00, confidence not recorded.
  - readme: https://github.com/derkork/godot-statecharts (fetched 2026-08-28T04:05:10.315376+00:00, sha 1bd68495f0ed)
  - homepage: https://derkork.github.io/godot-statecharts/ (fetched 2026-08-29T11:23:50.343193+00:00, sha 3d106985f696)
- Data as of 2026-08-30T08:39:29.467469+00:00.