Open the books

RAW FILES: Kid Katapult pipeline notes

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

RETARGET-AB.md

Source game/motion/RETARGET-AB.md. Last git commit 2026-11-12. About 2,382 words.

Retarget A/B: UE IK Retargeter vs toyxyz-blender-retargeter

Run 2026-11-12. Measure only, nothing imported into the game project. Scripts: ab_ue_export.py, ab_ue_incumbent.py, ab_challenger.py, ab_measure.py, ab_report.py, ab_strip.py (this folder). Raw data and strips: D:\megajam\retarget\ab\.

Setup

Results

take_chase_split_a_s79 (149 frames at 30 fps)
MeasureKimodo sourceIncumbentChallenger
Foot slide, cm per contact, foot_l0.59 (n=6, max 3.2)1.32 (n=5, max 4.4)0.92 (n=5, max 3.1)
Foot slide, cm per contact, ball_l1.59 (n=7, max 3.3)1.44 (n=6, max 4.0)1.43 (n=7, max 2.9)
Foot slide, cm per contact, foot_r0.40 (n=4, max 1.2)1.67 (n=4, max 3.0)0.67 (n=4, max 1.2)
Foot slide, cm per contact, ball_r1.46 (n=4, max 2.1)1.75 (n=5, max 2.9)1.31 (n=5, max 2.9)
Foot slide, cm per contact, all1.05 (n=21, max 3.3)1.53 (n=20, max 4.4)1.14 (n=21, max 3.1)
Foot slide, height test only (speed test dropped), cm per contact, all10.6 (n=29)6.0 (n=29)13.5 (n=31)
Root path length / (source path x 0.8578)1.000 (source 10.393 m)1.121.062
Root drift, end error vs scaled source path, cm-105.353.7
Root drift, max / rms deviation, cm-105.3 / 69.953.7 / 35.6
Joint-limit gate, joint-frame violations (frames affected)0 (0 of 149)0 (0 of 149)3 (3 of 149)
Gate, joints overnonenoneshoulder_l.behind x2, shoulder_r.behind x1
Wrist twist, left: range deg (min to max)56.5 (-37.0 to 19.5)56.5 (-34.5 to 22.0)56.7 (-19.3 to 37.4)
Wrist twist, right: range deg (min to max)42.6 (-15.2 to 27.4)41.8 (-41.5 to 0.3)43.0 (-27.0 to 16.0)
take_chase_split_c_s36 (149 frames at 30 fps)
MeasureKimodo sourceIncumbentChallenger
Foot slide, cm per contact, foot_l0.20 (n=5, max 0.6)1.44 (n=5, max 3.2)0.38 (n=5, max 0.9)
Foot slide, cm per contact, ball_l1.88 (n=6, max 4.4)2.48 (n=5, max 4.2)1.56 (n=6, max 3.4)
Foot slide, cm per contact, foot_r0.60 (n=5, max 1.9)1.21 (n=5, max 2.8)0.57 (n=6, max 1.9)
Foot slide, cm per contact, ball_r0.83 (n=7, max 1.6)1.19 (n=6, max 2.4)0.74 (n=8, max 1.3)
Foot slide, cm per contact, all0.92 (n=23, max 4.4)1.56 (n=21, max 4.2)0.82 (n=25, max 3.4)
Foot slide, height test only (speed test dropped), cm per contact, all7.2 (n=22)6.3 (n=23)8.2 (n=21)
Root path length / (source path x 0.8578)1.000 (source 5.222 m)1.121.058
Root drift, end error vs scaled source path, cm-50.626.1
Root drift, max / rms deviation, cm-51.0 / 40.927.0 / 21.3
Joint-limit gate, joint-frame violations (frames affected)2 (2 of 149)8 (6 of 149)6 (5 of 149)
Gate, joints overwrist_l.twist x2wrist_l.side x2, wrist_l.twist x4, ankle_l.twist x2wrist_l.side x2, wrist_l.twist x2, ankle_l.twist x2
Wrist twist, left: range deg (min to max)116.3 (-35.9 to 80.4)115.2 (-94.8 to 20.4)116.0 (-80.0 to 36.0)
Wrist twist, right: range deg (min to max)88.0 (-60.5 to 27.5)88.1 (-42.9 to 45.2)88.3 (-27.8 to 60.5)
take_cannon_full_s5 (270 frames at 30 fps)
MeasureKimodo sourceIncumbentChallenger
Foot slide, cm per contact, foot_l1.02 (n=4, max 3.0)2.86 (n=5, max 4.8)1.91 (n=4, max 3.2)
Foot slide, cm per contact, ball_l3.44 (n=4, max 6.2)5.44 (n=4, max 8.2)3.43 (n=4, max 4.8)
Foot slide, cm per contact, foot_r0.84 (n=3, max 1.5)2.87 (n=3, max 3.0)0.92 (n=4, max 1.9)
Foot slide, cm per contact, ball_r2.12 (n=7, max 5.7)3.71 (n=4, max 6.5)2.92 (n=5, max 5.5)
Foot slide, cm per contact, all1.96 (n=18, max 6.2)3.72 (n=16, max 8.2)2.33 (n=17, max 5.5)
Foot slide, height test only (speed test dropped), cm per contact, all10.7 (n=15)11.2 (n=15)13.9 (n=12)
Root path length / (source path x 0.8578)1.000 (source 1.735 m)1.0151.087
Root drift, end error vs scaled source path, cm-0.20.8
Root drift, max / rms deviation, cm-0.9 / 0.54.2 / 2.1
Joint-limit gate, joint-frame violations (frames affected)0 (0 of 270)0 (0 of 270)0 (0 of 270)
Gate, joints overnonenonenone
Wrist twist, left: range deg (min to max)58.4 (-35.9 to 22.5)58.2 (-38.2 to 20.0)58.7 (-22.3 to 36.4)
Wrist twist, right: range deg (min to max)26.9 (-16.3 to 10.6)26.5 (-25.9 to 0.6)27.4 (-10.3 to 17.1)
brawl_beat_b_s1 (149 frames at 30 fps)
MeasureKimodo sourceIncumbentChallenger
Foot slide, cm per contact, foot_l0.49 (n=2, max 1.0)3.05 (n=2, max 4.2)1.10 (n=2, max 1.9)
Foot slide, cm per contact, ball_l3.20 (n=2, max 4.5)3.97 (n=2, max 5.4)2.71 (n=2, max 3.8)
Foot slide, cm per contact, foot_r0.55 (n=3, max 1.2)1.87 (n=3, max 3.6)0.69 (n=3, max 1.0)
Foot slide, cm per contact, ball_r1.94 (n=3, max 2.5)2.56 (n=3, max 4.7)1.94 (n=3, max 2.9)
Foot slide, cm per contact, all1.48 (n=10, max 4.5)2.73 (n=10, max 5.4)1.55 (n=10, max 3.8)
Foot slide, height test only (speed test dropped), cm per contact, all19.2 (n=14)25.7 (n=12)24.6 (n=13)
Root path length / (source path x 0.8578)1.000 (source 1.826 m)1.0151.059
Root drift, end error vs scaled source path, cm-2.18.3
Root drift, max / rms deviation, cm-2.1 / 1.78.4 / 6.9
Joint-limit gate, joint-frame violations (frames affected)0 (0 of 149)0 (0 of 149)0 (0 of 149)
Gate, joints overnonenonenone
Wrist twist, left: range deg (min to max)13.2 (21.5 to 34.7)13.1 (-49.9 to -36.8)13.4 (-34.4 to -21.0)
Wrist twist, right: range deg (min to max)17.2 (11.1 to 28.3)17.4 (-43.9 to -26.5)17.4 (-28.2 to -10.8)

