Total Claude — technical documentation

The Aurelian Wall in raking light, the Juthungi host beyond it and Rome behind — a frame from the game's own screenshot harness.

A real-time historical battle simulator in TypeScript and Three.js: roughly nine thousand individually simulated soldiers, the Aurelian Wall of Rome in 271 AD and Carthage in 146 BC. Play it here.

These pages are written for somebody who has to change the code, not for somebody deciding whether to try the game. Each volume assumes you will have the repository open beside it, and names files and symbols rather than describing them.

Technical volumes

How the thing actually works, one subsystem per volume.

Simulation

Nine thousand soldiers, the pool that holds them, and the fixed step that moves them.

Rendering

Instancing, materials, lighting and the frame budget.

Siege

Walls, bays, escalade and the orders that move men along a parapet.

Tooling and verification

The harnesses, the probes, and the blind A/B instrument.

Reference

Written for a different reader, and still the best account of what is where.

Architecture

Systems, the engine loop, and where a new subsystem goes.

Carthage

The 146 BC map: survey, fortifications and the city plan.

Visual rubric

The criteria a frame is graded against.

Releasing

Commit, deploy, verify by bundle hash, tag, release.

Appendix

A running log. Useful, long, and not a starting point.

Handoff log

The session-by-session record. Long; search it rather than read it.

Built from the documentation in docs/. Every image on this site is our own render.