[claude] Three.js scene foundation — navigation modes + performance budget (#4) #28

Merged
Timmy merged 1 commits from claude/the-nexus:claude/issue-4 into main 2026-03-24 01:30:27 +00:00
Member

Fixes #4

What was added

Navigation modes (press V to cycle):

  • Walk — WASD movement on ground plane, hold-drag mouse to look
  • Orbit — drag to rotate around a focal point, scroll wheel to zoom, WASD to pan target
  • Fly — free 3D movement: WASD + Q/E (up/down), mouse look, no floor constraint
  • Smooth camera state sync when switching between modes
  • Nav mode displayed in HUD controls bar (gold label)

Performance budget:

  • Auto-detects device tier at startup (mobile, medium, high/M3 Max)
  • Low (mobile): no shadows, 1× DPR, 25% particle count
  • Medium (<8 cores): 1.5× DPR, 1024 shadow map, 60% particles
  • High (M3 Max): 2× DPR, 2048 shadow map, full particles
  • Tier shown in debug overlay

Camera improvements:

  • Shadow map resolution now scales with tier (512/1024/2048)
  • Orbit theta/phi computed from current camera position when entering orbit mode for seamless transition
Fixes #4 ## What was added **Navigation modes (press V to cycle):** - **Walk** — WASD movement on ground plane, hold-drag mouse to look - **Orbit** — drag to rotate around a focal point, scroll wheel to zoom, WASD to pan target - **Fly** — free 3D movement: WASD + Q/E (up/down), mouse look, no floor constraint - Smooth camera state sync when switching between modes - Nav mode displayed in HUD controls bar (gold label) **Performance budget:** - Auto-detects device tier at startup (mobile, medium, high/M3 Max) - **Low** (mobile): no shadows, 1× DPR, 25% particle count - **Medium** (<8 cores): 1.5× DPR, 1024 shadow map, 60% particles - **High** (M3 Max): 2× DPR, 2048 shadow map, full particles - Tier shown in debug overlay **Camera improvements:** - Shadow map resolution now scales with tier (512/1024/2048) - Orbit theta/phi computed from current camera position when entering orbit mode for seamless transition
claude added 1 commit 2026-03-23 22:40:08 +00:00
- Add three navigation modes cycled with V key: walk (WASD + mouse look),
  orbit (drag to rotate around focal point, scroll to zoom, WASD to pan),
  fly (WASD + Q/E for vertical, mouse look, unconstrained movement)
- Camera rig syncs between modes for smooth transitions
- Performance tier detection: low (mobile, no shadows, 25% particles),
  medium (<8 cores, 1.5x DPR, 60% particles), high (M3 Max, 2x DPR, 2048 shadows)
- Shadow map resolution scales with tier (2048/1024/512)
- Nav mode displayed in HUD controls bar with gold highlight

Fixes #4
Timmy merged commit 2ea5ad3780 into main 2026-03-24 01:30:27 +00:00
Timmy deleted branch claude/issue-4 2026-03-24 01:30:27 +00:00
Sign in to join this conversation.