What problem does it solve?
Provides a clear, structured way to write and run headless DES (Debug Execution System) scenarios so developers can validate game mechanics, reproduce bugs, and catch regressions without manual playtesting.
Core Features & Use Cases
- Deterministic Execution: Use seeded RNG to reproduce outcomes reliably across runs.
- Rich Action & Assertion Language: Schedule player and entity actions, apply mocks, and assert player, enemy, map, quest, and status conditions.
- Inheritance & Mocks: Base scenario inheritance and mock settings let you compose common setups and force deterministic behaviors for focused tests.
- Use Case: Validate movement, combat resolution, inventory interactions, quest progression, and environmental effects in automated CI or developer testing.
Quick Start
Run the DES scenario tests/scenarios/basic_movement.json with a fixed seed to verify player movement and assertions succeed.