AdamskAI: free, open-source agent behavior as text (statechart + behavior trees), UE 5.6–5.8

**AdamskAI** is a free MIT plugin for NPC behavior in Unreal Engine 5.6–5.8. It is a statechart of modes with a behavior tree in each, written in strict XML. You check it headlessly before Play, reload it while the game runs, and replay it exactly from a seed.

**GitHub:** GitHub - RazielSun/AdamskAI: Text-authored AI for Unreal Engine: statecharts + behavior trees in XML, validated before Play, live reload, exact replay. · GitHub

### Why text

- **Behavior is text.** It diffs, gets reviewed and merges like code. A coding agent can write it from the node catalogue.

- **Errors before Play.** A strict compiler and a headless validator report typos, unknown nodes, type mismatches, holds and livelocks as `path:line` diagnostics, including in CI with no renderer.

- **Exact replay.** Randomness is seeded per agent, so a run replays from its seed, inputs and events.

- **Live reload.** Save the XML while playing and every agent keeps its current state.

- **Cheap at rest.** Waiting or walking brains sleep. 1000 brains cost about 0.1 ms per frame.

### What it looks like

```xml

```

Mistakes show up before you press Play:

### Demo

A demo map with seven scenes ships in the plugin: patrols, interrupts, squad calls, attack tokens, live reload and a 1000-brain fleet with its cost on screen. Open `L_AdskDemo`, press Play and type `adsk.Demo Chase`.

### Measured

The same behavior written three ways and run with 1000 agents: AdamskAI 0.08–0.15 µs per agent per frame, Behavior Tree 0.12–0.13, StateTree 0.20–0.22. The README has the method and caveats.

### Honest limits

There is no graph editor (only a read-only diagram), nodes are C++ only, the state machine has no parallel regions and there is no montage node yet. If you want visual authoring and Blueprint nodes, Behavior Trees and StateTree are the better choice. The README has a full comparison.

### Status

0.5.0 beta. XML v1 is stable; the C++ API may still change. Tested on Linux, Win64 and Android (arm64/x64), with about 650 automation tests. Not built on Mac yet.

Feedback, issues and PRs are welcome, especially from anyone who has fought with BT or StateTree diffs in a team.