PROCITY/docs/LANES/ROUND41_INSTRUCTIONS.md

# PROCITY — Round 41 instructions (from Fable, integrator)

Date: 2026-08-07 · **R40 closed green** (12/12 gates, `c3384b9` pushed, goldens `0x5f76e76`).
**Theme: THE LIBRARY LANDS.** John: *"we have heaps new furniture clothes ppl animations
heapppppppps animations in our library — take a look and mega update our game."* Fable surveyed
the fleet. The survey is the ground truth for this round; its numbers are quoted below and must be
re-measured, not re-quoted, before anyone acts on them.

## The finding that defines the round

**PROCITY ships 8 animation clips.** `idle · walk · sit · look · dance_drink · dance_medium ·
dance_party · dance_sway` — skeleton-only GLBs, 66 mixamorig nodes, loaded by
`rigs.js:69 loadPedFleet()`.

**The fleet holds 6,866 licence-clean clips** in ultra's `~/Documents/MOTIONLIB/green/`
(2,394 Mixamo FBX · 2,548 CMU BVH · 1,620 100STYLE BVH · 304 ACCAD BVH), and
**`~/Documents/MIRPAMO/` is a working local Mixamo** (`./bin/mirpamo batch <rig>.glb <clipdir> -o
out/`, headless Blender, no cloud). **The skeletons match 1:1** — 66 mixamorig nodes both sides;
retarget output is byte-shaped like the existing `idle.glb`. The Mixamo bank alone holds **237
idle variants · 270 walks · 140 sits · 163 greet/point/wave · 113 dances · 112 push/pull/pick/reach
· 63 carry**. Every non-walking citizen in the game today plays the same idle.

Plus: **45 record-shop fittings that pass the house law untouched** (`~/Documents/3dstore/`,
~300 tris median, metre-correct), **60 DJ-gear GLBs, 45 of them control-rigged** (working
`Fader_CROSS` / `Platter_SPIN` / `Btn_STARTSTOP` node contracts), **48 pub/venue props** at 200k
tris needing a 40× decimation, and **441 hand-prompted 1990–99 Australian garment PNGs** from
wardrobegod (174 tops / 119 bottoms / 69 shoes / 66 hats / 12 bags).

## INTEGRATOR RULINGS — binding, no lane may reinterpret them

