General Purpose State Machine 1.2.1 Scripts 4.6 Community

Submitted by user kraasch; MIT; 2026-07-30

A general purpose state machine which can express states and transitions between them. Feature are...

- Comes in a single file (addons/gpsm/code/gpsm_main.gd).
- Does not clutter the name space, only adds GPSM as class.
- Is not based on Nodes, but on a RefCounted script.
- Provides 4 signals for each state and 2 signals for each transition.
- Entirely based on Godot's signals.
- Well documented (50% of code = amount of comments).
- Good test coverage (200% of code = amount of tests).
- Comes with gdunit4 tests.
- Comes with example project.
- Tests can be deleted (addons/gpsm/tests).
- Examples can be deleted (addons/gpsm/examples).

Can be used as basis for more complex state machines or can be used as a fully functional state machine.
See code repository's README file for instructions or example sub-folder for a demo.