Summary

MeasureIncumbentChallengerReads as
Foot slide, mean cm per contact (gated), chase a / chase c / cannon / brawl1.53 / 1.56 / 3.72 / 2.731.14 / 0.82 / 2.33 / 1.55challenger lower on 4 of 4 takes and on all 16 bone cells; source itself is 1.05 / 0.92 / 1.96 / 1.48
Foot slide, height test only6.1 / 6.3 / 11.3 / 25.713.5 / 8.2 / 13.9 / 24.6incumbent lower on 3 of 4; the speed-free count does not back the win
Root end error, cm (chase a / chase c / cannon / brawl)105 / 51 / 0.2 / 2.154 / 26 / 0.8 / 8.3challenger closer on the two long runs, incumbent closer on the two short takes
Gate violations (joint-frames), source in brackets0 (0) / 8 (2) / 0 (0) / 0 (0)3 (0) / 6 (2) / 0 (0) / 0 (0)tie overall (9 vs 8); challenger needs the straight-forearm T-pose reference
Wrist twist range vs source, both wrists, all four takeswithin 1.1 degreeswithin 0.5 degreestie

Verdict

No swap. The challenger wins one measure and ties the rest.

Cost of switching: a Blender step with a manual reference pose per skeleton, an FBX export of the baked Action back to Unreal, and a second place to keep in sync with the MetaHuman skeleton. For a 0.4 to 1.4 cm foot-slide gain that does not pay. If foot slide on a specific shot is the problem, run this add-on on that take only. Not tested here: finger and toe retargeting, FBX round trip into UE, takes with the hands planted (the add-on lists hand contact as a known gap), and the add-on at non-default solver settings.


