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.2 is experimental; pin all companion crates to the same exact version.
[]
= "=0.0.2"
= "=0.0.2"
= "=0.0.2"
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.
Next steps
Read the guide for an organized walkthrough, examples, and troubleshooting.
Licensed under MIT OR Apache-2.0, at your option.