af9f1ad66d
- server/relay.mjs: WebSocket room (ws, 127.0.0.1:8433 behind a proxy).
Relays positions/edits/repairs/platter states; keeps the authoritative
world diff + quest state for late joiners; persists to booth-state.json.
Hardened: origin allowlist, 24-peer cap, 2KB frames, 40 msg/s budget,
bounds+type validation on every message, ping/terminate dead sockets.
- src/net/NetClient.ts: offline-tolerant client — mirrors bus events out,
applies remote events with an echo guard (quest.repair/platter setters
are idempotent/deduped so replication can't loop). 10Hz delta'd positions.
- src/net/Avatars.ts: voxel-person avatars with headphones + name tags,
lerped to network updates.
- Menu: DJ name setting (auto-generated default); help page multiplayer note.
- main.ts: wires avatars + status chip ('online - N other DJs in the booth').
Verified with two live tabs: mutual avatars, block edit + quest repair
replicate both ways, late-joiner gets full state replay, non-gameplay
setBlock correctly does NOT sync, zero console errors, relay log clean.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
||
|---|---|---|
| .claude | ||
| docs | ||
| server | ||
| src | ||
| .gitignore | ||
| demo-audio.html | ||
| demo-engine.html | ||
| demo-machines.html | ||
| demo-player.html | ||
| demo-worldgen.html | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
TURNCRAFT
Honey I Shrunk the DJ. A Minecraft-style voxel game where the entire world is a vinyl DJ booth — two Technics-style 1200s, a 4-channel mixer, cable canyons, a patch-bay dungeon, and circuit-board caves — and you're 7 mm tall, riding the records.
- Design: docs/DESIGN.md
- Rules for parallel build lanes: docs/CONTRACTS.md
- Integration (after lanes land): docs/INTEGRATION.md
Building it with parallel agent lanes
Five independent lanes, disjoint file ownership, shared contracts already
written in src/core/ (read-only for all lanes).
| lane | brief | delivers |
|---|---|---|
| A | docs/briefs/LANE_A_ENGINE.md | voxel storage, greedy mesher, procedural texture atlas, renderer |
| B | docs/briefs/LANE_B_PLAYER.md | FPS controller, voxel collision, ride-the-record platform physics |
| C | docs/briefs/LANE_C_WORLDGEN.md | the whole booth, built parametrically in voxels |
| D | docs/briefs/LANE_D_MACHINES.md | spinning platters, tonearm, faders, break/place, the quest |
| E | docs/briefs/LANE_E_AUDIO_FX.md | synthesized house groove in stems, beat-reactive lights, HUD |
Launch prompt for each lane (separate session/agent each, all five at once):
Read docs/CONTRACTS.md, docs/DESIGN.md, and docs/briefs/LANE_X_….md, then implement the lane exactly as briefed. Work only inside your owned paths. Verify with your demo page and the acceptance checklist, write your HANDOFF.md, and ensure
npm run typecheckpasses.
Recommended: git init first and give each lane its own branch or worktree;
ownership is disjoint so merges are trivial.
Run
npm i
npm run dev # game shell at /, lane demos at /demo-<lane>.html
npm run build # static bundle