hub / github.com/andrew-gresyk/HFSM2
github.com/andrew-gresyk/HFSM2 @2.12.1
Chat with this repo
2,265 symbols
4,026 edges
111 files
56 documented · 2%
● updated 18d ago2.12.1 · 2026-06-10★ 6151 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
High-Performance Hierarchical Finite State Machine
Header-only heriarchical FSM framework in C++11, with fully statically-defined structure (no dynamic allocations), built with variadic templates.
Compiler Support
- Visual Studio: 2015, 2017, 2019, 2022
- GCC: 10, 11, 12, 13, 14, 15
- GCC (ARM): 13
- Clang: 13, 14, 15, 16, 17, 18
- AppleClang (Intel): 17
- AppleClang: 15, 17
Quick Start
See Also
- HFSM2 UPlugin: Unreal Engine plugin for HFSM2 library
- FFSM2: High-Performance Flat Finite State Machine
- FFSM2 UPlugin: Unreal Engine plugin for FFSM2 library
- HFSM Mono: Monospaced bitmap Unicode fonts for HFSM2 and FFSM2 libraries
Documentation
Feature Highlights
- Permissive MIT License
- Written in widely-supported modern(ish) C++11
- Header-only
- Convenient, minimal boilerplate
- Fully static, no dynamic allocations
- Uses inline-friendly compile-time polymorphism, no virtual methods are used
- Type-safe transitions:
FSM.changeTo<TargetState>()with optional payloads - Flexible configuration using
HFSM2_ENABLE_*macros - Scalable, supports robust state re-use via state injections
- Hierarchical, with a selection of composite (sub-machine) and orthogonal regions
- Gamedev and embedded friendly
- Also supports traditional event-based workflow with
State::react() - Inspect anything: previous and current transitions, state activation status, and more!
- Game AI-friendly with dynamic planning support
- Utility theory support (max score and ranked weighted random)
- Serializable, with activity and transition history support
- Debug-assisted, includes automatic structure and activity visualization API with
#define HFSM_ENABLE_STRUCTURE_REPORT - Built-in logging support
3rd Party Libraries
Get In Touch
- Twitter: @andrew_gresyk
- Discord: HFSM.dev
- Gitter: andrew-gresyk/HFSM2
Special Thanks
- alexandrosk0
- Casey Sanchez
- DJuego
- Jan Aleksandrov
- Kevin Greene
- Kjeld Mathias Petersen
- Lau Bakman
- Mehdi Houshmand
- mrcmry
- Phil Nash
- Romain Cheminade
- Schoppenglas
- Tristan Brindle
- C++::London meetup
- programming community at Splash Damage
Core symbols most depended-on inside this repo
assertSequence
called by 130
examples/snippets/wiki_utility-theory.cpp
payload
called by 83
development/hfsm2/detail/plans/task.hpp
get
called by 59
include/hfsm2/machine.hpp
empty
called by 47
include/hfsm2/machine.hpp
clear
called by 42
include/hfsm2/machine.hpp
set
called by 33
include/hfsm2/machine.hpp
display
called by 22
examples/calculator/main.cpp
react
called by 21
examples/calculator/main.cpp
Shape
Languages
C++100%
Python1%
Modules by API surface
test/reported/stress_size.cpp402 symbols
external/doctest/doctest.h320 symbols
include/hfsm2/machine.hpp101 symbols
examples/calculator/main.cpp85 symbols
test/test_internal_payloads.cpp73 symbols
test/test_internal_transitions.cpp67 symbols
test/test_plans_payloads.cpp55 symbols
test/test_plans.cpp52 symbols
development/hfsm2/detail/structure/forward.hpp43 symbols
test/test_randomize.cpp35 symbols
test/test_plan_external_payloads.cpp33 symbols
examples/snippets/wiki_utility-theory.cpp33 symbols
For agents
$ claude mcp add HFSM2 \
-- python -m otcore.mcp_server <graph>