1. **🔴 THE BANDAI HAZARD IS CLOSED BEFORE ANY RETARGET RUNS.** m3ultra holds 3,077 **CC BY-NC**
   (non-commercial, never shippable) Bandai-Namco BVH at
   `~/Documents/MIRPAMO/library/downloads/bandai_namco_1/` — in a neutrally-named path, outside
   ultra's `red/` zone system, with nothing in the filename marking it. It is **one
   `mirpamo batch` away from a shipped build.** Lane E-motion's FIRST action, before touching any
   clip: zone it (rename with the `_NC-research` suffix per the house rule, or delete in favour of
   ultra's correctly-zoned `red/bandai/`) and reconcile `MIRPAMO/library/manifest.json`'s wrong
   `CC-BY-NC-ND` label against ultra's corrected `SOURCES.md`. Report it done with the paths.
2. **R41 clips come from the MIXAMO bank only.** Mixamo is usable inside games with **no
   attribution requirement** — the only rule is never redistributing clip packs, and retargeted
   per-character clips inside the game are explicitly fine. CMU/100STYLE/ACCAD are all attribution-
   bearing; they are a later round's work, after the credits surface exists (41.5). One licence
   regime this round.
3. **A DENY-LIST enters the repo law.** These never enter `web/` under any circumstance:
   `character_kit_modular/exports/bodies/**` (44 bodies, 30 named `-nsfw`, 465k tris each, broken
   0×0×0 bboxes) · any `anatomy/` dir · `elsa_coronation_hair_wig_kh3.glb` (Disney/Square Enix IP
   rip) · `daphne_sexy.glb` (unverified rip) · `~/Documents/mocaponline/**` (vendor demo packs,
   licence unread, includes Epic's EULA-bound `SK_Mannequin.fbx`). No wildcard copies from any
   library — every asset enters by name.
4. **THE STREET BUDGET IS SPENT: 291/300 at night, nine draws.** No lane adds a street-side prop
   this round. Every asset in R41 lands **interior** (margin 162) or is **zero-draw** (clips are
   skeleton-only, 0 tris). Any street-side proposal gets measured and filed to R42, not shipped.
5. **Never run `gltf-transform optimize` on the DJ gear.** It collapsed a 696-node mixer to 25
   nodes and deleted `Fader_CROSS`. Decimate only, and verify the node contract survives.
6. **Clip delivery is GROUPED, not 40 files.** A GLB holds many animations; boot fetch count is a
   budget. Deliver **≤6 grouped clip GLBs by category** with a documented index, not one file per
   clip.

## The ledger

### 41.1 — THE MOTION LIBRARY *(Lane E, motion half — the critical path, starts first)*
Ruling 1 first, then: pick and retarget **~40–48 clips** from `green/mixamo_full` through MIRPAMO
onto PROCITY's ped rig. Pick for what this game actually is — a shopping town with shops, benches,
a pub, and citizens who currently only walk and stand:
- **Idles (8–10 distinct)** — `Breathing_Idle`, `Big_Yawn_While_Standing`, `Sit_With_Fidgeting_Feet`,
  cocky/hip-lean variants: the clone-army killer.
- **Browse/shop (6–8)** — `Examine_Forwards`/`_Backwards`, `Holding_An_Object_Idle`/
  `_While_Walking`/`_While_Turning_Left`/`_Right`, `Closing_Cabinet_Door`, `Carrying_A_Box`.
- **Sit/lean (6–8)** — `Little_Girl_Sitting_On_A_Bench_Swinging_Her_Legs`,
  `Leaning_Against_A_Wall_With_Various_Postures`, `Legs_Crossed_Leaning_On_Object`.
- **Social (6–8)** — `General_Conversation`, `Having_A_Chat_At_The_Watercooler`,
  `Greeting_While_Standing`, `2_People_Shaking_Hands_Part_1/2` (a matched pair — keep them paired),
  `Nodding_Head_Yes`, `Shaking_Head_No_Dismissively`.
- **Locomotion (4–6)** — walk variants + the `45/90/135/180_Degree_{Left,Right}_Turn` set.
- **Venue (4–6)** — better dances, clapping standing/seated, cheering.
Deliver: ≤6 grouped GLBs under `web/models/clips/`, a **new** `web/assets/motion_manifest.json`
(new file — no race with props' manifest.json) indexing clip→group→category→duration→loopable,
provenance in AUDIT.md, and MIRPAMO's `make smoke` green. Watch the documented gotcha: Blender 5
FBX export flattens slotted actions — feed GLB/BVH or use `strip_skin.py`.

### 41.2 — THE FITTINGS *(Lane E, props half — parallel with 41.1, disjoint files)*
1. **`~/Documents/3dstore/` — 45 of 46 GLB pass the house law as-is** (~300 tris median, metre
   scale, no Draco, no textures). Re-verify with `glb_stat.py`, bring them in by name, manifest
   them with footprints for C. Reject `3dmrp.glb` (499,948 tris). **This is the round's cheapest
   win — do it first.**
2. **DJ gear (ultra `3D=models/dj-gear/`, 60 GLB)** — 18 already ≤5k; normalize the rest
   (decimate only, ruling 5), **verify the `Fader_*`/`Platter_SPIN`/`Btn_STARTSTOP` node contract
   survives on every rigged model** and state the check. Manifest them with their control-node
   names so C/D can drive them later.
3. **Pub/venue props (`~/Documents/not-tonight/art_incoming/`, 48 GLB @ ~200k tris)** — 40×
   decimation through `normalize.py`. Content is exactly pub/cafe/milkbar (pokie, jukebox, keg,
   bain-marie, pie warmer, banquettes, ashtrays, sandwich board). Skip the 6 `staff*.glb` — they
   are 200k-tri statues with no skin, no anims, no materials.
Publish to the depot over the tailnet path, sha1-verify, run the R40 transmission gate over every
new asset (it now scans all four surfaces — prove it stays green).

### 41.3 — THE CITIZENS COME ALIVE *(Lane D — after 41.1 lands)*
Wire the clip library into the fleet. `rigs.js loadPedFleet()` and the sim's state machine are
yours.
- **Per-citizen deterministic idle** from the new pool — seeded by identity, so the same citizen
  always stands the same way and the street stops looking like one person copy-pasted.
- **A real BROWSE state** for the interior browsers (they currently stand): examine/hold/reach at
  C's browse points, seeded per browse point.
- **Sit and lean** on the street furniture that already exists (benches, shopfronts) — this is
  where sit/lean clips earn their keep; keep it zero-draw (a seated ped is a ped that was already
  drawn).
- Keep memory bounded and **state the numbers**: clips resident, fetch count at boot, heap delta.
  Determinism law holds — same seed, same crowd, same postures, byte-equal across two runs.
- Everything gated so `?noassets=1` still runs (the 8-clip path must survive as the fallback).

### 41.4 — THE SHOPS GET THEIR STOCK *(Lane C — after 41.2 lands)*
Place the new fittings. Interior margin is 162 draws — spend it deliberately and report the worst
room after every change.
- **Record/opshop/book/video/pawn/stall**: the `3dstore` tubs, crates, wooden racks, stackable
  `mos-japhop` units, library trolley, `vinylsleeve_v5`, window booth.
- **Pub/cafe/milkbar**: the decimated venue props — this is the set that finally furnishes the pub.
- **Record shop + gig venue**: the DJ gear (turntables, mixers, the 808/SP-1200/MPC) as hero props.
- **The wardrobe PNGs** (441 garment layers, `90sDJsim/web/world/media/doll/`): route R5 — use them
  as op-shop rack textures and shelf stock art at **zero geometry cost**. Period-correct Australian
  1990s naming is the whole point; keep the names visible where the game shows item text.
- Every recipe change re-runs your sweep + soak: 0 throws, 0 path-fails, 0 leaks, draws ≤350.

### 41.5 — THE CREDITS SURFACE *(Lane B — small, and it unlocks future rounds)*
PROCITY has no attribution surface. R41 ships Mixamo only (no attribution debt, ruling 2) — but
CMU/100STYLE/ACCAD are 4,472 more clips waiting behind exactly this. Build it now: a credits panel
(the flag/selector UI idiom you already own), fed by a data file lanes append to, listing asset
sources and their licences. Zero draws in-game, classic-gated by construction. Then R42 can spend
the CC-BY libraries the day it wants them.
**Also yours, filed from R40:** A's D3 — `SHOP_REGISTRY` is missing pub/band_room/rsl, so 81 venue
lots corpus-wide wear op-shop signage (`buildings.js:465`). Cosmetic, measured, and it will show in
every pub shot this round takes.

### 41.6 — INTEGRATION AND PROOF *(Lane F — last)*
Wire what needs wiring, gate what needs gating, and **prove the round with pictures** — this is the
first round in a long time whose whole point is visible. New/extended gates: clip-manifest
integrity (every referenced clip resolves), citizen-posture determinism (two runs byte-equal),
interior draw budget with the new fittings, `?noassets=1` still clean, deny-list compliance (no
banned path ever referenced from `web/`). Re-shoot the tour: a busy street with citizens in
*different* postures, a browsing interior, the furnished pub, the record shop with real gear.
`qa.sh --strict` green, budgets restated, goldens unmoved. **No tag** — John's playtest session
rules on the epoch.

## Laws

Everything standing, plus rulings 1–6 above. Highlights: measure the thing, not the note about the
thing · pathspec-atomic commits, **no git commands from lanes** — the integrator commits at close ·
fresh browser contexts · human-sized line on humanoid shots · every gate ships its control
demonstrated · budgets are numbers.

## Order

1. **Wave 1 (parallel):** E-motion (41.1, ruling 1 first) · E-props (41.2) · B (41.5).
2. **Wave 2 (parallel, after their inputs land):** D (41.3, needs 41.1) · C (41.4, needs 41.2).
3. **Wave 3:** F (41.6).

## For John

Nothing blocks this round. Still parked for the playtest session: the op-shop bin's contents · fog
default-on vs mode · v9's third layer · **the audio listen pass** (nobody in this loop has ears).
The F8 notepad and `?bugtour=1` are live and waiting.