Bevy Base Management Framework

Headless-first Bevy framework for deterministic base-management strategy games.

The framework is a reusable foundation, not a finished game. It gives a game project stable primitives for rooms, resources, autonomous agents, jobs, missions, incidents, save/load, metrics, content validation, batch smoke runs, and explicit definition reloads for local tooling.

Use From A Game

Use the prelude as the normal integration surface:

use bevy_base_management::prelude::*;

Game-owned content lives outside the framework. Validate definitions before long runs, enqueue normal gameplay intent as GameCommand values, and persist runtime references with SimId rather than Bevy Entity.

Provided Features

• Deterministic fixed-tick simulation with seeded RNG.
• Persistent runtime identity through SimId.
• Command-driven gameplay with every command ending as Accepted or Rejected.
• Definition loading, resource storage, grid/rooms/POI, agents/travel, jobs, missions, events, agent conditions, and room upgrades.
• Explicit save/load using framework save roots, not debug dumps.
• Stable CSV/JSONL/TXT metrics for regression testing and tooling.
• Content validation, local deterministic batch runner, and explicit hot reload for new runtime instances.

Maintenance Scope

This repository is in maintenance mode. Acceptable work is limited to bugfixes, tests, documentation, determinism fixes, public API boundary corrections, validation clarity, save/load compatibility fixes, metrics formatting fixes, and small generic improvements that remain useful to multiple base-management games.

Do not add game-specific systems here. UI, audio, lore, campaign clocks, research trees, tactical combat, multiplayer, modding, game balancing, and concrete game content belong in a game built on top of the framework.

Audit

Run the normal checks:

cargo fmt
cargo test
cargo clippy --all-targets -- -D warnings
cargo run --bin validate_content -- assets/definitions

Run the full local maintenance audit before releases or after runtime, save/load, validation, metrics, batch, or hot reload changes:

powershell -ExecutionPolicy Bypass -File .\scripts\framework_audit.ps1

If an output directory already contains files, choose a deterministic alternate path or use the script's matching clean switch after review.

Key Docs

• docs/SUPPORTED_FEATURES.md
• docs/ARCHITECTURE_CONTRACTS.md
• docs/FEATURE_AUDIT_MATRIX.md
• docs/MAINTENANCE.md
• docs/PUBLIC_API.md
• docs/INTERNAL_API_RULES.md
• docs/RELEASE_CHECKLIST.md
• RELEASE_NOTES_v0.1.0.md