[codex] optimization master pass

[QemmHD]

First optimization patch — game-feel focused, not just FPS. All current systems preserved (save/load, movement/pathfinding, economy/factions, gangs, chaos, schedules, doors, AI). No framework switch, no iOS packaging, no gore/unsafe content, no heavy assets or post-processing.

Base note: this branch is cut from the Stage 3.9 manual-combat branch (claude/lockdown-life-3d-game-4ere1s), which isn't on main yet — so this PR's diff vs main includes both the manual combat overhaul and this optimization layer. That's intentional (it brings the playable combat to main and avoids re-doing it).

What changed

Combat (stop the auto-fight / menu feel):

• Player is no longer auto-driven — a fighter only acts on input; idle does not auto-win, but the NPC AI keeps fighting.
• Dedicated combat control cluster appears during a fight: Quick Hit / Heavy Hit / Shove / Block / Dodge / Back Off / Call It Off, with cooldown grey-out + active-window highlight.
• Distance & facing matter: out-of-range swings whiff; lock-on aim; tap-to-move works mid-fight.
• Clearer feedback: hit numbers, "Shoved!" cue, block/dodge/miss floats, knockdown, guard break-up, impact shake.
• NPC auto-combat AI preserved; combat stays non-lethal/stylized.

HUD (less debug/prototype look):

• Alert feed trimmed to 3 lines, wider dedupe (6s), shorter lifetime — fewer, better alerts.
• Combat HUD is distinct from the normal selected panel (separate cluster; side panel hidden during a fight).
• Mobile-landscape pass: combat buttons collapse to one reachable row, compact bottom bar, repositioned panel/alerts.

Graphics/theme (safe value tweaks):

• More directional lighting (lower fill, stronger key) → reads less flat/grey.
• Cooler, more saturated concrete + brighter wall cap → walls pop off the floor; darker/cooler floor for contrast.

Debug telemetry (?debug sim.metrics): added shoves, combatUIOpens, combatUICloses (alongside existing hits/misses/blocks/dodges/knockdowns/guardInterrupts/playerCombatChoices).

Files changed

• src/sim/Simulation.ts — manual combat (advancePlayerCombat, range/facing in doStrike, requestCombatAction inputs, combatSnapshot) + shove feedback + metrics.
• src/core/Game.ts — combat HUD wiring, camera framing/shake, combat UI open/close telemetry.
• src/ui/HUD.ts — combat cluster (show/update/hide) + alert-feed trim.
• src/render/IsoCamera.ts — fixed-angle character camera, shake, device-aware fit (from 3.9 base).
• src/render/VisualTheme.ts — lighting/wall/floor contrast.
• src/style.css — combat cluster styling + mobile-landscape media query.
• src/ecs/components.ts — dodgeT/farT combat fields.

Checks run

• npm run typecheck ✅
• npm run build ✅
• npm run check ✅
• Headless smoke (?debug): telemetry increments (shoves, combatUIOpens/Closes), combat HUD renders, 0 runtime errors.

Known limitations

• Theme pass is a conservative value tweak, not a full art overhaul (intentionally deferred).
• General (non-combat) HUD panel structure is only lightly cleaned; a full HUD redesign is still pending.
• Character camera in very tight cell corners can still have minor wall overlap (not gameplay-breaking).
• No grapples/combos; combat is intentionally simple and non-lethal.

What's next

• Full world / graphics / layout overhaul (the next major stage).
• General HUD redesign (top bar, side panel, bottom bar) beyond combat.
• Optional: audio/ambience pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01BxvvEoWQuPRZo3zw2ih5VM

---

Generated by Claude Code

[QemmHD]

Patch 2 — visual / art overhaul pass (commit 3c85307)

Stacked on top of the combat/HUD optimization. Visual-first; no sim logic changes beyond rendering. All systems verified intact and 0 runtime errors.

Materials/textures

• Concrete reworked: mottled pour tone, form-board panel seams + tie-rod holes, vertical water streaking, anisotropy — reads as cast concrete, not flat fill.
• New createMetalTexture (brushed steel + scratches + rust freckles) applied to shared metal/steel/bars/locker materials.

World grounding / readability

• Walls gain a dark scuffed baseboard kick-plate + chamfered top cap, plus a soft fake-AO plane under every wall tile — rooms no longer look like floating gray boxes.

Cells

• Heavier 3-rail prison bars (static fronts + the swinging gate leaf) and stencilled cell-number plates above each door so each cell reads individually (green/red door lamps already present).

Lighting/atmosphere

• Cool rim/back light + faint warm bounce for character/background separation and depth; lower fill + stronger key (less flat grey). No post-processing.

HUD polish (not a rewrite)

• Premium card styling for panel / top bar / combat cluster (gradients, borders, shadows, blur), nicer bottom buttons with press states, cleaner chips/alerts.

Files: render/textures/createConcreteTexture.ts, render/textures/createMetalTexture.ts (new), render/WorldRenderer.ts, render/ThreeApp.ts, render/PropRenderer.ts, render/VisualTheme.ts, core/Game.ts, style.css.

Checks: typecheck ✅ · build ✅ · check ✅ · browser smoke: selfTest green (noEntityInWall/roomsReachable/anchorsReachable/diningClearsCounter all true), 0 runtime errors.

Known limitations / next: still a value/detail pass, not the full world/layout rebuild (that remains the next major stage); character meshes largely unchanged (already had outlines/contact shadows). Still a draft — not merging yet.

---

Generated by Claude Code