Open the books

RAW FILES: Kid Katapult take plans

5 files from the jam repo, in order, each with its own source line, last commit and word count. About 14,563 words in all. Scrubbed only for private details. Mistakes left in on purpose.

BEATS.md

Source game/takes/BEATS.md. Last git commit 2026-11-13. About 1,481 words.

Between-scene beats (CONTENT-PLAN section 4): the laptop ticket

Three takes on Stage 7, one after each scene's edit bay: beat_1.take.json (after the chase), beat_2 (after the brawl), beat_3 (after the cannon, before the premiere). Written by make_beat_takes.py (rerun it if a line is re-recorded: every time comes from the wav lengths). The shoot, not the film: no 1978 grade, neutral work light, no cues, no score, no music.

Walt stands by his chair, Rex (BP_Rex_final in the 1978 costume) by the craft table. The set's squawk box (the studio phone, on apple box apple_3 beside the chair) buzzes and squawks; Walt answers the front office about the budget and switches it off; Rex fusses about his close-up and his double; Walt answers him. Then Walt reacts to the dailies, good or rough.

beatmain runthenlines (main)goodrough
beat_10 to 18.00 sjump to good 23.00 to 29.45 or rough 31.00 to 35.95walt_b01, rex_b01, walt_b02walt_b03walt_b04
beat_20 to 17.83 sgood 23.00 to 28.31 or rough 30.00 to 34.71walt_b05, rex_b02, walt_b06walt_b07walt_b08
beat_30 to 18.09 sgood 24.00 to 31.10 or rough 33.00 to 39.95walt_b09, rex_b03, walt_b10walt_b11walt_b12

A play is 22.5 to 25 s, not the plan's 15: the lines run at Walt's real pace. The skip after 2 s covers repeat plays. To get near 15 s, drop Rex's exchange (his line and Walt's answer, about 9 s) from BEATS in the script and rerun.

How the game should play them

  1. After a scene's edit bay closes (the player has cut the reel), play beat_<n> for that scene (sequence tagged DIR_beat_<n>), then go on to the next scene's call (beat 3: on to the premiere). Once per scene, never on a retake.
  2. Skippable with any input (keyboard, pad, touch) once 2.0 s have played (beat.skippable_after_s). Input before 2 s is ignored, so the button that closed the edit bay can't skip it. A skip stops the beat's audio and moves on with the usual fade. A skip during a branch does the same.
  3. The pick. Read the stars of the reel the player just cut for that scene (FKKReel::Stars(Tuning) in KKPremiere.h, the number the critic will use). beat.pick.good_if_stars_at_least is 3: 3 stars or more plays good, 1 or 2 plays rough. If no reel exists (a debug jump), use the best attempt's FKKAttempt::Stars.
  4. The jump. Play the sequence from 0 to beat.jump_at, then seek to the chosen branch's t0 and play to its t1, then the beat ends. This is the resets' mechanism (sequence-only sections after the main run). Each branch opens on its own shot, Walt's single (s2_good / s2_rough), so the jump is a camera cut and the small pose change at it doesn't show. Never play through past jump_at without the seek: the stretch from jump_at to the good branch is empty (the two-shot holds over idle loops), and the rough branch would follow the good one.
  5. No cue gate: director_cues.py writes an empty table for these (warning W03 "the take has no cues" is expected). Nothing goes into the edit bay, the premiere or the blooper reel.
  6. Visibility: show DIR_beat_<n> plus the Stage 7 set (KK_set_stage7); hide every scene's DIR_ actors and KK_settake_ dressing. The beats carry their own work lights (work_sun, work_sky), like the walk-throughs: work lights off while a beat is up, or delete lights in the script to keep Stage 7's KK_worklight rig on. Not both.
  7. Grade: no grade key on purpose. Skip any game-side grade or letterbox for beat_ takes.

Builder fields

Missing pieces (not this ticket)

Build and check (laptop)

  1. run_director_build.ps1 -Take beat_1 (and beat_2, beat_3), then rerun set_build.py all as after any director build.
  2. Read the log: PATH rex and PATH walt should stay within a few cm of their start; if the idle loops drift visibly, drop travel_actor and followers from the script (the clips then play in place, without blends).
  3. frame_checks (s1 at 1.0 s and one second before the jump): Rex, Walt and the box in frame.

Lip sync for tower 2

All 15 lines have lipsync: true; until the anims exist the build warns per line and the faces play eye life only. Make them the way the cast's were (game/casting/ls_solve.py, ls_run.py, ls_check.py, LIPSYNC_IMPORT.txt):

Voice

Made on tower 1 exactly as the walk-throughs (~/mj-tmp/voice-beats, and ~/mj-tmp/voice-beats2 for seven lines trimmed after the first pass, new seeds): Maya1 with gen_final.py's settings (gravel for Walt, matinee for Rex, temperature 0.4, top_p 0.9, seeds 4321 + 1000 x idx + take, idx 200 to 214 and 300 to 306), check_takes.py (Whisper) with WER at most 0.05, Audiobox aesthetics, ECAPA similarity against walt_l01_t1 / rex_l02_t2 with the cast's threshold (median minus 0.10: Walt 0.354, Rex 0.378), finalize.py (0.15 s pads, -18 LUFS). Rows are in game/audio/voice/manifest.json with a beat field.

All 15 kept lines passed WER and similarity, none flagged. walt_b08 needed the retry round (takes 0 to 3 under the similarity threshold, takes 4 and 5 passed, 5 kept). rex_b01 is the first-pass text: the trimmed one ("...and the kid smaller") failed WER in all 11 takes because Whisper hears "the kids smaller", which sounds the same.

Story fixes 2026-11-13

All 15 beat lines were read against the new cannon climax (Johnny's evening show turned on the robbers' truck, the back-first landing on the boxes, the effects man firing a spring cannon) and the chase changes (a robber shakes Kid off, the second leap is a pickup on the parked truck). None contradicts them, so no beat line was re-recorded and the beat takes are unchanged.

In the game (wired Fri 2026-11-13, laptop)

