bevy_agent_core
Deterministic simulation primitives for agent-controlled Bevy games.
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"
What this crate provides
AgentControlPluginand the reset, decision, tick, and finalization schedules.AgentAction,AgentActionQueue, andCurrentInputFramefor explicit input.SimClockandDeterministicRngfor simulation timing and seeded randomness.- Observation, reward, terminal-state, stable-identity, and checksum types.
AgentControlAppExtfor metadata, action catalogs, schemas, and extractors.
Run authoritative gameplay in AgentTick, consume domain actions, and read SimClock instead of frame time. A game must declare its supported actions and observation modes and install both observation and checksum extractors. Determinism depends on the game's state coverage and system ordering.
For a complete environment, start with bevy_agent_runner::AgentControlPlugins and AgentApp; the runner composes core, snapshots, and replay.
How to use it
Most games start with the runner's composed plugins and use this crate's types directly. Put authoritative systems in AgentTick, consume CurrentInputFrame<AgentAction>, and use SimClock for simulation time. A Noop action still advances the simulation; its gameplay effect belongs to your systems.
The complete counter shows metadata, a supported action catalog, observation schema, and both extractors in one app. Move on to actions and observations for domain-specific commands.
Next steps
Read the guide for an organized walkthrough, examples, and troubleshooting.
Licensed under MIT OR Apache-2.0, at your option.