Open the books

RAW FILE: DIRECTOR-HANDOFF.md, as written during the jam

Source spoiled/DIRECTOR-HANDOFF.md in the jam repo. Last git commit of this file: 2026-11-15. About 15,133 words. Scrubbed only for private details and one line about another entrant. Mistakes left in on purpose.

SPOILED director handoff (written Sat Nov 14, 16:40 ET, for the Fable 5.2 director)

You are taking over as director of SPOILED, Don's entry in the Epic AI MegaJam 2026. The job is to win it autonomously, at a world-class bar. Don submits himself, so never click Join or Submit for him. Read this file first, then game/devlog/decisions.md (bottom 60 lines), then game/devlog/notes.md (bottom 40), then spoiled/DIRECTION.md sections 20 and 21.

State at 20:00 Sat (read this first after a compaction)

The deadline

The game in one paragraph

A cinematic first-person rail shooter set in Larkmoor Foods Plant No. 2, a meat plant in Ohio, on Halloween night 1979. You are a panicked night hire. The camera is a directed ride (walk, creep, crawl, duck, run, climb, fall, get thrown, look back), the player aims, and the meat fights back. The boss is the Wurst, a hooded Wiener Wraith made of about 1,200 cooked franks. It bursts through a wall, chases you on foot down the grinder hall line, fights you at the hopper, and changes form by the mass you leave it. Lenny, the line lead (a MetaHuman, voiced), is tied up in the grinder hall and is rescued at the kill. It's rated Teen: food gore only, no trademarks visible except the Unreal Engine name in text.

Don's directions that stand (all in decisions.md)

Hard rules (never break these)

Machines

