How mandalorian007/thunderclap-engine works
ThunderClap is a WebGPU game engine, accompanied by Rust crates for authoritative multiplayer simulation and serving. A game developer boots a game through createGame, builds game-specific scenes and rules, and the engine runs frames while coordinating rendering, input, UI, audio, saves and host lifecycle. For networked games, a separate server accepts WebSocket sessions and hands requests to the simulation. The README documents engine capabilities; sampled Rust excerpts show server/session and live-query boundaries, but not every connection between them.
Main entry points: game.ts Game bootstrap · session.rs Client session · renderer.ts WebGPU renderer · input.ts Input and gestures
Components 22
Game runtime
- Game bootstrap
src/core/game.ts - Frame loop
src/core/loop.ts - Platform host
src/host
Graphics and content
- WebGPU renderer
src/render/renderer.ts - Post processing
src/post/post-stack.ts - World effects
src/fx - Game content
src/models - Voxel worlds
src/voxel/world.ts - Navigation
src/nav/query-queue.ts
Player experience
- Input and gestures
src/input/input.ts - XR controls
src/xr/controller.ts - HUD and overlays
src/ui/hud.ts - Audio system
src/audio/audio.ts - Save system
src/save/store.ts
Multiplayer server
- WebSocket server
crates/tc-net/src/server.rs - Client session
crates/tc-net/src/session.rs - Wire protocol
crates/tc-net/src/envelope.rs - Connection auth
crates/tc-net/src/auth.rs
Authoritative simulation
- Game simulation
crates/tc-sim/src/game.rs - Live queries
crates/tc-sim/src/query.rs - Query synchronization
crates/tc-sim/src/sync/mod.rs
Other components
- Game developer
Connections 20
- Game developer → Game bootstrap: boots game
- Game bootstrap → Frame loop: starts loop
- Game bootstrap → WebGPU renderer: creates renderer
- Game bootstrap → Post processing: sets up post
- Game bootstrap → Input and gestures: sets up input
- Game bootstrap → HUD and overlays: sets up overlay
- Game bootstrap → Audio system: sets up audio
- Game bootstrap → Save system: sets up save
- Game bootstrap → Platform host: sets up host
- WebGPU renderer → Post processing: feeds post stack
- Game developer → Game content: defines models
- Game developer → Voxel worlds: builds voxel worlds
- Game developer → Navigation: requests paths
- Input and gestures → XR controls: supports XR input
- WebSocket server → Client session: runs sessions
crates/tc-net/src/server.rs - Client session → Connection auth: verifies token
crates/tc-net/src/session.rs - Client session → Wire protocol: decodes messages
crates/tc-net/src/session.rs - Client session → Game simulation: hands requests
- Game simulation → Live queries: defines queries
crates/tc-sim/src/game.rs - Query synchronization → Live queries: refreshes queries
crates/tc-sim/src/query.rs