bevy_agent_core 0.0.4

Core schedules, actions, observations, deterministic clock, and plugin types for controllable Bevy simulations.
Documentation

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.

[dependencies]
bevy_agent_core = "=0.0.4"

What this crate provides

  • AgentControlPlugin and the reset, decision, tick, and finalization schedules.
  • AgentAction, AgentActionQueue, and CurrentInputFrame for explicit input.
  • SimClock and DeterministicRng for simulation timing and seeded randomness.
  • Observation, reward, terminal-state, stable-identity, and checksum types.
  • AgentControlAppExt for 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.