Board (Don's view)

Live helpers (SendMessage ids; they belong to THIS session)

If the session is compacted and continued, these ids still work. If you are a fresh session, they are gone; restart the ones you need from the briefs below and the notes.

RoleIdState at 16:40
Engine lead (laptop, master, packages)a422bd24d77171484Packaging the Shipping build early (about 16:50), then the Shipping hang repro, Don's playthrough capture, the 9 trailer takes, the VSM start guard, and package 2
Layout A (tower 2)a20fe5dae70593a01Speckle diagnostics on tower 2 (dx11 clears it; AA-off doesn't; Lumen-off, flatlens, baseline and one-frame windows land about 17:05). Then the remaining game3 area frames, which feed Sunday's review
eng4, Wurst look, then warm-up (tower 2)ac0f8489e1f67040dSince 18:45 also on branch eng4/warmup: the first-launch PSO warm-up screen and the burst frame pre-warm, moved off the lead. Earlier work: Branch eng4/wurstpolish (core plug, charred under layer), then eng4/wurstlife b462384 (grease pump, roar seam, five SetRoar lines in SPWurst marked eng4), then item 3: the legs out of the pool for lunges (-SPWurstLegs), stopping at 03:00 if not convincing
eng7, Wurst spider form (tower 2)a2e9d04646487a912Branch eng7/spider 6c507a0d: spider form, death flush, natural link twists, stinger feet, footstep events, a blistered death. Now: the cosmetic death reclaim (12% visible mass), dropping its stale AssetFor hook and sfx_map file, and a rebase onto master after the package
eng8, audio engine (tower 2)a5f543dca51fdec5cBranch eng8/score 7cba5c5d: adaptive score layers (MIX-FINAL section 9), with -SPScoreQuartz as an option. Standing by
eng9, ride credibility (tower 2)a580517e06d5c58e0New 16:3x. Building the -SPRideAudit tool (wall passes, near clip, eye height, jank), top-down maps per area, and data fixes on branch eng9/ride. First report about 18:30; final before Sun 08:30
eng10, HUD (tower 2)a0ee935d16dd90ee3Built: branch eng10/hud 4daa1b7c or later. Minimal default, Full option, the Teach() call, 13 short NEEDED prompts routed through ASPDirector::Hint; HUD.md holds the study and the coach-text audit. Tonight it shoots seven one-frame captures on tower 2 for the director to judge
eng11, materials (tower 2)aa2f9044883b67469New 17:0x. Fixes weathered material twins that read as the wrong substance (MIW_SP_Galv reads as concrete in the warm duct, the painted block twins as wood grain on the stairs, blotchy stainless), on branch look/matfix. MATFIX.md about 19:30; final before Sun 08:00. It must not take tower 2's GPU until main clears the capture method
layout B, the arrival exterior (tower 2)afe161093f9d60031New 18:40. Builds sublevel L_Arrival (the lot, the plant's face, the personnel door with Lenny's note, the vestibule, the radio hook; tags ArrivalDoor, ArrivalRadio, ArrivalNote, ArrivalLennyLight, ArrivalDawn) and tags the screens (ScreenLenny_Office, ScreenLenny_Lift, ScreenCCTV_Dock). Branch layoutb/arrival. Blocked in by 21:30, lit by Sun 02:00, final by 08:00
eng12, the opening and radio code (tower 2)a877908827a3b2aa5New 18:40. SPArrival (the new opening, data-driven), SPRadio (Lenny's radio voice), the ending at the door (-SPEndDoor), an in-world movie screen player; -SPOldColdOpen and -SPOldRescue keep the old scenes. Branch eng12/arrival. Headless end to end by 21:30
eng13, Lenny's monitor clips (tower 2, one laptop slot)a9607b62637a2723eNew 18:45. A booth render of Lenny's head and shoulders with audio-driven lip sync, a CCTV treatment tuned on a stand-in, checks by numbers only, clips into Content/Movies/Screens, one 10 s test clip for Don by Sun 07:30. Branch eng13/screens
Script doctorae91c8d7e44c7258eWriting scratchpad\story\ARRIVAL-SCRIPT.md: the note, the radio and monitor lines, the last line, the new lines to generate. STORY-PASS.md is in spoiled/
Audio directorab71b55f9b7a95c54Did job 12a4 (heavy wet spider footfalls). RESUME after the captures for the 60 s showcase and the MIX-FINAL section 10 loudness check on the package. No new sound has been heard by anyone; Don's playthrough is the first listen
Trailer producerae6eb949537677041Parked. RESUME when the 9 takes land in D:\megajam\spoiled\trailer\cap: verify, then contact sheets, then the v1 1080p cut, then 5 itch stills. 4K goes to tower 1 later. No letterbox; text-only end card
Kit worker (done)ac50f0ac64e670c91Round 2 machine meshes are in master (9 pieces, Corner90 fixed)
Lenny artista253abea2ab4c1ab3The moustache is still NOT in. The groom must be copied into Lenny's folder before the assign; the saved version is G:\lenny\bak\BP_Lenny_moustache_1451.uasset on tower 2. Low priority; ask Don if he still wants it
Look directorae8d807721375c115Not running. The director judges the look now

Tonight's order (laptop GPU)

  1. Shipping package 1 started 16:37 from master 1eb45a3f into D:\megajam\builds\spoiled_r4_pkg1; the cook ends about 17:20. Shipping writes no log, so the lead also builds a Development twin, D:\megajam\builds\spoiled_r4_pkg1dev, with the same commit, for Don's capture and the trailer takes (capture_r4.ps1 aligns sound from the log). The Shipping zip is the judge build. Not in package 1: the 12a3/12a4 overlays and the spider. Master includes:
    • the wraith3 Wurst look (eng4 cc6142e);
    • eng8 audio, with the safe sfx patch, the 12a2 import and its overlay;
    • copy 4, the round 2 kit meshes and the realism (MIW) assign;
    • exposure pass 2 EVs and the struggle clamp;
    • the boss gates (feature and matinee: phase 3 at 0.35, kill at 0.12, knit 0.5), with Night clearing in 3:54 and 1 death;
    • no letterbox (36afa12f);
    • r.Shadow.Virtual.OnePassProjection=0, which cleared the editor's first-frame GPU hangs in 9 of 9 starts. The size_pass must stay under 940 MB.
  2. Shipping hang repro: a cold start plus Loading Dock, Syrup Vats, Vat Row and Service Corridor, 2 runs each, judged by process exit 0 with no crash folder. A hang in Shipping blocks everything until fixed.
  3. Don's full playthrough capture (cold start, the whole run, Lenny visible; Don only, no model ever sees it). Promised to Don for about 18:30. Send it with SendUserFile, plus a short message:
    • ask him to listen to the wall burst, the fight and the room tones, since no one has heard the new sounds;
    • note that Lenny's moustache isn't in;
    • say what changed since 14:00. Run the message through tells.py.
  4. The 9 trailer takes: powershell -ExecutionPolicy Bypass -File spoiled\ship\trailer\capture_requests.ps1 -Exe "<pkg>\Spoiled.exe" -NoMusic (about 12 min, all -SPHideLenny). Then resume the trailer producer.
  5. The VSM start guard (local lights skip VSM shadows for 1.5 s under the fade) if OnePassProjection=0 isn't enough. Then package 2 as Sunday's baseline.

Sunday 09:00 merge (judge on LAPTOP frames first)

Order: eng4/wurstpolish, eng4/wurstlife, eng7/spider (rebased), eng8/score, eng9/ride, eng10/hud, look/matfix, then layout A's copy 5 (the cold store shelf dressed, the stairwell, the warm duct). Before each merge, the lead renders laptop frames with -SPHideLenny and a stated Lenny count, and you judge them.

Size: package 1 was 963.3 MB, over the 940 gate. That's accepted only because it's a capture and test build. Before package 3, run a cook size report (top 40, plus anything cooked but unreferenced) and cut the waste. Then cap R4/Kit textures at 1K in the jam profile (check a laptop frame for softness), and ship the score layers compressed. Target the final zip at or under 900 MB. Itch's browser upload limit is 1 GB; above that, butler is Don's to run.

After the merge: package 3 by about 11:30, then a full bot run and a playthrough check, the freeze at 13:00, then only fixes. Final package by 16:00, then a Shipping smoke test and the hang repro. To Don by 17:00 with the itch text, the trailer, the screenshots and the credits (spoiled/ship/itch.md, video.md).

Sunday queue for the lead, approved (after the 09:00 merges)

  1. Size plan (above), target 900 MB or less.
  2. Pre-warm the wall burst and the lift drop (200 to 280 ms spikes).
  3. Weak-card safety net: under PICTURE AUTO on a display under 2000 lines, if dynamic resolution sits at its 50% floor and frame time averages over 22 ms for 8 s, step to LOW once, silently. Add -SPPicture=auto|1080|low for bot runs if no such flag exists, then rerun the tower 2 FPS pass (spoiled/qa/fps_areas.ps1). The 60 to 73 fps laptop numbers were at engine defaults, not the 1080p preset, because bot runs skip the menu.
  4. A "HOLD TO SKIP" prompt on the cold open (the skip exists, with no prompt).
  5. Readability for a judge on default settings: Sir Loin is a three-weapon puzzle with coach-only instructions. He gets diegetic cues (his lines, a frost-blue glint, the crack VFX), the bolt chips the crust at 0.25x, and the bot switches to the sprayer. eng10's Teach(Key, Text, Action) gives one-time prompts in Minimal. eng10 is listing every coach-gated string as NEEDED, HELPFUL or FLAVOR; every NEEDED one becomes a one-time teach or a diegetic cue.
  6. The VSM start guard, compiled and tested with 3 editor cold starts.
  7. Package 2, then package 3.

Ride audit (eng9), the biggest quality item for Sunday

The audit (-SPRideAudit) found 434 camera credibility flags, 122 high: the fryer hall run floats off its catwalks, the grinder hall cuts a corner through a wall and zigzags (yaw whips up to 928 deg/s), smokehouse falls go through a floor 1 m short of the hatch, the cutting floor cage weaves through working rails, the stairs body floats beside the flight, and creep walks at standing eye height. Fixes are data, in Scripts/r4/apply_ride_cred.py (the last chain step), in this order: dock, fryer hall, grinder hall, smokehouse, cutting floor, lift, cold store, the rest. Layout asks go in spoiled/ride/LAYOUT-ASKS.md for layout A's copy 5. Before maps: spoiled/ride/maps_before/. Judge each area by its after map beside the before, and by the rerun's flag counts. Never accept a flag hidden rather than fixed; cut or restage the beat instead. Pace: the real run is 14:13 of play plus the 66 s cold open, with the wall burst at about 11:30 wall time. eng9 trims about 90 s (Sir Loin's timeout 75 to 45 s, c4_halt 12 to 5 s, walking in the cold store, cutting floor, vats and the grinder hall approach) so the burst lands near 10:00 and the clear near 13:45. Protected: every scare, env-kill setup, trailer shot and Lenny line, and the last 12 s of silence before the wall. A headless (-nullrhi) run stalls about 9 min in the cold open's audio fallback; ignore that.

Open risks, ranked

-1. Runtime-loaded content missing from packages (found 18:25). Package 1 has no /Game/Wraith (the Wurst draws as a pale blob stack), no /Game/React (no hit decals, no breathing meat) and no tied-Lenny clips, because those folders are loaded by path and were not in DirectoriesToAlwaysCook. The lead fixes it in package 2 and adds a gate that fails a package on any "SkipPackage: /Game/" line that is not a sound-name probe. Judge every look in a PACKAGED frame from now on; editor frames don't count. The Wurst's wraith3 look has still never been seen in a package.

  1. First-launch stall (found 17:55 on tower 2's W6600). The first run after an unpack sat waiting on pipeline state creation (the longest single wait 25.6 s; 6 s of game clock in 35 real seconds). Later launches start in 1 to 2 s. Every judge has a first launch. It's the lead's P1 for Sunday: a "warming up the line" hold on the front end until the PSO precache drains (or a bundled PSO cache), plus a dynamic resolution percentage log. Otherwise that card held 61 to 63 fps in all 13 areas through dynamic resolution, with clean frames and no crash.
  2. The first-frame GPU hang (DXGI_ERROR_DEVICE_HUNG in VSM one-pass projection). The workaround is in master; it's unproven in Shipping. Judges' GPUs are weaker.
  3. AMD speckle: closed as a capture fault (17:35). On tower 2's W6600 under DX12, the frame grabber's second and later frames are corrupt, while its first frame, a one-frame window and the engine's own screenshot are all clean, and dx11 is clean. The game's rendering is fine. Tower 2 stills are usable only through the engine's screenshot path, never the frame grabber (corrected at 18:40). Never record clips with -SPCapture on tower 2. What's still open is speed on a midrange card: layout A's FPS pass on tower 2 (package 1 as a worst case, then package 2 at -SPPicture=1080 and low).
  4. The run's length: judges play 10 to 15 minutes, and the climax must land inside 13. Chapter select has GRINDER HALL from first launch.
  5. No one has heard the new audio.
  6. The moustache (cosmetic).

Key files

Crons in this session (session-only)

How this director worked (keep what helped)