F3 Architecture document #3

Closed
opened 2026-11-09 05:26:03 +00:00 by claude · 1 comment
Owner

Depends on: F2

Write docs/ARCHITECTURE.md. The game is server-authoritative from day one, and offline play is a local server with bots, so there is one code path and multiplayer is never a retrofit.

Acceptance

  • Covers tick rate (30 Hz simulation), the split between simulation and presentation, the player command stream, entity IDs, snapshot format, the seeded RNG rules, and the module map.
  • States performance budgets: server tick under 12 ms with 24 players, client 60 fps on a GTX 1060-class GPU at medium.
  • Simulation code has no dependency on rendering, audio or UI.
**Depends on:** F2 Write `docs/ARCHITECTURE.md`. The game is server-authoritative from day one, and offline play is a local server with bots, so there is one code path and multiplayer is never a retrofit. **Acceptance** - Covers tick rate (30 Hz simulation), the split between simulation and presentation, the player command stream, entity IDs, snapshot format, the seeded RNG rules, and the module map. - States performance budgets: server tick under 12 ms with 24 players, client 60 fps on a GTX 1060-class GPU at medium. - Simulation code has no dependency on rendering, audio or UI.
claude added this to the v0.1 Foundations milestone 2026-11-09 05:26:03 +00:00
claude added the type/chorepriority/high labels 2026-11-09 05:26:03 +00:00
claude added this to the Tidewall v1.0 project 2026-11-09 15:00:04 +00:00
claude moved this to To Do in Tidewall v1.0 on 2026-11-09 15:00:18 +00:00
eric referenced this issue from a commit 2026-11-09 22:13:17 +00:00
eric closed this issue 2026-11-09 22:13:17 +00:00
Author
Owner

Done in 1d3bee3, with the command size and state hash updated in 27e08db once F5 settled them. docs/ARCHITECTURE.md covers 30 Hz ticks, the simulation and presentation split, the command stream, entity IDs, snapshot format, seeded RNG rules, the module map and the performance budgets.

test/project/test_sim_isolation.gd enforces the separation by scanning src/sim for rendering, audio, UI and scene-tree use, global random calls and wall-clock use, and for any generator created outside sim_rng.gd. The client 60 fps budget can't be verified with software rendering, and the doc says so.

Done in 1d3bee3, with the command size and state hash updated in 27e08db once F5 settled them. `docs/ARCHITECTURE.md` covers 30 Hz ticks, the simulation and presentation split, the command stream, entity IDs, snapshot format, seeded RNG rules, the module map and the performance budgets. `test/project/test_sim_isolation.gd` enforces the separation by scanning `src/sim` for rendering, audio, UI and scene-tree use, global random calls and wall-clock use, and for any generator created outside `sim_rng.gd`. The client 60 fps budget can't be verified with software rendering, and the doc says so.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: claude/tidewall#3