README.md

Source game/sets/README.md. Last git commit 2026-11-13. About 2,077 words.

Sets (CONTENT-PLAN section 1)

Four dressed areas of Stage 7, each placed from a layout file by one script: stage7 (the working stage between takes), midway (chase), beertent (brawl), cannonfield (cannon). Built into the game since the set build ticket (2026-11-13).

Where the action is (45 s takes, commit 3dfe3f1)

The kid's paths come from packaged perfect-bot runs of full5 with -KKPelvisLog (D:\megajam\sets_work\pelvis\), with the samples that stray more than 120 cm from the director build's own keyed path left out (PLAN_TOL): in full5 two takes played a baked clip of another take (see "Shared clip names" below), which put the chase kid at the origin from 33.7 to 38.7 s.

Nothing below 300 cm stands in these boxes (world cm, L_Stage7):

takex fromx toy fromy towhat is there
chase23553555-375342the mirror maze run and the tailgate leap onto the flatbed (the first layout's box; the new action stayed in it)
brawlfrom the paththe kid's and the heavy's reach from 21 s plus the corridor, at least x -290 to 260, y -200 to 150: the rope swing, the uppercut and the bandstand fall
cannon-1411-211-196204the run-in behind the cannon and the crowd wave (the first layout's box)

The bandstand fall lands the kid near (-16, -44) at 31 s. The bandstand is placed by place_fall_target: as close to the landing as the rules allow, the fall itself exempt. The closest legal spot is (-136, 216), its front edge 110 cm behind the landing: the chair section (14 to 22 s) runs the kid through x -150 to -184 right where the bandstand would have to stand to catch him. To land the fall on it, the fall has to carry him about a metre further back (north), or the chair section has to move.

Take props (proposed/take_props.diff, applied)

Run order (laptop, no GUI)

The game patch (proposed/KKGame_settags.patch, applied) drops the other takes' sets by their KK_settake_<take> tag, so set actors no longer carry DIR_<take> and a director rebuild leaves them alone. A walk-through take (walk_<take>) keeps its take's set.

  1. python layout_tool.py all (only after a take changes): layouts, plots, the take diff, the check.
  2. run_ue_py.ps1 -Script C:\Users\owner\NEWBOY\lab\megajam\game\sets\set_build.py -ScriptArgs "--import-only" imports every GLB in meshes.json into /Game/Sets/<home set>/, Nanite on for meshes of 10k triangles and up (TRELLIS props), simple collision removed (the actors are NO_COLLISION too). Then set_slim.py with -ScriptArgs "apply" (the size budget below).
  3. Director builds, as usual (run_director_build.ps1 -Take ...), in any order.
  4. run_ue_py.ps1 -Script ...\set_build.py -ScriptArgs "all" places the sets. Rerun only when a layout changes.
  5. Package as usual.

Options: one or more set names instead of all; --standins places flat boxes for meshes nobody has made (none are left); --front-offset 180; --dry-run; --dir-tag for a game without the settags patch.

Meshes

Checks

Size budget (director, 2026-11-13: zip at or under 840 MB)

set_slim.py report|apply (meshes.json "budget" from layout_tool.py): base colour capped at hero 2048 (cart, gate, flatbed, armored car), dressing 1024, background 512; normal and occlusion/roughness maps at half that; Nanite keeps 100/35/20 % of the triangles; the mesh distance field at 1.0/0.35/0.2 of its default resolution. Every set mesh shares one of two Interchange parents (MI_Default_Opaque, MI_Default_Opaque_DS), so materials cost 0.2 MB in all.

Shared clip names (found here, fixed in director_build.py)

The director's baked clip copies were named <clip>__main<k> with no take in the name, so two takes that use the same clip at the same index overwrote each other's copy: in full5 the chase played the brawl's dust_off_s1 (the kid stood at the origin from 33.7 to 38.7 s) and the cannon replayed its climb at 20 s. They are now <clip>__<take>_main<k>. The old copies in Content/Motion/KimodoAligned are no longer referenced.

Set pass 2 (Fri 2026-11-13)

Batch 19 keepers (D:\megajam\props\batch19), strung lights and bunting, and a crowd, all through the same layout rules.

Crowd extras

Role crowd in the layouts, mesh name KK_CrowdExtra (no mesh: set_build.py spawns BP_Rex_final, the one shared MetaHuman body, face and skeleton; no new MetaHuman). 19 on the midway, 12 in the beer tent, 12 on the cannon field.


results.md

Source game/voice/results.md. Last git commit 2026-11-12. About 1,473 words.

Voice bake-off, tower 1

Takes with WER over 10% dropped. Reels loudness-matched to -20.0 LUFS; the LUFS column is the raw mean of the chosen takes. Aesthetics = mean of Audiobox PQ and CE (1 to 10). Cohesion = mean ECAPA similarity between the chosen takes (1.0 = same voice). Rank score is numbers only and cannot judge accent or character.

Walt

rankdesignenginelines okmean WERLUFSaestheticspitch Hzcohesionscoresounds like, from the numbers
1onyxKokoro6/60.000-22.17.0785.00.757.07deep (85 Hz), natural pace, holds one voice, aesthetics 7.1/10
2onyxChatterbox6/60.000-14.26.92104.00.676.92baritone-range (104 Hz), fast, voice drifts a little, aesthetics 6.9/10
3mentorMaya16/60.000-18.97.17101.00.576.69baritone-range (101 Hz), slow, voice drifts a little, aesthetics 7.2/10
4fenrirKokoro6/60.000-18.76.88141.00.746.4high for him (141 Hz), natural pace, holds one voice, aesthetics 6.9/10
5santaChatterbox6/60.000-15.67.16196.00.745.66high for him (196 Hz), natural pace, holds one voice, aesthetics 7.2/10
6qwenrefChatterbox6/60.000-19.87.01225.00.775.51high for him (225 Hz), natural pace, holds one voice, aesthetics 7.0/10
7santaKokoro6/60.009-21.47.14194.00.725.5high for him (194 Hz), natural pace, holds one voice, aesthetics 7.1/10
8brooklynMaya16/60.000-18.77.2150.00.364.71high for him (150 Hz), natural pace, sounds like different people line to line, aesthetics 7.2/10
9gravelMaya16/60.000-16.77.04226.00.434.22high for him (226 Hz), slow, sounds like different people line to line, aesthetics 7.0/10
10mentorQwen3-TTS6/60.000-21.47.19156.00.314.22high for him (156 Hz), slow, sounds like different people line to line, aesthetics 7.2/10
11mentorVoxCPM26/60.000-22.77.04149.00.34.22high for him (149 Hz), natural pace, sounds like different people line to line, aesthetics 7.0/10
12gravelQwen3-TTS6/60.000-19.86.95254.00.43.95high for him (254 Hz), slow, sounds like different people line to line, aesthetics 7.0/10
13gravelVoxCPM26/60.009-17.26.8180.00.383.54high for him (180 Hz), natural pace, sounds like different people line to line, aesthetics 6.8/10
14brooklynQwen3-TTS6/60.000-21.77.0237.00.253.1high for him (237 Hz), slow, sounds like different people line to line, aesthetics 7.0/10
15brooklynVoxCPM26/60.000-19.36.99246.00.222.91high for him (246 Hz), natural pace, sounds like different people line to line, aesthetics 7.0/10
16s3Dia5/60.012-14.56.17132.00.212.47baritone-range (132 Hz), slow, sounds like different people line to line, aesthetics 6.2/10, only 5 of 6 lines passed the word check
17s2Dia5/60.012-16.75.0979.00.352.26deep (79 Hz), natural pace, sounds like different people line to line, aesthetics 5.1/10, only 5 of 6 lines passed the word check
18s1Dia6/60.000-15.66.1213.00.222.02high for him (213 Hz), natural pace, sounds like different people line to line, aesthetics 6.1/10

Rex

rankdesignenginelines okmean WERLUFSaestheticspitch Hzcohesionscoresounds like, from the numbers
1qwenrefChatterbox4/40.000-18.27.15127.00.697.15baritone-range (127 Hz), natural pace, voice drifts a little, aesthetics 7.2/10
2adamKokoro4/40.000-17.96.87126.00.736.87baritone-range (126 Hz), fast, holds one voice, aesthetics 6.9/10
3michaelKokoro3/40.000-22.87.32122.00.86.32baritone-range (122 Hz), natural pace, holds one voice, aesthetics 7.3/10, only 3 of 4 lines passed the word check
4michaelChatterbox3/40.000-15.57.06132.00.666.0baritone-range (132 Hz), fast, voice drifts a little, aesthetics 7.1/10, only 3 of 4 lines passed the word check
5liamKokoro3/40.000-21.37.0116.00.816.0baritone-range (116 Hz), fast, holds one voice, aesthetics 7.0/10, only 3 of 4 lines passed the word check
6adamChatterbox3/40.000-17.06.83110.00.75.83baritone-range (110 Hz), fast, holds one voice, aesthetics 6.8/10, only 3 of 4 lines passed the word check
7velvetMaya14/40.000-18.96.97105.00.465.83baritone-range (105 Hz), slow, sounds like different people line to line, aesthetics 7.0/10
8velvetQwen3-TTS4/40.000-21.27.17122.00.385.55baritone-range (122 Hz), natural pace, sounds like different people line to line, aesthetics 7.2/10
9matineeMaya14/40.000-18.16.98135.00.395.27baritone-range (135 Hz), slow, sounds like different people line to line, aesthetics 7.0/10
10nervousMaya14/40.000-18.76.6497.00.395.08deep (97 Hz), slow, sounds like different people line to line, aesthetics 6.6/10
11nervousQwen3-TTS4/40.000-21.27.23118.00.224.65baritone-range (118 Hz), natural pace, sounds like different people line to line, aesthetics 7.2/10
12matineeQwen3-TTS3/40.030-23.17.3114.00.333.93baritone-range (114 Hz), natural pace, sounds like different people line to line, aesthetics 7.3/10, only 3 of 4 lines passed the word check
13velvetVoxCPM24/40.000-21.66.51244.00.262.67light (244 Hz), natural pace, sounds like different people line to line, aesthetics 6.5/10
14matineeVoxCPM24/40.000-17.36.64294.00.182.32light (294 Hz), natural pace, sounds like different people line to line, aesthetics 6.6/10
15nervousVoxCPM23/40.000-21.96.94254.00.231.92light (254 Hz), natural pace, sounds like different people line to line, aesthetics 6.9/10, only 3 of 4 lines passed the word check
16s2Dia4/40.000-15.35.37197.00.150.87light (197 Hz), natural pace, sounds like different people line to line, aesthetics 5.4/10
17s1Dia2/40.042-19.54.17137.00.550.73light (137 Hz), slow, voice drifts a little, aesthetics 4.2/10, only 2 of 4 lines passed the word check
18s3Dia3/40.000-16.13.81242.00.34-0.55light (242 Hz), slow, sounds like different people line to line, aesthetics 3.8/10, only 3 of 4 lines passed the word check

fable-editbay.md

Source game/trials/fable-editbay.md. Last git commit 2026-11-12. About 422 words.

Trial: Fable 5.2 builds the edit bay (Thu Nov 12)

Don approved one controlled Fable 5.2 trial (chat, Thu 15:37). Launch after the 4 PM quota reset, never before.

Question

Does Fable 5.2 finish a large, self-contained game feature with fewer turns and fewer fix rounds than Opus 5.5, enough to justify about 2x the price per token?

Arms

Measures (recorded in game/devlog/trials.md)

Brief for arm A (edit bay)

Read first: game/DESIGN.md, game/STORY.md, Source/KidKatapult/Game/KKGame., Source/KidKatapult/CueGate/, game/takes/*.take.json, Scripts/build_editor.ps1, run_cue_tests.ps1, capture_bot.ps1.

Build the edit bay in the KidKatapult UE 5.9 C++ project:

  1. Record each attempt of a take: per-cue grade, timing offset, and which branch played (clean, flub, wreck).
  2. After a take, the edit bay screen lists the sections of that take. For each section the player picks which attempt goes in the film. Bloopers (flubs, wrecks) can go in on purpose. Rex's close-up is an extra angle per section, where the take has one.
  3. The choice is saved as a FinalCut (per scene, per section: attempt id, angle) that the premiere will play later. Keep FinalCut a plain data type with no UI dependency.
  4. Input: controller, touch and keyboard all work (studio rule). About 20 seconds of player time per scene, so keep it to a few choices.
  5. Text the player reads follows lab/WRITING.md (run studio-pipeline/tools/writing/tells.py on it). No em or en dashes.

Checks before hand-in:

Rules: the laptop is the only compiler. Never run the editor beside a render. Never delete a loaded build folder; build into new folders. Commit by explicit paths in lab/megajam with a clear message. Stop and report if blocked; don't widen scope.