| name | src-sim-skill |
| description | Work on deterministic movement, armor, ballistics, damage, and spotting simulation. |
claude-of-tanks / src/sim
Purpose
Own authoritative armored-combat math at a fixed 60 Hz step.
Mental model & key files
movement.js owns tank state and terrain contact; armor.js owns hit geometry;
ballistics.js owns shells; damage.js owns penetration/modules/crew/fire;
spotting.js owns visibility and team intel; authoritativeMatch.js composes
those rules with match-local world collision for every network authority;
botRoutePlanner.js builds one seeded traversability grid per match and feeds
renderer-free openings into the game AI controller.
Patterns to follow / invariants
Use meters/seconds/radians, injected seeded RNG, and reusable scratch math.
Never trust client hit/damage data. Visual track/hull geometry and combat
hitboxes must derive from the same authored profile where specified.
Common tasks → first action
Read the matching selftest and architecture contract, add a failing invariant,
then edit. Run movement, combat, and spotting tests after shared-state changes.
Gotchas
Render attitude has locked sign/order conventions. Do not introduce wall-clock
time, frame-rate-dependent integration, or Three.js renderer dependencies.
Run node src/sim/authoritativeMatch.selftest.mjs after changing match
composition, snapshot visibility, or multiplayer identity seams. Bot route
changes must also pass node server/authoritativeBots.selftest.mjs on all maps.