Phase Beat, the same StartSide code as the walk-throughs (see WALKTHROUGH.md, "In the game"). NextScene (the Printed screen's way on, tap or button, or the bot) plays beat_<scene number> first, once per scene (bBeatDone), then AdvanceScene does what NextScene always did (next scene's call, or the premiere after beat 3). PrintCut builds the reel it just cut (FKKPremiere::BuildReel) and keeps its stars; the beat picks good at 3 stars or more, else rough (no reel: the best attempt's stars). TickSide plays from 0 to jump_at, seeks to the branch's t0 once, and ends at its t1; a skip during either part ends the beat and moves on. Visibility: DIR_beat_<n> stays, every scene's DIR_ actors and KK_settake_ dressing are hidden, Stage 7 stays (it has no scene tag). The beat takes' tables come from director_cues.py --write-anyway (E07, the gap between the main run and the branches, is the sequence-only section by design); KKBEAT reel stars|beat ... branch=/jump log lines show the pick. Test: KidKatapult.Sides.WalkAndBeatTablesCarryTheirMetadata (Tests/KKSideTests.cpp).


BRAWL-CONTACT-PLAN.md

Source game/takes/BRAWL-CONTACT-PLAN.md. Last git commit 2026-11-13. About 1,237 words.

Brawl contact plan (planning step before the engine ticket)

Fri Nov 13, 06:15. Numbers from brawl2_plan.py on the last layout dump and the clip tracks in D:\megajam\brawl2\work\tracks.

0. What the numbers add

Placement is half the miss. Three clips also aren't the moves they're named for.

The joint log's noise is 19-25 cm a frame (stale ticks), so no 5 cm check means anything in the game until it's fixed. Every branch is Kid's, so the heavy can be re-solved freely; Kid stays in Kimodo (SOMA) poses where branches attach.

1. Beat sheet (world m from the layout, x = Kid's start facing)

sbeatKidheavycontact
0-4marks(0,0) facing 0°(0.75,0.05) facing 180°
4-6.4B03ducks, uppercuts (NEW)hook at head height, spins roundhook 15 cm over the ducked head at 5.14; fist on jaw 6.21, his reaction starts that frame
6.4-9.43B06guard, about (-0.4,-0.2)haymaker_take trimmed to under 1 m, steps back in (bridge), haymakerfist on Kid's jaw 9.43
9.43-11.9sellsnap and full spin, about 1.2 m back (NEW), travel 1.0follows through
11.9-13.2B08shovedwalks in, shovespalms on chest at 13.10
13.95-17.1B10rolls clearchair onto the tableas built
17.1-23.2B13 (NEW)dusts off near (-1.8,-0.3), runs at 21.3turns his back, struts 4.5 m to the bar crowd, turns at 22.2, steps at Kidreplaces the reversed walk
23.4-24.5B14/15kick, lands near (2.9,1.55)pull-back to near (4.9,2.3)as built
24.5-26.4B17ducks, uppercuts (second seed of B03's clip)charges in (NEW), hooks, spinsfist on jaw; s1_upper moves 25.3 to 26.37 so he's square again
26.4-29.4re-squarepivots to keep him in frontshrug_off_s11, circles a quarter turn left (NEW)axis turns 60-90° off the rope line
29.4-31.2B19bandstand_fall_s1 as authoredhaymakerfist on jaw on the fall's first reaction frame; shoulders break the riser's balsa front edge, 1.2 m behind his heels
31.2-45outgets up, bows 35.0dusts offno joint inside unbroken riser

Bandstand: move the fall. Turning the rope line can't fix it. The kick lands where the heavy faces the swing, and a haymaker drives Kid straight back, so any fall after the kick goes down the swing line. Fighters re-square by circling, which costs one heavy stalk; Kid's pivot rides on the new B17 clip, and the fall clip stays. The riser is hollow, breakaway front boards over a pad (1978 practice), first guess near (3.8,-0.8). The solve places it 30 cm or more clear of Kid and the rope over 21.3-24.6 s, not covering Kid in the camera.

2. Method: contact by placement, continuity by generation, residue by IK

  1. Staging solve (numpy). brawl2_plan.py grows into stage.json. It places whole clips rigidly (yaw plus xy) so each fist meets its target bone at impact, and starts the reaction on that frame (2 frames of shift at most). Kid anchors wherever a branch touches him.
  2. Joins are generated by Kimodo. New moves and every join gap over 2 cm become clips pinned 3 frames at each end (kimodo_constrained.py; batch 20 hit 0.0-0.3 cm, 0% velocity mismatch). No root ramps, no crossfades over gaps.
  3. Both men are world-baked in one Blender scene on the real Rex and Heavy skeletons, exported from UE, so no retarget follows the solve (that hop cost 16-17 cm of wrist drift). plib two_bone_ik closes the residue at impact (target 2 cm, 4 frames in, 6 out), feet lock on plants, and IK lifts the hook's path for both ducks. Each actor gets one continuous bake, cut per beat, with hard switches. The riser is the P2 fracture baked against Kid's bones.
  4. All six branches are regenerated against the new Kid path by kimodo_branches20.py with stage.json placements. IK windows avoid the constraint frames. The keyed rope and pull-back clips exist only on MH, so a pose converter to SOMA supplies their frames. rope_miss's cue moves before takeoff.

Rejected: Kimodo generating reactions to a strike, since it has never held a contact (rope 0/70, cart 1/40). Keying every beat from scratch is too slow, so it stays the per-clip fallback.

3. Tickets

#whereticketcheckest.
1laptop CPU, nowStaging solver, riser spot, batch 21 constraints, gag rules (duck 25 cm or more, fist 6 m/s or more, spin 270° or more)fists within 10 cm on placement alone; riser clear 30 cm1.5 h
2tower 2Round trip UE-FBX-Blender-FBX against the tracks; MH to SOMA converter0.5 cm; 1 cm1 h
3tower 1Batch 21: new moves plus bridges, 40 seedsgag; seams 2 cm or less, velocity within 20%1.5 h
4laptop UERetarget picks, export real-body FBXtracks match45 min
5tower 2Two-actor bake, riser, mannequin sheetsfist under 5 cm at impact; joins under 5 cm a frame; plant slide 2 cm or less; reaction within 1 frame2 h
6tower 1, after 3Batch 22: six branchesbatch 20 numbers, no joint inside props1 h
7laptop UELog after the anim update; "world" sections in director_build; brawl3_take.py; cue move; build, package, bots, seam_checklog p99 under 3 cm when still; all checks in the package; under 940 MB; cue tests pass2.5 h
8fresh OpusSTANDARDS review from sheets and numbers, no MetaHuman framessign-off30 min

Critical path 1-3-4-5-7, about 8 h 15 min (laptop estimates have run 2x low, batches 2-3x high). Opus on 1, 5, 7, 8; Sonnet on the rest.

4. Risks and the fallback

B05, B18, B08 and B11 wait.


SEAMS.md

Source game/takes/SEAMS.md. Last git commit 2026-11-13. About 8,913 words.

Seam audit: every branch entry and exit (flawless branches)

Written Thu Nov 12 2026, night, for Don's top-priority ticket (BACKLOG.md "flawless branches", rule in lab/STANDARDS.md, Game director). Offline: no editor, no compile, take JSONs untouched. Numbers come from game/motion/seam_audit.py (re-run it after any take change): the three take JSONs, the director build logs in D:\megajam\builds\logs\director-build-*.log (ALIGNED, FLUB and PATH lines), and the source Kimodo npz from tower 1. The full5 bot runs have no PATH or BOUNDARY lines (those are written by the build, not the game), and full6 has no runs yet, so the build logs are the evidence.

Verdict

15 seams: 9 flub branches and 6 wreck resets (the 4 applause sections are not branches). Against the new rule:

How it is measured

Seams, worst first

Gap columns are mean / max joint distance in cm, with the per-frame step in brackets.

#seamclips (main A, branch, main B)entry gapexit gaprootheadingseverityfix
1chase gate_bump (wreck, cue c2_slide at 9.60 s)take_chase_split_b_s53 to gate_too_slow_s6 to take_chase_split_b_s5361 / 182 (cut)17 / 56 (cut)pull-back 108 cm at the cut in; 343 cm teleport at the rejoin1 at entry634camera cut + new recovery clip
2chase mirror_spin (flub, cue c3_mirror at 13.40 s)mirror_stumble_s2 to mirror_bounce_on_s11 to take_chase_split_c_s3616 / 46 (6.1/fr)20 / 67 (8.9/fr)392 cm in 1.7 s, peak 353 cm/s; height -9 cm132596root-aligned branch (new clip)
3chase mirror_dizzy (flub, cue m1_mirror at 28.80 s)mirror_stumble_s11 to mirror_dizzy_s1 to tailgate_leap_s315 / 68 (9.1/fr)16 / 46 (6.1/fr)372 cm in 1.1 s, peak 524 cm/s; height +5 cm85527root-aligned branch (new clip)
4cannon belly_flop (flub, cue c2_fire at 29.45 s)cannon_launch_flight_s11 to cannon_belly_flop_s25 to bow_to_crew_s1360 / 164 (21.8/fr)70 / 147 (19.6/fr)169 cm in 2.2 s, peak 115 cm/s; height +86 cm39414shared transition pose + recovery clip
5brawl short_slide (flub, cue b4_table at 13.18 s)brawl_beat_c_s7 to table_short_roll_s17 to dust_off_s125 / 69 (9.1/fr)20 / 67 (8.9/fr)251 cm in 3.5 s, peak 108 cm/s; height +5 cm7329root-aligned branch (new clip)
6chase vault_clip (flub, cue c1_vault at 5.20 s)take_chase_split_a_s79 to vault_tumble_roll_on_s33 to take_chase_split_b_s5316 / 58 (7.7/fr)20 / 58 (7.8/fr)183 cm in 2.9 s, peak 96 cm/s; height +21 cm13265root-aligned branch (new clip)
7brawl rope_miss (flub, cue r1_swing at 23.15 s)rope_swing_kick_s1 to flub_late_jump_s25 to brawl_uppercut_s37 / 33 (4.4/fr)59 / 123 (16.4/fr)87 cm in 0.5 s, peak 251 cm/s; height +50 cm12247longer branch + recovery clip
8brawl bad_landing (flub, cue s2_fall at 30.25 s)bandstand_fall_s1 to limp_off_s2 to bow_to_crew_s1387 / 187 (25.0/fr)11 / 41 (5.4/fr)26 cm in 3.8 s, peak 10 cm/s; height +1 cm4218shared transition pose + recovery clip
9chase tailgate_miss (wreck, cue c4_leap at 16.40 s)take_chase_split_c_s36 to tailgate_miss_s5 to take_chase_split_c_s3623 / 58 (cut)43 / 139 (cut)pull-back 66 cm at the cut in; 11 cm teleport at the rejoin56 at entry215camera cut + recovery clip
10chase tailgate_hang (wreck, cue t1_leap at 32.55 s)tailgate_leap_s3 to truck_hang_on_s37 to dust_off_s142 / 91 (cut)22 / 83 (cut)pull-back 50 cm at the cut in; 62 cm teleport at the rejoin10 at entry204camera cut + recovery clip
11cannon land_slip (wreck, cue c4_land at 33.02 s)cannon_tuck_land_s20 to cannon_land_slip_hang_s36 to bow_to_crew_s1320 / 52 (cut)14 / 45 (cut)pull-back 49 cm at the cut in; 71 cm teleport at the rejoin0 at entry172camera cut
12brawl eat_the_chair (wreck, cue b3_sell at 9.43 s)brawl_beat_b_s1 to chair_eat_stagger_s6 to brawl_beat_b_s115 / 72 (cut)18 / 70 (cut)pull-back 21 cm at the cut in; 4 cm teleport at the rejoin17 at entry96camera cut
13cannon stage_fright (flub, cue k1_wave at 9.20 s)cannon_wave_crowd_s31 to mark_check_nervous_s6 to high_five_crew_s220 / 80 (10.7/fr)21 / 56 (7.4/fr)11 cm in 1.3 s, peak 13 cm/s; height -1 cm395blend only (retime)
14brawl early_sell (flub, cue b1_duck at 5.14 s)brawl_beat_a_s17 to haymaker_early_sell_s2 to brawl_beat_b_s110 / 28 (3.8/fr)7 / 25 (3.4/fr)3 cm in 2.6 s, peak 2 cm/s; height -2 cm437blend only
15brawl chair_whiff (wreck, cue b5_chair at 15.86 s)brawl_beat_c_s7 to chair_whiff_s7 to brawl_beat_c_s77 / 18 (cut)4 / 9 (cut)pull-back 2 cm at the cut in; 3 cm teleport at the rejoin18 at entry23none

The fix per seam

  1. chase gate_bump (camera cut + new recovery clip). Wreck. Keep the reset shot's camera cut and add Walt's "Cut!" at it, but make the action match across it. Re-anchor the reset at the judge time (cue + 0.43 s) instead of the cue time: that removes the 108 cm pull-back. Two new clips, chained: slide_stop_lying (starts in the slide, stops) then getup_run_back (gets up and runs on); set rejoin_t so the main path is where that clip ends (about 3.5 m on). Today gate_too_slow ends 6 cm from where it began and the main path is 349 cm ahead.
  2. chase mirror_spin (root-aligned branch (new clip)). Replace mirror_bounce_on-s11, which stays near the mirror and is then dragged 392 cm in 1.7 s (3.5 m/s at the peak) while its hips turn 132 degrees against the next clip. stumble_recover_run bounces off, recovers and keeps running about 4.3 m, ends heading with the run, so the ramp goes to 0 and the exit turn is small. The 2.3 s branch fits a 3 s clip at rate 1.25. Blend end 16.25 s leaves 0.15 s before cue c4_leap (16.4 s): fits.
  3. chase mirror_dizzy (root-aligned branch (new clip)). Replace mirror_dizzy-s1, which spins in place, plays only 52% of its length (1.7 s branch, 3.5 s clip) and is then dragged 372 cm in 1.1 s (5.2 m/s peak) and turned 85 degrees. dizzy_stagger_run spins while staggering forward 3.7 m and sprints into the run-up of tailgate_leap. The branch only holds about 2.15 s of clip, so the spin has to come early; seam_rank reads the exit pose at 2.15 s. Cue t1_leap is 1.5 s past the blend: fits.
  4. cannon belly_flop (shared transition pose + recovery clip). Entry: the main flight is high in the air (4.3 m), the flop clip starts 164 cm away in joint space (40 cm height bridge): flight_belly_flop_lie starts in the flight and lands flat. Exit: the flop ends flat, the bow starts standing (147 cm); getup_dazed_prone, chained after it, ends on his feet. The build's arc carries the root, so no travel target. The branch swallows cues c3_tuck and c4_land; log that and score them as missed.
  5. brawl short_slide (root-aligned branch (new clip)). table_short_roll drags 251 cm of root over 3.5 s because the main path barely moves here (0.3 m) while the clip slides 2.5 m. table_roll_off_getup slides short, rolls off and gets up standing for dust_off (exit gap 67 cm today). Cue b5_chair (15.86 s) falls inside the branch, which ends at 17.97 s; it is swallowed, so commit its outcome as a miss or move the rejoin.
  6. chase vault_clip (root-aligned branch (new clip)). 183 cm of ramp over 2.85 s (96 cm/s) and 58 cm entry and exit gaps. vault_trip_roll_run trips, rolls on the ground and runs on about 7.6 m into take_chase_split_b. Cheaper first try: start the existing vault_tumble_roll_on 1.2 s in (trim), which lowers the entry gap from 16 to 4 cm mean and 58 to 14 cm max. Next cue c2_slide is 0.35 s past the blend: tight but fits.
  7. brawl rope_miss (longer branch + recovery clip). The branch is only 1.17 s long and the 3 s fall plays 38% of itself, so the fall is cut off in mid-air and the hips are 50 cm too low against the next clip (123 cm exit gap, 87 cm ramp in 0.5 s, 2.5 m/s peak). Rejoin one clip later (skip_clips 1, bandstand_fall at 28.85 s, a 5.2 s branch) and append getup_fight_ready (the real get-up from flat on the chest that the ticket asks for). The branch swallows cue s1_upper. Needs plan_flubs to take a list of branch clips (A, fall, get-up, B) or the two clips baked into one.
  8. brawl bad_landing (shared transition pose + recovery clip). Entry is the worst of any flub (187 cm max, 25 cm per frame of crossfade, an 88 cm height bridge): the main clip is flat on his back at the cue, limp_off starts standing. The existing dust_off-s3 (gag 40 of 40) starts flat on his back and ends standing: entry 33 / 118 and exit 6 / 20 against 87 / 187 and 11 / 41 today. The limp is lost, the pose is right; the new back_getup_limp_off and getup_clutch_back did not work (0 of 30 each). Exit is fine (41 cm) and the root ramp is only 26 cm.
  9. chase tailgate_miss (camera cut + recovery clip). Wreck. The reset ends flat on the ground (hips 14 cm) and the cut lands on a running main clip (139 cm gap). getup_run_back after tailgate_miss; the heading also jumps 56 degrees at the entry cut (the reset starts at its own heading, the main clip is turned 56 degrees), so turn the reset clip onto the main heading.
  10. chase tailgate_hang (camera cut + recovery clip). Wreck. The reset ends hanging 122 cm up, the main clip is standing on the bed (83 cm exit gap). hang_pull_up_stand ends standing on the platform. Pull-back at the entry cut is 50 cm.
  11. cannon land_slip (camera cut). Wreck. 52 cm entry and 45 cm exit gaps, 49 cm pull-back, 71 cm teleport. Keep the camera cut and Walt's "Cut!"; re-anchor at the judge time. No new motion needed if the cut is clean.
  12. brawl eat_the_chair (camera cut). Wreck. The stagger travels 74 cm and the main path 71 cm, so the exit is a 4 cm step, but the pose gap is 70 cm max and the heading is turned 17 degrees at the entry cut. Cut, and turn the reset onto the main heading.
  13. cannon stage_fright (blend only (retime)). Small root ramp (11 cm over 1.3 s) but 80 cm max entry and 56 cm exit pose gaps with 11 cm per frame of crossfade; 52% of the 4 s clip plays. Re-trimming does not help (mean 20 to 18 cm). A 0.4 s crossfade takes the step from 10.7 to about 6.7 cm per frame; check it by eye.
  14. brawl early_sell (blend only). Root ramp 3 cm, pose gaps 28 and 25 cm, crossfade 3.8 cm per frame at the entry and 3.4 at the exit: already inside the 5 cm per frame target. The branch swallows cue b2_uppercut.
  15. brawl chair_whiff (none). Wreck. 18 cm entry and 9 cm exit gaps, 2 and 3 cm root steps. Already clean.

What the laptop ticket needs from the engine side

  1. plan_flubs takes one fail clip (chain A, F, B). The get-up and recovery fixes need a list of branch clips (A, F, R, B), or F and R baked into one asset.
  2. Reset anchoring: use the judge time (cue + after_ms) for at_t, and pick rejoin_t from where the recovery clip ends on the main path.
  3. Turn the reset clip onto the main heading (today its yaw is 0 against a main clip turned up to 56 degrees).
  4. Drop the root ramp (set ramp to 0) once the replacement clips are in; keep the check that logs it.
  5. Crossfade 0.25 to 0.4 s at each branch seam; measure the max joint step per frame in the packaged build, not only the source clips.
  6. Walt's "Cut!" at each wreck cut (his shout_cut clip exists).

Batch 16 and 16b (recovery motion, tower 1)

Jobs mj-kimodo-seams-16 (seq 589, 300 takes, 1246 s) and mj-kimodo-seams-16b (seq 591, 150 takes, one phase per prompt, run after the SFX bake-off released the GPU lock), prompts in game/motion/kimodo_seams16.py, Kimodo-SOMA-RP-v1.1, 30 seeds each, 0 failed generations. Each prompt starts in the pose the seam leaves the actor in and ends on his feet in the main path's direction. Gag rules are in gag_checks.py; game/motion/seam_rank.py ranks each move against the real main-path clips named in game/takes/seam_specs.json. Score = entry mean cm + exit mean cm + 25 x travel error in m (lower is better), with the exit read at the last frame the branch can play (play_s). Previews of the top three per move: ~/studio-ai/renders/megajam/mj-kimodo-seams-16/previews/ and mj-kimodo-seams-16b/previews/ on tower 1.

seambest tag (chain)gagentry mean / max cmexit mean / max cmtravel m (target)score
chase mirror_dizzydizzy_stagger_run-s1pass (14/30)15 / 6812 / 444.1 (3.7)36 (next s9: 47, but turns 119 deg)
cannon belly_flopflight_belly_flop_lie-s9 then getup_dazed_prone-s18pass, pass16 / 52join 5 / 13, exit 5 / 200.6 (0.5)26 (today 60 / 164 in, 70 / 147 out)
brawl rope_missgetup_fight_ready-s16 (after flub_late_jump)pass (30/30)12 / 362 / 70.5 (0.5)14 (next s25, s3)
brawl short_slidetable_roll_off_getup-s23pass (6/30)29 / 545 / 190.4 (0.5)36 (next s6: 38)
chase tailgate_hanghang_pull_up_stand-s21pass (1/30)27 / 695 / 170.8 (0.5)40 (s26: 25, fails the hang test by a hair)
brawl bad_landingdust_off-s3 (existing, redo-13)pass (40/40)33 / 1186 / 200.7 (0.6)39 (today 87 / 187 in)
chase gate_bumpslide_stop_lying-s30 then getup_run_back-s16pass, pass37 / 123join 10 / 26, exit 10 / 331.8 + run-out56 (today 61 / 182 in, 17 / 56 out)
chase tailgate_missgetup_run_back-s5 (after tailgate_miss)pass (8/30)46 / 11217 / 513.6 (3.0)78 (s10: 89)
chase mirror_spinstumble_recover_run-s26pass (9/30)9 / 3218 / 826.6 (4.3)85 (s2: 95)
chase vault_clipvault_trip_roll_run-s23pass (2/30)18 / 6123 / 589.4 (7.6)85 (round 2 vault_dive_roll_run-s13: 95)

The two chained rows are the best pair by total score (entry + join + exit mean) among gag-passing takes, 30 x 26 pairs for the belly flop and 3 x 8 for the gate. The join is where one new clip hands to the next; 5 / 13 cm and 10 / 26 cm are inside the 37 cm limit for a 5 cm per frame crossfade.

What the numbers say:

Batch 20: constrained branches

Jobs mj-kimodo-branches-20 (flubs, 400 takes) and mj-kimodo-branches-20b (wrecks, 240 takes), tower 1, 0 failed generations. Code: game/motion/kimodo_branches20.py (plan from the take JSONs, constraints, seam numbers, gag) and rank_branches20.py; results and ranking.md in ~/studio-ai/renders/megajam/mj-kimodo-branches-20 and ...-20b. Each clip starts on the main path pose at the commit (flub: film_t; wreck: cue + 0.432 s) and ends on the main path pose at rejoin_t, full-body constraints on the first and last 3 frames, text guidance 4.0, 40 seeds. Rank: gag, both seam targets, joint-limit violations, whole-clip peak joint acceleration. Seam gaps are 0.00 to 0.60 cm at every pick, pelvis offset 0.0, velocity mismatch 0 percent. Clip length is whole frames, so the corrected rejoin_t is film_t + (frames - 1)/30; the clip then plays at rate 1.0 (drop rate_min, the root ramp and the fail-clip retime).

seampickbackupsgag passseam gaps start / end (max joint)joint-limit violationsaccel clip new / source (cm/frame^2)rejoin_t -> corrected (frames)
early_sell (flub)early_sell-s28s24, s3, s2522/400.01 / 0.02 cm, vel 0.0% / 0.0%110.03 / 3.349.0967 -> 9.1067 (104 fr)
short_slide (flub)short_slide-s14s20, s11, s120/400.09 / 0.02 cm, vel 0.0% / 0.0%25.09 / 3.8417.9667 -> 17.98 (129 fr)
rope_miss (flub)none (closest rope_miss-s17, fails fall)0/4024.9667 -> 24.9833 (40 fr)
rope_miss_long (flub)rope_miss_long-s33s22, s11, s2640/400.26 / 0.0 cm, vel 0.0% / 0.0%4421.21 / 13.8529.2167 -> 29.2167 (167 fr)
bad_landing (flub)bad_landing-s22s16, s28, s3240/400.0 / 0.0 cm, vel 0.0% / 0.0%3113.29 / 4.1335.3667 -> 35.3833 (139 fr)
belly_flop (flub)belly_flop-s17s33, s30, s740/400.02 / 0.01 cm, vel 0.0% / 0.0%42814.06 / 0.5134.7 -> 34.7167 (143 fr)
stage_fright (flub)stage_fright-s11/400.0 / 0.0 cm, vel 0.0% / 0.0%1710.54 / 8.7811.7667 -> 11.7667 (62 fr)
vault_clip (flub)vault_clip-s29 (ranker put s23 first, but its whole-clip peak is 130 against 17)s23, s36, s412/400.0 / 0.12 cm, vel 0.0% / 0.0%6227.94 / 17.079.3667 -> 9.3667 (110 fr)
mirror_spin (flub)mirror_spin-s24s38, s3, s440/400.0 / 0.0 cm, vel 0.0% / 0.0%07.05 / 8.2116.3667 -> 16.3667 (74 fr)
mirror_dizzy (flub)mirror_dizzy-s23s26, s5, s4015/400.0 / 0.0 cm, vel 0.0% / 0.0%015.2 / 9.9331.1667 -> 31.1667 (56 fr)
gate_bump (wreck)gate_bump-s19s9, s15, s640/400.6 / 0.06 cm, vel 0.0% / 0.0%012.42 / 6.8512.0 -> 12.0 (75 fr)
tailgate_miss (wreck)tailgate_miss-s1s15, s38, s1837/400.06 / 0.51 cm, vel 0.0% / 0.0%113.67 / 8.4616.95 -> 16.95 (90 fr)
tailgate_hang (wreck)tailgate_hang-s4s24, s19, s2237/400.09 / 0.03 cm, vel 0.0% / 0.0%05.77 / 4.0934.0 -> 34.0 (105 fr)
land_slip (wreck)land_slip-s5s38, s25, s1940/400.0 / 0.0 cm, vel 0.0% / 0.0%2413.88 / 7.9434.7 -> 34.7 (120 fr)
eat_the_chair (wreck)eat_the_chair-s16s35, s26, s3940/400.01 / 0.0 cm, vel 0.0% / 0.0%05.27 / 3.8511.5 -> 11.5 (75 fr)
chair_whiff (wreck)chair_whiff-s25s8, s1, s3027/400.0 / 0.0 cm, vel 0.0% / 0.0%02.69 / 0.3317.0 -> 17.0 (90 fr)

Notes for the laptop ticket:

Brawl rebuild: seams measured in the packaged game (Fri Nov 13, build D:\megajam\builds\brawl2)

The rebuilt brawl (game/takes/brawl2_take.py) was packaged and played by the perfect, late and none bots with -KKPelvisLog; the game now logs 18 joints of Kid and the heavy and the prop bones every tick (KKJ lines, about 83 a second). game/takes/brawl2/seam_check.py reads them. Nobody looked at a frame.

How to read it. "jump" is the largest unexpected move of any joint over one 30 fps frame (the move over the next three ticks minus the move over the last three). "usual" is the 99th percentile of the same number away from every seam. It is high (19 to 25 cm) because a body's logged pose is sometimes one tick stale, which a fast hand turns into a false step; the median is 1 cm. So a seam at or under "usual" is not shown to be a pop, and the 5 cm target cannot be confirmed below about 10 cm with this log. The build's own pose-fit numbers (CONSTRAINED and RESET lines) are exact and are given for the branches.

runseamjump cmjointusualroot step cm/susualunder 5 cm
perfectkid main: into brawl_beat_a_s1734.83hand_l23.4673.3128.3NO
perfectkid main: into brawl_beat_b_s113.03hand_l23.4610.6128.3NO
perfectkid main: into brawl_beat_c_s732.98hand_l23.463.1128.3NO
perfectkid main: into dust_off_s18.83foot_l23.462.5128.3NO
perfectkid main: into vr_kid_rope_swing_kick17.41calf_r23.4644.8128.3NO
perfectkid main: into brawl_uppercut_s34.42calf_r23.4625.3128.3yes
perfectkid main: into bandstand_fall_s133.29hand_r23.469.2128.3NO
perfectkid main: into dust_off_s1873.86hand_l23.4620.1128.3NO
perfectkid main: into bow_to_crew_s1311.55hand_l23.463.1128.3NO
perfectkid main: into dust_off_s114.93hand_r23.464.6128.3NO
perfectheavy main: into mark_check_nervous_s69.12hand_l19.2547.782.2NO
perfectheavy main: into heavy_wild_swing_miss_s1217.11hand_r19.2525.882.2NO
perfectheavy main: into haymaker_take_s1313.96lowerarm_r19.2543.582.2NO
perfectheavy main: into heavy_haymaker_throw_s1013.61ball_r19.255.682.2NO
perfectheavy main: into walk_to_mark_s212.48ball_l19.2533.682.2NO
perfectheavy main: into brawl_shove_chest_s333.12hand_r19.2514.182.2NO
perfectheavy main: into cs_heavy_chair_swing_2h63.2hand_r19.2514.082.2NO
perfectheavy main: into mark_check_nervous_s626.19ball_l19.253.482.2NO
perfectheavy main: into walk_to_mark_s2_rev34.79lowerarm_r19.2552.482.2NO
perfectheavy main: into walk_to_mark_s2_rev18.28ball_l19.25136.982.2NO
perfectheavy main: into walk_to_mark_s2_rev18.67ball_r19.25133.882.2NO
perfectheavy main: into walk_to_mark_s2_rev19.66ball_r19.25138.582.2NO
perfectheavy main: into walk_to_mark_s2_rev25.07ball_l19.25147.082.2NO
perfectheavy main: into mark_check_nervous_s625.53hand_r19.25137.582.2NO
perfectheavy main: into vr_heavy_pullback25.53hand_r19.25173.982.2NO
perfectheavy main: into heavy_wild_swing_miss_s1236.71hand_l19.2552.682.2NO
perfectheavy main: into walk_to_mark_s214.95ball_l19.2536.682.2NO
perfectheavy main: into heavy_haymaker_throw_s105.95hand_l19.258.082.2NO
perfectheavy main: into dust_off_s158.07hand_l19.251.782.2NO
perfectheavy main: into mark_check_nervous_s615.18hand_l19.257.682.2NO
perfectheavy main: into dust_off_s121.21lowerarm_r19.255.582.2NO
lateflub early_sell: in at film 5.6738.77lowerarm_r24.2643.3131.0NO
lateflub early_sell: back at film 9.3579.8hand_l24.262000.8131.0NO
lateflub short_slide: in at film 13.7134.6hand_l24.2641.8131.0yes
lateflub short_slide: back at film 17.9802.39hand_l24.26708.2131.0yes
lateflub rope_miss: in at film 23.68353.58hand_r24.26207.5131.0NO
lateflub rope_miss: back at film 29.2179.83hand_l24.26586.7131.0NO
lateflub bad_landing: in at film 30.7836.61ball_l24.2651.3131.0NO
lateflub bad_landing: back at film 35.6336.44hand_r24.26490.8131.0NO
latewreck eat_the_chair: cut in (main film 9.956)7.35ball_l24.2651.2131.0NO
latewreck eat_the_chair: cut back (to film 11.523)1.33lowerarm_r24.26127.7131.0yes
nonewreck eat_the_chair: cut in (main film 10.035)15.75lowerarm_r25.1849.9126.0NO

chair_whiff has no row: a missed b4 swallows b5, so no bot reaches it. Its build numbers: pose gap 0.01 cm at the cut in, 0.70 cm at the cut back.

Branches, build numbers (pose gap after the fit, max joint):

branchinoutleft at the rejoin, spread over the branch
early_sell-s2817.4 cm (head), 0.25 s crossfade1.1 cm after a 0.25 s crossfade, heading off 9 degpelvis 13.8 cm over 3.4 s (0.20 cm per frame at most)
short_slide-s141.5 cm, hard switch0.8 cm, hard switchpelvis 4.1 cm over 4.2 s
rope_miss_long-s33124.6 cm (hand), pelvis 26 cm off and 22 cm low, 0.4 s crossfade2.4 cm, hard switchnone: locked on its exit
bad_landing-s220.0 cm, hard switch0.5 cm after a 0.25 s crossfade, heading off 10 degpelvis 7.1 cm over 4.6 s
eat_the_chair-s16 (wreck)0.13 cm at the judge time0.56 cm0.09 cm
chair_whiff-s25 (wreck)0.01 cm0.70 cm0.09 cm

What the numbers say.

Contacts, perfect run.

Why the bandstand is not under the fall. bandstand_fall_s1 throws Kid 1.2 m straight back from where he stands. He stands 0.4 m ahead of where the rope swing put him down, and the swing came in along that same line: its last 2.4 m of flight are over the ground the bandstand's 2.4 m deck would need, at foot height 0.3 to 1.3 m, against a deck at 0.59 m with rails to 1.41 m on all four sides and a roof at 2.58 m. He would swing through it one beat before falling onto it. The fall is therefore a flat back fall on the boards, which is what the clip is (pelvis 7 cm above the floor at rest), and the smashing sounds are gone. To land him on a deck the fight has to move 2.5 m on after the swing, or the fall has to turn him: new motion either way.

Cannon rebuild (T7, Fri Nov 13): every seam of the three takes in the packaged game

Package D:\megajam\builds\cannon2 (927 MB), bots perfect, late, none, human sd 45 and 75 on chase, brawl and cannon with -KKPelvisLog; python brawl2/seam_check.py D:\megajam\builds\cannon2\runs --take <chase|brawl|cannon> (now takes --take). Full tables: D:\megajam\builds\cannon2\seams_all.md, json per take in runs\seams-<take>.json. "jump" is the largest unexpected move of any joint per 30 fps frame (cm); "usual" is the 99th percentile of the same number away from seams in that run. Root steps of about 2000 cm/s at a branch entry or exit are the checker dividing across the timeline jump, not a pop (the pelvis trace through the belly flop entry is continuous).

Cannon, the new parts (perfect, late):

seamjump cmusualnote
climb-in into the keyed clip (28.95 s, lying back in the bore)11.320.8the first build pitched him forward (137 cm): the climb-in's yaw is baked outside the tilt, so leaning back is -43.7 deg
wave s39 (turns him 180 deg while he waves)20.320.8
into the climb-in5.720.8
stage_fright-s1 in / back1.9 / 16.724.5back: the branch's own walk ends 92.6 cm ahead of the high five, spread over the 2 s branch (2.3 cm a frame)
belly_flop-s17 in (31.01 s, top of the arc) / back (35.85 s, the stand)35.0 / 15.624.5in: a 0.6 s crossfade from the tuck to s17's upright first frame (it was made on the old flight); 160 cm with 0.3 s
land_slip-s5 in (32.95 s, in the boxes) / back (36.91 s, in the wave)21.2 / 9.925.8from t7_landslip.ps1 (human sd 160, seed 19: no other bot misses c4 with c2 hit); 0.4 s crossfades both ways, the 68 cm pelvis gap spread over the branch

The keyed clip read back from the game: gravity 1126.9 cm/s2 and 1491.6 cm/s across (expected 1125 and 1491 at Rex's 1.147), apex pelvis 1514 cm; at rest in the boxes the pelvis is at 229.5 cm (200 x 1.147), standing in the crater the balls of the feet are at 235 cm over the 231 cm crater floor. The packaged game plays the retargeted pelvis 12.8 cm under the editor's mesh-retargeted evaluation; the first build had his feet 9 cm into the mattress, so the keyed clip and its branches are lifted 12.8 cm. Planted foot slide in the cannon take is worst in the old main path (123 cm in the sprint to the platform, 12.5 to 14.3 s; 62 cm in the first wave, 4.6 to 11.5 s), not in the rebuilt part. Bots on the final package: chase 5/1/1/5/3 stars (perfect, late, none, human 45, human 75), brawl 5/1/1/4/3, cannon 5/1/1/4/3, 0 error lines in all 15 runs and in the slip runs; premiere loop 15 of 15 sections planned = played, 0 errors, slow motion in at film 29.636 s and out at 32.420 s. Chase and brawl main joins and wreck cuts are unchanged from the brawl rebuild's numbers (cuts are camera cuts, 125 to 370 cm by design); the chase now carries a joint log ('joint_log' in chase.take.json). Not in git: Content/Props/Cannon2/GC_stunt_rig.uasset (120.6 MB, the repo keeps large media out); rebuild it from D:\megajam\proofs\cannon\k_stunt_rig.abc with KidKatapult/Scripts/t7_import.py (T7_STAGES=rig,mats).

T7 follow-up (Fri Nov 13): the ladder climb and two branches, ready for the laptop (not yet in the take or the package)

Ladder climb, k_kid_ladder_climb (keyed on tower 2: game/proofs/scripts/lad_dump.py, lad_geom.py on the laptop, lad_climb.py; numbers in game/proofs/cannon/lad_result.json and lad_geom.json; mannequin sheets game/proofs/cannon/lad_contact_*.jpg). Files in D:\megajam\proofs\cannon\ladder\ (hashes in SHA256SUMS.txt, the FBX checked against tower 2): k_kid_ladder_climb.fbx (175 frames, 5.80 s, proof skeleton, root bone pelvis, retarget to MH-Rex as the other keyed clips), k_kid_ladder_climb.json, SM_cannon_platform_ladder_gap.glb. It replaces walk_to_mark_s2 at 16.0 s (its lift_keys and slide go): out of the sprint, two stopping steps round the near rail to the ladder foot, hands on the rails, both feet onto each rung in turn (the rungs stand 71 cm apart in the game, so a foot cannot skip one), hands onto the two guard posts at the top, right foot from rung 3 onto the deck, the left hangs while he stands up on the deck, then comes over the edge, then two side steps and a quarter turn onto the mark, ending exactly on the wave's first frame at 21.8 s.

Branch picks (tower 1, game/motion/kimodo_cannon_t7.py, rank_cannon_t7.py; jobs mj-kimodo-cannon-t7 (4c3e58f) and -t7b (1a03c86); picks with SHA256SUMS in D:\studio-ai\renders\megajam\<job>\picks\, checked on the laptop):

branchpickseedentry gap cmexit gap cmvelocity mismatchgagnote
stage_frightstage_fright-s1 (t7)10.00.00.0 % / 0.0 %nervous: pass (1 of 40)ends on the high five where the build puts it: the end pin moves 1.6 cm from the commit (director log), the joint log says the main pelvis moves 8.2 cm there, so expect a rejoin gap of about 6 cm spread over the 2 s branch (0.1 cm a frame, was 2.3); 19 joint-limit frames; rejoin_t 11.7667, blends 0
belly_flopnone usable0.00.00.0 % / 0.2 %t7: 1 of 40, t7b: 0 of 40t7 (arc height kept, 11 m to fall in 1.4 s): only s34 passes the gag, but it shakes (peak joint acceleration 752 against 12.8 in the source), 1031 joint-limit frames and lands 110 cm off and 42 cm high of the boxes. t7b (whole arc removed, he starts at his contact height): seams all 0, steadier (accel 65 to 76, 62 to 131 joint-limit frames), but every seed lands on its back (chest_front_y +0.98 on s33). Stopped after two tries; the old belly_flop-s17 with its 0.6 s entry crossfade stays in the take. Next lever: a mid-clip pin at contact (face-down pose) or a belly-first source pose
The 12.8 cm sink: cause and fix (Fri Nov 13, wiring run)

Cause. AnimationLibrary.get_bone_pose_for_time(anim, "pelvis") does not return the stored track: it retargets to the skeleton's reference pose and returns the stored value minus (0, 0.62, 12.8) cm for Rex_final's body mesh (stored 94.0, read 81.2 on walk_to_mark_s2, every frame, every clip tried, Walt's and the heavy's included in kind). The mesh-retargeted pose evaluation (AnimPoseExtensions with the mesh, what _joints uses) returns the stored value. The game plays the stored track as it is. director_align.sample_source read with the first call and realize wrote with set_bone_track_keys, which stores exactly what it is given, so every baked ("aligned") copy lost the constant (written 88.06, read back 75.26 in a scratch copy). Unbaked first clips were right; every baked clip had Rex's full-length legs under a pelvis 12.8 cm too low, and each first-to-second clip handover stepped the pelvis 13 cm. Not Rex's mesh (Body at 0, scale 1, bounds z 0 to 147), not a capsule (the BP root is a scene component), not the retarget, not the builder's z. Probes: D:\megajam\builds\logs\sink_probe*.log. Fix. director_build._store_offset measures the constant per clip and body mesh, director_align.realize(..., off) adds it back to every baked key. Removed: ZFIX in cannon2_take.py (take file patched in place by sink_unfix_cannon.py: keyed clip lift, climb-in lift keys, belly_flop and land_slip lifts, applause lift), ZOFF in lad_geom.py (0), the ladder clip rebuilt on tower 2. Joint log, packaged D:\megajam\builds\wire1 (perfect bot), planted-foot sole height (ball z minus 0.9, feet_check.py): was a median 10.7 (chase), 10.0 (brawl), 11.0 (cannon) cm under the support in cannon2; now the unbaked first clip and the baked clips agree: floors +2.1 to +2.8 cm (the walk pose's ball sits 2.1 cm over the flat-foot rest; the unbaked first clip reads the same), chase truck bed 116.1 against 114 (+2.1), cannon deck 301.2 against 298.2 (+3.0), crater 233.8 against 231 (+2.8). Medians of the absolute error 2.1 (chase), 2.5 (brawl), 2.4 (cannon). Outliers: lying poses (hay throw landing +10 cm, a prone body) and the leap's landing frames (-7 for 0.45 s).

Cannon wiring (ladder, platform, stage_fright)

Ladder rebuilt with real heights (ZOFF 0): the step from rung 3 to the deck is 93 cm with the rungs where the set has them, past the reach, so the climb now uses all four rungs (lad_climb.py: climb plan, pelvis keys, grips; ZOFF 12.8 keeps the old plan). Result (lad_result.json): hands within 1.63 and 1.39 cm of the grips, feet within 3.7 (left) and 2.2 cm of the rungs (was 1.6), joins 0.03 cm into the sprint and 0.0003 cm into the wave, planted slide 0.8 cm at most, foot IK error 2.7, hand 3.0 (was 3.9 and 1.9); a toe passes 3.4 cm into the platform edge at frame 126. The old ZOFF 12.8 files are in D:\megajam\proofs\cannon\ladder\zoff12.8\. ladder_import.py brought the FBX in; the opened platform GLB replaced D:\megajam\props\sets_made\SM_cannon_platform.glb (the closed one is SM_cannon_platform.closed_ladder.glb) and was reimported over SM_cannon_platform. cannon.take.json: k_kid_ladder_climb at 16.0 s, rigid, blend 0, psi_abs -5.753, no lift or slide (wire_cannon_ladder.py); the wave at 21.8 s has blend 0. stage_fright_s1 is the t7 pick (its BVH copied from mj-kimodo-cannon-t7/picks, the batch 20 one kept in D:\megajam\retarget\takes_backup_before_t7pick).

Wiring run result (D:\megajam\builds\wire1, 868.4 MB zip, gate 940)

Bots on the package, 0 error lines in all runs: chase 5/1/1/4 stars (perfect, late, none, human 45), brawl 5/1/1/4, cannon 5/1/1/4. Premiere bot full loop with the walk-throughs and beats playing out (walk_chase 30.0 s, beat_1 24.5 s of 35.95 (good branch, 4 stars), walk_brawl 26.8, beat_2 23.1, walk_cannon 30.3, beat_3 25.2), premiere three reels, credits, back to the sheet: 703 s, 0 errors. D:\megajam\builds\cannon2 was overwritten by a first run of wire1_run.ps1 with the wrong default folder (stopped after the chase runs; the cannon2 chase logs are gone, its tables above are the record).


WALKTHROUGH.md

Source game/takes/WALKTHROUGH.md. Last git commit 2026-11-13. About 2,166 words.

Walk-throughs (CONTENT-PLAN section 3): the laptop ticket

Three takes, one before each scene: walk_chase.take.json, walk_brawl.take.json, walk_cannon.take.json, written by make_walk_takes.py (rerun it if a line is re-recorded: every line time comes from the wav lengths). They are the shoot on Stage 7, not the film: no 1978 grade, neutral work light, no cues, no score. Walt walks Kid a few steps to the first mark, points it out, and the far marks get slow inserts while his lines run over them. Kid has one line in each (Rex's voice, the takes' convention: rex_*.wav spoken by the actor kid).

takelengthshotslines
walk_chase30.0 ss1 lead dolly on Walt and Kid at the cart, s2 swing gate, s3 mirror maze front, s4 the two of them, s5 the truckwalt_w01 to w04, rex_w01
walk_brawl26.8 ss1 lead dolly along the long table, s2 the heavy on his mark with the bar behind, s3 the rope from below, s4 the two of them, s5 the bandstandwalt_w05 to w08, rex_w02
walk_cannon30.3 ss1 the two of them walking to Kid's mark (Stage 7's lamps behind), s2 wide of the cannon and grandstands (the effects man off camera), s3 the two of them, s4 down the barrel to the truckwalt_w09 to w12, fx_w01, rex_w03

How the game should play them

  1. Before a scene's first attempt, play walk_<scene> (sequence tagged DIR_walk_<scene>), then go straight into <scene> as now. Not before a retake or a reset.
  2. Skippable with any input (keyboard, pad, touch) once 2.0 s have played (walkthrough.skippable_after_s). Input before 2 s is ignored, so the button that confirmed the call sheet cannot skip it by accident. A skip cuts straight to the take with the usual fade; stop the walk's audio.
  3. No cue gate: the cue table director_cues.py writes for a walk take is empty (it warns W03 "the take has no cues", which is expected). No HUD calls, no score, no takes for the edit bay, nothing in the premiere or the blooper reel.
  4. Visibility. A walk take needs its scene's set but not the scene's cast, props or film lights: show DIR_walk_<scene> (its own Kid, Walt, props, work lights, cameras) plus the set dressing tagged KK_settake_<scene> (walkthrough.set_take), and hide the rest of DIR_<scene>. Today the sets also carry DIR_<scene>, so the rule "drop every other take's DIR_ actors" would hide the set; with game/sets/proposed/KKGame_settags.patch the game already drops sets by KK_settake_, which makes this one line: keep KK_settake_<walkthrough.set_take>.
  5. Light: the walk takes carry their own neutral lights (work_sun, work_sky), so the game treats them like any take (work lights off while it is up). If you would rather keep Stage 7's KK_worklight rig on for walk-throughs, delete lights from the three files in make_walk_takes.py instead; do not run both.
  6. Grade: the files have no grade key on purpose, so their cameras get no film look. If the game adds any grade or letterbox of its own when a take starts, skip it for walk_ takes.

Builder fields

Build and check (laptop, after the current take worker is done)

  1. run_director_build.ps1 -Take walk_chase (and walk_brawl, walk_cannon), then rerun set_build.py all as after any director build (sets README).
  2. Read the build log: PATH kid and PATH walt. walk_to_mark covers about 1.5 m in its first 1.2 s; two of them should leave Kid about 3 m on from his start. Chase: Kid must pass the cart (610, -125) with at least 80 cm clear and Walt must stay off the booths. If the walk curves, move location in make_walk_takes.py, not the clips.
  3. frame_checks (s1 at 1.0 and 4.5 s): Kid, Walt, and the cart or table in frame.
  4. Two known set issues, for the sets worker, not this ticket: the brawl's bandstand stands at (1537, -35) in the layout but the take's fall lands near x 0; and the mirror maze front (batch 15) is still a stand-in, so chase shot s3 shows only the booths behind its spot until it imports.

Lip sync (later)

The 21 new lines (15 walk lines, 6 calls) need face anims before the faces move: /Game/KKCast/LipSync/walt/walt_w01 to walt_w12, walt_c01 to walt_c06, and /Game/KKCast/LipSync/rex/rex_w01 to rex_w03, made the way the cast's were (game/casting/ls_solve.py, ls_run.py, ls_check.py, LIPSYNC_IMPORT.txt). Every line in the walk takes already has lipsync: true; until the anims exist the build warns per line and the faces play eye life only.

Better Kid motion (optional)

take_walkthrough-s11 (mj-kimodo-takes-4 on D:\studio-ai\renders\megajam, 10 s, walks 2.66 m beside a director, points at a spot on the floor, crouches to touch it, stands and mimes a jump, no joint-limit frames) was made for exactly this and is not retargeted. Retargeted onto Rex_final it could replace Kid's two walk_to_mark clips in all three walks.

Voice

Made on tower 1 in ~/mj-tmp/voice-walk exactly as the final cast (~/mj-tmp/voice-final-work): Maya1 with gen_final.py's settings (gravel for Walt, matinee for Rex, temperature 0.4, top_p 0.9, seeds 4321 + 1000 x idx + take), check_takes.py (Whisper) with WER at most 0.05, Audiobox aesthetics, ECAPA similarity against the cast's reference takes (walt_l01_t1, rex_l02_t2) with the cast's threshold (median minus 0.10), finalize.py (0.15 s pads, -18 LUFS). Rows are in game/audio/voice/manifest.json.

All 15 walk-through lines passed WER and similarity in 3 takes. walt_w03 and walt_w04 use a passing take about 1 to 2 s tighter than the top aesthetics one (within 0.05), to keep the chase walk near 30 s.

The walk-throughs run longer than the plan's 20 s (chase 30 s, brawl 27 s, cannon 30 s); the skip after 2 s covers repeat plays. To shorten, cut walt_w03 (the mirror line) from the chase, about 5.6 s.

Walt's calls for the longer takes (walt_c01 to c06)

Six short calls the longer takes show as text only, recorded the same way: walt_c01 "Right!", walt_c02 "Swing!", walt_c03 "Hit!", walt_c04 "Fall!", walt_c05 "Wave!", walt_c06 "High five!" (0.9 to 1.5 s each, -18 LUFS). All six passed the Whisper check. c01 and c06 also passed the similarity check. c02 to c05 did not in 8 takes: ECAPA can't score a one-word, one-second clip, the same reason the cast's "Jump!" (walt_l08, 0.312) went in flagged. They follow that rule (the closest take that passes WER, similarity_flag in the manifest). Listen to those four before they ship.

For the laptop ticket, the takes' calls they voice (the take JSONs belong to the take worker, so wire them there):

call text in the takecuewavplay at
RIGHT!chase m1_mirror 28.8walt_c01t - call_lead_ms like the other spoken calls
SWING!brawl r1_swing 23.15walt_c02same
HIT!brawl b2_uppercut 6.21, s1_upper 25.3walt_c03same
FALL!brawl s2_fall 30.25walt_c04same
WAVE!cannon k1_wave 9.2walt_c05same
HIGH FIVE!cannon k2_five 13.05walt_c06same

Add each as a lines entry (speaker: walt, lipsync: true) and copy it into the flub branches as take_audio.py does for the existing calls. Lip sync for c01 to c06 goes in the same later batch as the walk lines.

Story fixes 2026-11-13 (decisions.md Thu 23:36)

The cannon climax is now Johnny's evening show turned on the robbers' truck (STORY.md), and Kid lands back first on a box stack under the truck's tarp. Lines made on tower 1 in ~/mj-tmp/voice-storyfix exactly as above (gen_final.py settings, seeds 4321 + 1000 x idx + take with idx 400 to 407, 3 takes each, Whisper WER at most 0.05, aesthetics, ECAPA), finalized at -18 LUFS:

wavwhotextresult
walt_w12 (re-recorded)Walt"It'll look bigger on the way down. Land flat on your back and let the boxes do the rest."take 0 of 3 passing, similarity 0.467 (threshold 0.354), 5.51 s
fx_w01 (new)the effects man, off camera"It's a spring, Kid. The bang's for the camera."Maya1 brooklyn take 2, 2.95 s; see below
walt_c07 (new)Walt"Keep rolling, keep rolling!"flagged: 8 takes, all pass WER, none reach 0.354; kept take 6 (0.337), 3.19 s
walt_c08 (new)Walt"Truck's parked, Kid. Give me the leap again for the insert."take 1 of 2 passing, similarity 0.506, 3.37 s

The effects man is a new cast voice from the Maya1 designs of the voice bake-off. A take is his only if it passes WER and sits under both Walt's and Rex's own same-speaker thresholds (ECAPA against walt_l01_t1 under 0.354, against rex_l02_t2 under 0.378); designs already cast are out (gravel for Walt, matinee for Rex, brisk for the AD). Of 15 takes over five designs, three passed (brisk t0, brooklyn t2, nervous t2); brisk is the AD's voice, so brooklyn t2 is cast: Walt 0.268, Rex 0.335, AD 0.229. Walt's reference scores 0.352 against Rex's, for scale. brooklyn's other two takes sounded too close to Walt (0.435, 0.438), so a re-record of this line must pass the same check again. Rows are in manifest.json with a voice_match field.

walt_c07 is shouted and short, the same ECAPA trouble as c02 to c05: listen before it ships.

Lip sync for tower 2 (later), made like the cast's: /Game/KKCast/LipSync/walt/walt_w12 (redo for the new text), walt_c07, walt_c08. None for fx_w01 or Rex's two retagged lines, since nobody on camera speaks them.

In the game (wired Fri 2026-11-13, laptop)

KKGame.cpp StartSide / TickSide / EndSide (phase Walk). The call sheet's run plays walk_<scene> before the scene's first attempt: StartTake asks SidesWanted() (the sheet is rolling, or -KKSides; -KKNoSides turns it off), keeps DIR_walk_<scene> in RemoveOtherTakes, hides every other DIR_ actor (the scene's cast, props and film lights, remembered and restored after) and every set but KK_settake_<set_take>, lets ApplyStageLights give the walk its own work lights, and plays the sequence. A retake (GoAgain) never goes through StartTake, so it never plays. Any key, pad button, mouse click or touch skips once walkthrough.skippable_after_s (2.0) has passed; earlier input is logged KKSIDE input ignored. The HUD draws no grain, no grade and no letterbox, only an "ANY BUTTON TO SKIP" card once input counts. After the walk its actors are destroyed, the scene's come back and the scene's call goes on (banner, 1.5 s, the take). The table the game reads is Content/Data/walk_<scene>_cues.json, which director_cues.py now writes with the take's walkthrough block (python prep/scripts/director/director_cues.py game/takes/walk_chase.take.json --out game/KidKatapult/Content/Data/walk_chase_cues.json). Bots: -KKSkipSidesAt=<s> skips every walk and beat that many seconds in; the default is to play them out. Logs: KKSIDE start|end|visibility, KKBOT skips. Walt's walk (KimodoWalt/walk_to_mark_s2) did not exist: retargeted from walk_to_mark-s2 onto Walt_v3 with RT_STAGES=retarget (cast3_retarget.ps1's recipe), then the three walks rebuilt. Walt's calls walt_c01, c03 (twice), c04, c05 and c06 are in the takes (wire_calls.py, at the cue minus call_lead_ms, lipsync: true, with the megaphone key-up); the director copies them into the flub branches. walt_c02 (SWING!) is not placed: at the cue minus 0.6 s it would sit on top of walt_l06 ("Now, Kid. Go!", 21.8 to 23.84 s), and walt_c05 starts at 8.9 s instead of 8.6 s so it follows walt_l17. Every spoken line with a face anim has lipsync: true except Rex's two off-camera lines (rex_x02, rex_x03), which have anims from the cast but are not spoken by anyone on camera.


WIRING-PLAN.md

Source game/takes/WIRING-PLAN.md. Last git commit 2026-11-13. About 766 words.

Wiring plan (Fri 2026-11-13, laptop, Sonnet): sink fix, cannon wiring, walk-throughs and beats

Started 10:05. Written 10:18 after the sink investigation, which is the only job that had to be proven before anything else.

1. The 12.8 cm sink: cause found (numbers, no engine change needed)

Probes: D:\megajam\builds\logs\sink_probe*.log (UnrealEditor-Cmd python, scratch scripts in the agent scratchpad).

Fix, once: _realize computes the offset per source clip and mesh (mesh-retargeted pelvis minus library read, frame 0) and realize adds it to every baked pelvis key. All baked clips then play at the stored height, consistent with the unbaked ones and with the editor's mesh evaluation. Then remove the compensations: cannon2_take.py ZFIX (keyed clip lift, climb-in lift target, flub and applause lifts) and lad_geom.py ZOFF. cannon.take.json is patched in place by a one-off script (the take file carries edits from other scripts; no regenerate).

Check: rebuild the three takes (director builds exit 0), package, read the joint log (KKJ): ball z at foot plants against the floor / deck / truck bed, within 2 cm, in all three takes. Per-take floor heights come from the take json and layout.

Feasible: yes, proven in the scratch copy test; the full proof is the package.

2. Cannon wiring (ladder climb, opened platform, stage_fright-s1)

3. Walk-throughs and beats in the game (C++, KKGame.cpp)

WALKTHROUGH.md and BEATS.md give the full spec. Take files and audio exist. Needs: StartTake hook for walk_<scene> before a scene's first attempt and beat_<n> after each edit bay, 2 s skip lockout, visibility rule (DIR tag plus KK_settake_<set_take> / KK_set_stage7), no grade, beat branch pick by stars (jump_at then seek), plus take edits: lipsync:true on every line with a face anim, walt_c01..c06 lines in the takes per the table, phone sounds already mapped. Check by run_cue_tests.ps1 and the packaged premiere bot. Risk: largest job; the game code for takes is one 2400 line file. If time runs out the walk/beat playback is the first thing to report undone.

Order and gates

1 sink fix and rebuild three takes (director builds), 2 ladder and cannon wiring, 3 walk/beat code and take edits, then build_editor.ps1, run_cue_tests.ps1, package to D:\megajam\builds\wire1 (pkg_smoke.ps1 -Profile jam, gate 940 MB), premiere bot full loop, joint log check, commit by explicit paths, push.