bevy_agent_runner
Step, inspect, snapshot, restore, and branch a Bevy game through a Rust environment API.
Part of bevy-agent. Requires Bevy 0.18.1 and Rust 1.91+. Version 0.0.4 is experimental; pin all companion crates to the same exact version.
[]
= "=0.0.4"
= "=0.0.4"
= "=0.0.4"
Control an integrated game
The app builder must install AgentControlPlugins, register gameplay state, and configure metadata, supported actions/modes, observations, and checksums. Construction validates this contract.
use App;
use AgentAction;
use ;
The packaged counter example contains a complete, headless app and exercises reset, stepping, snapshots, and replay:
Run that command from the repository or this crate's unpacked source. Read the example to build your own environment.
Features and guarantees
- Default features are headless;
visualenables Bevy render/window capture support. AgentControlPlugins::default()installs core, snapshots, and replay. Configure retention throughwith_snapshot_policy.step_manyand fast-forward stop at terminal state.- Mutation failures report the committed tick and recovery state. A faulted environment requires a successful reset.
- Snapshot and replay owners each default to a configurable 64 MiB retention budget.
- Checksums detect consistency errors; they do not authenticate artifacts or guarantee identical behavior across platforms.
Verify your environment
The counter also includes two runnable tests:
Run this from the repository or unpacked crate. It checks gameplay assertions, repeated seeded resets, snapshot restoration, and replay reconstruction. The testing guide explains how to adapt these checks to your game.
After each step, inspect done and truncated before continuing. Read observation to choose the next action, and use checksum to compare equivalent transitions. Snapshots contain registered authoritative state; they do not clone rendering or transport resources.
Next steps
Licensed under MIT OR Apache-2.0, at your option.