Rijad Zuzo
2.4 KiB
Simulation benchmark ledger
This directory stores reviewed benchmark snapshots. Each snapshot must name the workload, seed, Godot version, hardware context, sample count, simulated tick count, and important exclusions so later comparisons remain honest.
Run the current scaling harness from the project root with Godot 4.7:
/Applications/Godot.app/Contents/MacOS/Godot \
--headless --path "$PWD" \
--script res://tools/benchmark_simulation_scaling.gd
The default report is written under user://. Pass
-- --host-label="<hardware>" --output=res://docs/benchmarks/<name>.json only
when intentionally capturing a reviewed project baseline.
Loaded-resource discovery has its own bounded runner:
/Applications/Godot.app/Contents/MacOS/Godot \
--headless --path "$PWD" \
--script res://tools/benchmark_loaded_resource_discovery.gd
The regional record/scheduler workload has a separate honest runner:
/Applications/Godot.app/Contents/MacOS/Godot \
--headless --path "$PWD" \
--script res://tools/benchmark_regional_scale.gd
It constructs five settlements, 20 caravans, 2,000 named people, 50,000 aggregate residents, and 2,025 deterministic due jobs. It measures record construction, canonical roundtrip, scheduler construction, and job draining; it does not claim rendered or full-economy throughput.
Reviewed captures:
- Regional scale baseline 01 records the primitive regional state and deterministic scheduler workload at five settlements, 20 caravans, 2,000 named people, and 50,000 aggregate residents.
- Simulation scaling baseline 01 records the first full-fidelity population/history measurements and the bounded next optimization.
- Simulation scaling baseline 02 records checksum-identical results after the shared per-tick population view: the 600-NPC case is 23.3% faster, while small fixtures expose its fixed cost.
- Simulation scaling baseline 03 versions the workload after conflict was added, requires one authoritative combatant per synthetic NPC, and records 90.63 ticks/s at 600 full-fidelity records.
- Loaded Resource Discovery 01 compares the former all-node scan with the exact resource-anchor grid at 18, 180, and 1,800 loaded sources.