What it does
An inspectable local SDK for simulated characters. It consumes observations, selects an intent and exposes task commands while the host engine owns navigation, animation and side effects.
- Model sensory events, memory and faction disposition.
- Use utility scoring and hysteresis to select behavior.
- Integrate through task hooks, a host task sink or the versioned C ABI.
Start with an inspectable example
- Build the supplied console example with a C++20 compiler and CMake.
- Feed a fixed sequence of observations and consume decisions each tick.
- Implement host adapters and test their side effects separately.
cmake -S Npc-ai -B Npc-ai/build -DCMAKE_BUILD_TYPE=Release
cmake --build Npc-ai/build --config Release
ctest --test-dir Npc-ai/build --build-config Release --output-on-failureUse the current repository instructions for setup, dependencies and version-specific commands.
Scope and verification
This SDK is not a physics engine, pathfinder, LLM or finished game-engine plugin. Deterministic replay assumes a fixed build, platform and floating-point environment.
Reviewed against the public project documentation on 9 November 2026. The source repository remains the reference for releases, licensing and supported features.