TURNCRAFT/docs/briefs/GLOWUP_ART.md

# BRIEF — The Glow-Up (art & atmosphere pass)

*Fresh-eyes verdict: the bones are great, the surfaces are underdressed.
This pass closes the gap to the concept art. Pure art/atmosphere — no
gameplay logic — so it can run in parallel with WORKSHOP_CARTRIDGE.md.*

**For one Opus 4.8 session.** Read `docs/CONTRACTS.md`,
`docs/INTEGRATION_NOTES.md`, `src/engine/atlas.ts`, `src/engine/renderer.ts`,
`src/worldgen/buildBooth.ts`, `src/fx/` first.

**You own:** `src/engine/atlas.ts`, `src/engine/renderer.ts`,
`src/worldgen/**` (dressing additions), `src/fx/**` (decals module),
`src/ui/Menu.ts` (one settings row). **Merge point with the workshop
brief:** `src/main.ts` and `src/worldgen/buildBooth.ts` — keep your edits
small and additive there. Do not touch `src/machines/**`, `src/interact/**`,
`src/audio/**`, `src/net/**`, `server/**`.

## Findings this brief fixes (from the review, with screenshots taken)

1. **Mixer face is an empty black plain** — knob clusters are specks on a
   82×95 desert; real DJMs are dense. No screen-print labels anywhere.
2. **PCB Depths read as green wallpaper** — one tile repeated makes
   astroturf, not circuitry; caverns lack vertical interest.
3. **Textures are flat at 16px** — brushed_alu reads as concrete speckle
   up close; vinyl tiers are matte plastic; no tile variation anywhere.
4. **LEDs don't bloom** — emissive blocks read as flat colored squares;
   the concept art's glow is absent.
5. Fader alleys/vents are void-black slots with no depth cues.

## Tasks

### G1. Atlas v2 (engine/atlas.ts)
- Tiles 16→**32 px**, and give patterns **per-block-position variation**:
  hash (x,y,z) → one of up to 4 painted variants per pattern (requires
  the mesher's UV path to pick a variant — if that's invasive, an
  acceptable fallback is 4 variants painted for `pcb` only, chosen by a
  world-position hash in the shader patch; document your choice).
- Pattern quality: `brushed` = long directional strokes (not noise);
  `grooves` = concentric arcs with a subtle specular line; `pcb` = 3–4
  variants that visually tile into routed traces + via dots + silkscreen
  flecks; `plywood` = longer wavy grain, end-grain variant for `ply_edge`.
- Keep `NearestFilter` chunkiness — sharper *pattern*, same voxel soul.
- Material feel: give the two chunk materials a slightly higher
  `envMapIntensity`-free polish via roughness tuning only (no env maps).

### G2. Bloom (engine/renderer.ts + main.ts + Menu)
- Selective bloom for emissive: `EffectComposer` + `UnrealBloomPass`
  (three/examples), threshold tuned so ONLY LEDs/strobe/lamps bloom
  (~strength 0.55, radius 0.4). This is the single biggest step toward
  the concept art.
- Gate on quality: add a `bloom` boolean to Settings (default on;
  auto-off when quality = 'fast'). `createRenderer` returns a `render()`
  that internally uses the composer when enabled — main.ts keeps calling
  `render()` unchanged apart from passing the setting through.
- Budget: ≥ 100 fps must survive on the current test machine; measure
  before/after and record numbers in your handoff.

### G3. Screen-print decal system (fx/decals.ts + worldgen anchors)
- A tiny module that bakes text/markings onto canvas textures applied as
  thin plane meshes (0.05 proud, `polygonOffset` to avoid z-fight).
- Print set (all positions derived from LAYOUT/anchors):
  - Mixer face: `CH 1–4` under each fader alley, tick marks along alleys,
    `TURNCRAFT-800` model text at the top edge, crossfader `A ↔ B`.
  - Decks: `START·STOP`, `33` `45` beside buttons, pitch `+/−` scale,
    Technics-style script line on the plinth rear ("Quartz Direct Drive").
  - Patch bay: tiny socket numbers. Fuse box: `FUSE 250V`.
  - Booth walls: 3–4 procedural **party flyers** (canvas typography:
    random gig names from a word bank, big condensed type, one accent
    color each) pasted like posters near the patch bay and front lip.
- Keep total decal draw calls < 25 (merge planes per gear piece where easy).

### G4. Worldgen density pass (buildBooth.ts — additive only)
- **Mixer face**: mushroom knob caps (2×2 cap on 1×1 stem, mixed heights)
  replacing the flat single-voxel caps; double the knob rows per channel
  strip (EQ + trim + filter row); 1-voxel panel seam grooves (matte_black
  → rubber lines) sectioning the face; LED pips beside each alley.
- **PCB Depths**: IC-chip **pagoda buildings** (matte_black slabs on
  solder pin-legs you can walk under, 2–3 sizes, a few stacked), ribbon
  cable walls (alternating cable_black/cable_white columns), more copper
  trace inlays connecting features, sparse led_green "status" pips near
  ICs (they pulse post-win via existing emissive boost — free).
- **Fader alleys/vents**: a dim led_amber pip at the bottom of each alley
  and inside vent mouths so dark slots read as *deep*, not void.
- Keep `buildBooth` deterministic (same seed), build time < 800 ms, and
  do NOT move any LAYOUT/QUEST_POS anchor (machines depend on them).

### G5. Record material moment
- The vinyl tier sides get a subtle groove-sheen: a fine repeating
  light/dark ring texture on the tier side cylinders (machines/platter.ts
  is workshop-owned — instead provide the improved texture via
  `blockMaterial`'s existing tint path or hand the workshop session a
  `recordSideTexture()` in `src/fx/decals.ts` and note it in your handoff
  for them to wire — do not edit platter.ts yourself).

## Acceptance

- [ ] Before/after screenshots of: mixer face, PCB depths, deck top,
      full-booth win state (use `window.TURNCRAFT_CINE`)
- [ ] Bloom on LEDs only (plywood must NOT glow), toggleable, fps ≥ 100
      measured and recorded
- [ ] All decals legible at play distance, no z-fighting while circling
- [ ] buildBooth deterministic, anchors untouched (grep QUEST_POS usage),
      build < 800 ms, chunk meshes < 600
- [ ] `npm run typecheck` clean, zero console errors, live smoke of the
      full quest still passes (don't break the game for prettiness)
- [ ] Handoff note listing every file touched + the two merge points

## Out of scope

Mobs/critters, mobile UI, new blocks (atlas is at 31/32 ids — variants
must come from painting, not new ids), any machines/audio/net code.