HEAVY_IMPORT.txt
Source game/casting/HEAVY_IMPORT.txt. Last git commit 2026-11-12. About 451 words.
Heavy_v1 import step (staged 2026-11-12, NOT yet imported; do not run while another worker has the laptop editor)
Staged on the laptop: D:\megajam\heavycopy\stage\Heavy_v1 (648 MB, 284 files; the tar is D:\megajam\heavycopy\heavy.tar)
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Heavy_v1 (build folder B1614, Jorge preset, buzz cut, stubble, 192 cm)
Same as Rex_v2 and Rex_final (same package path, so no redirect fixups):
1. With the editor CLOSED, copy the folder:
robocopy D:\megajam\heavycopy\stage\Heavy_v1 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Heavy_v1 /E
2. Open the project, let it load. The blueprint is /Game/KKCast/Heavy_v1/B1614/Heavy_v1/BP_Heavy_v1.
Ignore L_Stills.umap and the SEQ_Heavy_v1_* assets (stills only); delete them to save size if the zip cap needs it.
3. His body skeleton is his own project copy (like Rex_final), so retarget the heavy's clips (the brawl set: haymaker_take,
brawl_beat_a/b/c, chair_swing, fails) onto his body mesh with the same IK retargeter and rebuild the pelvis bake, then point
brawl.take.json's 'followers' actor at BP_Heavy_v1 (it is a scaled BP_Rex_final stand-in now; drop the 1.08 scale and dark tint).
4. Not committed to git (648 MB). Package size: Rex_final is 899 MB in the project, so check the 950 MB zip cap after adding this.
Stills (internal review only, never to an AI model): D:\megajam\review\cast\heavy\
Costume HC1 (1978 work clothes), added 2026-11-12 18:20. NOT yet imported into the game project; the body build above already is (cast 3).
Staged on the laptop: D:\megajam\heavycopy\stage\Heavy_v1\Costume (HC1, Mat, Tex: 21 files, 22 MB, SHA-256 checked against tower 2)
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Heavy_v1\Costume (also holds Geo, the export_geometry body meshes, and the
stills levels L_HeavyCostume, L_HeavyLineup with SEQ_HC1_*; those stay on tower 2, the game needs none of them).
1. With the laptop editor CLOSED (the look pass has it now), copy the folder:
robocopy D:\megajam\heavycopy\stage\Heavy_v1\Costume C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Heavy_v1\Costume /E
Same package paths as on tower 2, so no redirects. It is self-contained: its own master material (M_HeavyCloth, M_HeavyBoot),
MIs and texture copies (the CC0 ambientCG Fabric086 and Leather037 sets, plus the boot, rib, duck and twill maps).
2. Put /Game/KKCast/Heavy_v1/Costume/HC1/SKM_Heavy_Costume1978 on BP_Heavy_v1's outfit component (the "SkeletalMesh" component; it
already follows Body as leader pose) in place of the default tee and shorts, and set every slot's material from the mesh asset
(set_material_by_name per slot, or the outfit keeps the default tee's override materials, as happened to Rex in r1).
Built on his own skeleton (B1614 Common metahuman_base_skel), 342 bones, reference pose matches his body at 0.000 cm.
3. Package size: about 21 MB raw (12.7 MB mesh, 8.3 MB textures). Check the 950 MB zip cap after the next package.
Stills (for Don only, never to an AI model): D:\megajam\review\costume\heavy\
Costume fit fix FX1 (2026-11-12, NOT yet imported): /Game/KKCast/Heavy_v1/Costume/FX1/SKM_Heavy_Costume1978 replaces HC1 on the outfit
component (same slots and materials). Staged at D:\megajam\heavycopy\stage\Heavy_v1\Costume\FX1. Steps: game/casting/COSTUME_FX1_IMPORT.txt.
WALT_IMPORT.txt
Source game/casting/WALT_IMPORT.txt. Last git commit 2026-11-12. About 556 words.
Walt_v3 import step (staged 2026-11-12, NOT yet imported; do not run while another worker has the laptop editor)
Staged on the laptop: D:\megajam\waltcopy\stage\Walt_v3 (654 MB, 305 files; the tar is D:\megajam\waltcopy\walt.tar)
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Walt_v3 (build folder B1658, Walter preset, 178 cm, chest 102 / waist 102 / hip 99)
Folder is Walt_v3, not Walt_v2: /Game/KKCast/Walt_v2 already held the first Walt (bald, dark hair) and a loaded folder is never rebuilt.
Same as Heavy_v1 (same package path, so no redirect fixups):
1. With the editor CLOSED, copy the folder:
robocopy D:\megajam\waltcopy\stage\Walt_v3 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Walt_v3 /E
2. Open the project, let it load. The blueprint is /Game/KKCast/Walt_v3/B1658/Walt_v3/BP_Walt_v3.
Ignore L_Stills.umap and the SEQ_Walt_v3_* assets (stills only); delete them to save size if the zip cap needs it.
3. His body skeleton is his own project copy (like Rex_final and Heavy_v1), so any clips for him must be retargeted onto his body mesh
with the same IK retargeter. The flat cap is a prop and is not modeled.
4. Not committed to git (654 MB). Package size: check the 950 MB zip cap after adding him next to Rex_final (899 MB) and Heavy_v1 (about 650 MB).
Look: Hair_S_BaldingStubble (receding top, short sides and back), grey on all strands, Mustache_S_Full, no beard, Eyebrows_M_Messy, grey.
Not checked by eye (stills must not go to an AI model); the director reviews the stills.
Stills (internal review only, never to an AI model): D:\megajam\review\cast\walt\
Costume WC1 (1978 director on set), added 2026-11-12 18:40. NOT yet imported into the game project; the body build above already is (cast 3).
Staged on the laptop: D:\megajam\waltcopy\stage\Walt_v3\Costume (WC1, Mat, Tex: 28 files, 22 MB; tar D:\megajam\waltcopy\walt_costume.tar,
SHA-256 list D:\megajam\waltcopy\walt_costume_sha256.txt, all 28 checked against tower 2)
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Walt_v3\Costume (also holds Geo, the export_geometry body meshes, and the stills levels
L_WaltCostume, L_WaltLineupRex, L_WaltLineupHeavy with SEQ_WC1_*; those stay on tower 2, the game needs none of them).
1. With the laptop editor CLOSED, copy the folder:
robocopy D:\megajam\waltcopy\stage\Walt_v3\Costume C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Walt_v3\Costume /E
Same package paths as on tower 2, so no redirects. Self-contained: its own masters (M_WaltCloth, M_WaltBoot), MIs and texture copies
(CC0 ambientCG Fabric086 and Leather037, plus the boot, wale, tweed and twill maps).
2. Clothes: put /Game/KKCast/Walt_v3/Costume/WC1/SKM_Walt_Costume1978 on BP_Walt_v3's outfit component (the "SkeletalMesh" component; it
follows Body as leader pose) in place of the default outfit, and set every slot's material from the mesh asset (set_material_by_name
per slot, or the default outfit's override materials stay). Built on his own skeleton (B1658 Common metahuman_base_skel), 342 bones,
reference pose matches his body at 0.000 cm. 11 slots.
3. Cap: /Game/KKCast/Walt_v3/Costume/WC1/SM_Walt_FlatCap is a static mesh already in the head bone's frame. Add a StaticMeshComponent
(or a StaticMeshActor) with it, set Mobility to Movable (a Static one will not attach), and attach it to the Body component at socket
"head" with SNAP_TO_TARGET and zero relative transform. Checked on tower 2: cap centre lands 0.00 cm from where it was fitted.
It casts shadows. Material slot MAT_Tweed -> MI_WC1_Tweed (already set on the asset).
4. Package size: about 22 MB raw. Check the 950 MB zip cap after the next package.
Stills (for Don only, never to an AI model): D:\megajam\review\costume\walt\
Costume fit fix FX1 (2026-11-12, NOT yet imported): /Game/KKCast/Walt_v3/Costume/FX1/SKM_Walt_Costume1978 replaces WC1's costume mesh on
the outfit component (same slots and materials; the cap stays WC1/SM_Walt_FlatCap). Staged at D:\megajam\waltcopy\stage\Walt_v3\Costume\FX1.
Steps: game/casting/COSTUME_FX1_IMPORT.txt.
COSTUME_FX1_IMPORT.txt
Source game/casting/COSTUME_FX1_IMPORT.txt. Last git commit 2026-11-12. About 510 words.
Costume fit fix FX1 import step (staged 2026-11-12, NOT yet imported; do not run while another worker has the laptop editor)
One fit pass shared by all three costumes: Rex_final's C10c, the heavy's HC1 and Walt's WC1. Built on tower 2 by
game/costume/bl_70_fit.py, bl_71_fitfix.py and bl_72_fixes.py, imported by fx1_05_import.py. Numbers: game/devlog/notes.md (FX1 entry).
What changed in each mesh: the boots' forefoot moved out past the foot, the jacket and shirt weights (layers tied, shirt follows the
jacket, armpit folds smoothed), sleeve clearance where the elbow came through, the heavy's loose tee forearm piece deleted, Rex's boot
welded. Same slots, same skeleton, reference pose matches the old costume at 0.0000 cm (342 bones), same UV and colour layers.
Staged on the laptop (one .uasset each, checked against tower 2 by SHA-256; tars and hash lists in D:\megajam\fx1copy\<char>\):
Rex: D:\megajam\rexcopy\stage\Rex_final\CostumeV2\FX1\SKM_Rex_Costume1978.uasset
Heavy: D:\megajam\heavycopy\stage\Heavy_v1\Costume\FX1\SKM_Heavy_Costume1978.uasset
Walt: D:\megajam\waltcopy\stage\Walt_v3\Costume\FX1\SKM_Walt_Costume1978.uasset
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Rex_final\CostumeV2\FX1, ...\Heavy_v1\Costume\FX1, ...\Walt_v3\Costume\FX1.
The stills levels (FX1_Stills folders) stay on tower 2; the game needs none of them.
1. With the laptop editor CLOSED, copy each folder to the same package path (no redirects needed):
robocopy D:\megajam\rexcopy\stage\Rex_final\CostumeV2\FX1 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Rex_final\CostumeV2\FX1 /E
robocopy D:\megajam\heavycopy\stage\Heavy_v1\Costume\FX1 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Heavy_v1\Costume\FX1 /E
robocopy D:\megajam\waltcopy\stage\Walt_v3\Costume\FX1 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Walt_v3\Costume\FX1 /E
2. Each FX1 mesh holds no materials of its own: every slot points at the material instance the old costume uses on the slot of the
same name, so the folders under "Needs" below must be in the project. The heavy's are (Heavy_v1\Costume\Mat and Tex). Walt's come
with the WC1 section of WALT_IMPORT.txt (Walt_v3\Costume). Rex's laptop copy of CostumeV2 stops at C8, so his staged copy also holds
C10's boot material, its master and its texture (Mat\MI_V6b_Boot70s, Mat\M_BootV6b, Tex6\T_Boot70s_B_Color_b) and eight textures
under Rex_v2\Costume\Tex that his V4 material instances read (the project deleted Rex_v2, so they are missing there today, for C8
too). Copy those add only, so the project's existing files stay as they are:
robocopy D:\megajam\rexcopy\stage\Rex_final\CostumeV2 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Rex_final\CostumeV2 /E /XC /XN /XO
robocopy D:\megajam\rexcopy\stage\Rex_v2 C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\Rex_v2 /E /XC /XN /XO
The project's MI_V4_* are copies from before C9; tower 2's may have changed since. If Rex reads differently from the tower 2 stills,
compare CostumeV2\Mat with tower 2.
3. Swap the outfit: on BP_Rex_final, BP_Heavy_v1 and BP_Walt_v3, put FX1/SKM_*_Costume1978 on the outfit component (the "SkeletalMesh"
component, leader pose on Body) in place of C10c, HC1 or WC1, and set every slot's material from the mesh asset (set_material_by_name
per slot). Walt's cap is unchanged: WC1/SM_Walt_FlatCap on the Body's "head" socket.
4. C10c, HC1 and WC1 stay in the project as the fallback; delete the one you replaced only after a packaged check.
5. Package size: the three meshes are 19.1, 12.4 and 12.4 MB raw, about the size of the meshes they replace.
Stills (for Don only, never to an AI model): D:\megajam\review\costume\fix1\
Needs (package folders each FX1 mesh depends on, from fx1_09_deps.py):
Rex: Rex_final\B1139 (skeleton, body), Rex_final\CostumeV2\Mat (MI_V4_Belt, Buckle, Button, ChestSkin, Denim, JacketLeather,
ShirtCream, M_CostumeV4; MI_V6b_Boot70s, M_BootV6b), CostumeV2\Tex4\T_Twill_N, CostumeV2\Tex6\T_Boot70s_B_Color_b,
Rex_v2\Costume\Tex (T_Fabric084 Color and Rough, T_Fabric086 Color, Normal and Rough, T_Leather037 Color, Normal and Rough)
Heavy: Heavy_v1\B1614 (skeleton, clothing), Heavy_v1\Costume\Mat, Heavy_v1\Costume\Tex
Walt: Walt_v3\B1658 (skeleton, clothing), Walt_v3\Costume\Mat, Walt_v3\Costume\Tex
EXTRAS_IMPORT.txt
Source game/casting/EXTRAS_IMPORT.txt. Last git commit 2026-11-13. About 1,048 words.
Crowd faces: three extra faces for the 43 crowd extras (BACKLOG "crowd faces"). Built Fri 2026-11-13 03:06 to 03:36 on tower 2. NOT yet imported.
Staged on the laptop: D:\megajam\extrascopy\stage (Extra_A, Extra_B, Extra_C; 311 files, 332 MB raw; SHA-256 list D:\megajam\extrascopy\extras_sha256.txt, all 311 checked)
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\Extra_A, _B, _C (the stage holds only each BP's dependency closure; the character assets and older builds stay on tower 2).
Cooked size estimate: 39 MB total for all three (budget 40). Textures are already capped inside the assets (max_texture_size 256 for each face, 128 for the shared Common set), so the cast3_texcap rules are not needed for these. Hair is estimated at 0.21 of its editor size (the cast 3 rate); the real number comes from the next package.
THE FACES (preset names are Epic's; ages and looks come from the preset library, not from frames: MetaHuman stills never go to a model)
Extra_A preset Sook-ja, a woman, East Asian, older. Hair_S_Pixie. BP /Game/KKCast/Extra_A/B0311/Extra_A/BP_Extra_A
Extra_B preset Omari, a Black man, middle-aged. Hair_S_CurlyFade, Mustache_S_Horseshoe. BP /Game/KKCast/Extra_B/B0333/Extra_B/BP_Extra_B
Extra_C preset Cameron, a younger white man. Hair_S_Clean. BP /Game/KKCast/Extra_C/B0331/Extra_C/BP_Extra_C
None is a preset Rex (Bruce/Victor), Walt (Walter) or the heavy (Jorge) uses. All built at quality LOW: the face has 2 LODs (Rex has 4); the body is not used.
LOW builds carry no eyebrow, eyelash, fuzz or beard grooms (those components are empty). At 8 m a brow is a pixel or two.
Extra_B and Extra_C were built into Extra_A's Common folder (one shared rig and eye/teeth set, the MetaHuman default). Extra_A/B0311/Common must be copied with them (the stage has it).
HOW EACH BP WORKS (checked by spawning it on tower 2 and reading the components; level not saved, editor untouched)
Each BP_Extra_X is a normal MetaHuman BP with its Body component pointed at Rex_final's body mesh (SKM_Rex_final_BodyMesh, Rex's skeleton)
and its outfit component at Rex's FX1 costume (SKM_Rex_Costume1978). So the crowd's retargeted loops in /Game/Motion/Kimodo play on it unchanged,
and the Extra's own body, body textures and outfit are not in the package. The default-garment material overrides were cleared on the outfit component.
The BPs reference Rex_final assets by their usual paths, which exist on the laptop.
Not seen in motion: the Face follows the Body through the MetaHuman ABP_Face by bone name; the head sockets agree at rest. The first laptop run should
check one extra playing cheer_arms_up (the head should stay on the neck; if the face floats, tell tower 2).
Skin tone: the face is the preset's, the neck, hands and forearms are Rex's body texture. At 8 m or more under a costume that is a small mismatch;
a body tint on the extra's Body material (a flat MI like the outfit ones) is the fix if a shot shows it.
IMPORT (laptop editor CLOSED)
robocopy D:\megajam\extrascopy\stage C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast /E
Same package paths as tower 2, so no redirects. The Face_ControlBoard_CtrlRig "Cannot break link" message, if it shows, is Epic's and harmless.
HOW THE SET BUILDER SHOULD ASSIGN FACES (set_build.py, place_crowd)
Spawn the face's BP in place of BP_Rex_final (CROWD_FACES = the three BP paths above, index stored as c["face"] in the layout's crowd dict); everything else in
place_crowd stays as is (tags, hat, outfit colours, clip with override_animation_data, scale, yaw).
1. Walk each set's extras in a fixed order (sorted by id). Give each the face that (a) differs from every already-placed extra within 3 m in plan view
(that is "side by side": 2 m is shoulder to shoulder, 3 m adds a margin) and (b) has the lowest count so far in that set, ties broken by a fixed seed.
With three faces this works for crowds as thin as these; if all three are within 3 m of a spot, take the face whose nearest same-face extra is farthest.
2. Result: about a third each in every set (midway 19 = 7/6/6, beer tent 12 = 4/4/4, cannon field 12 = 4/4/4), none repeating beside itself, and Rex's face
in no crowd extra any more. Write the choice into the layout json so a rebuild gives the same crowd.
3. Hats: keep the rule (a hat hides the Hair groom). Extra_B's moustache is its own Mustache component and stays visible under a hat.
The "beard" key means nothing for these three (no stubble variant); ignore it.
4. Keep the 8 m minimum camera distance as the floor (the faces are LOW). The "brimmed hat within 16 m" rule was for Rex's face; relax it only after someone has looked at a stills pass.
5. Package size: add about 39 MB (estimate) to the zip and check the 950 MB cap.
IMPORTED Fri 2026-11-13 09:13 on the laptop (brawl ticket 4, editor-cmd only): robocopy of the stage into Content/KKCast, 311 files, SHA-256 matched against extras_sha256.txt (0 bad, 0 missing). Content/KKCast is untracked, so it travels in the KKCast tar to tower 1 backups.
NECK AND HAND TINT DONE the same morning (KidKatapult/Scripts/extras_tint_export.py and extras_tint_apply.py, numbers in takes/brawl3/export_ticket4/extras_tint_numbers.json): each extra has MI_ExtraBody_X (child of Rex's MI_Body_Baked) under its own Body/Materials folder,
with "Basecolor Global Multiply Post-Bake" set to face skin colour over Rex body skin colour per channel in linear light (median of the baked colour textures, numbers only, nobody looked at the textures). The BP's Body component carries the MI as its material, so a spawned BP_Extra_X has it with no set_build change (re-checked in a fresh session).
Multipliers (linear RGB): A 1.383 1.456 1.481 (face sRGB median 176 117 92, Rex body 152 98 76); B 0.546 0.420 0.510 (115 64 54 over the lit part; raw median 79 47 37); C 0.546 0.407 0.566.
CHECK FOR TOWER 2: Extra_C (preset Cameron, described above as a younger white man) has a baked face colour as dark as Extra_B's (median sRGB 74 44 35 over the whole map, 98 percent of pixels under luminance 70; Extra_A is 178 123 93). The face MI has no overrides, so the map is the whole tone.
Either the preset is darker than the note says or the LOD5to7 bake came out dark; look at C's face once in the editor (Don only, no MetaHuman frame goes to a model). The tint follows the face either way, so rerun extras_tint_export.py, tint_numbers and extras_tint_apply.py if the face is rebuilt.
LIPSYNC_IMPORT.txt
Source game/casting/LIPSYNC_IMPORT.txt. Last git commit 2026-11-13. About 1,545 words.
Lip sync face anims for the cast's voice lines (made 2026-11-12 on tower 2, NOT yet imported into the game project; do not import while another worker has the laptop editor)
What: 39 AnimSequences, one per voice line, solved from the wav by MetaHuman Animator's audio-driven solve (method in prep/LIPSYNC.md), neutral mood 0.7, head movement off, FULL_FACE curves (CTRL_expressions_*).
walt: 30 on Walt_v3's own face mesh (SKM_Walt_v3_FaceMesh): the 27 manifest lines l01..l20 and x01..x07, plus l12a, l12b and l12short (not in the manifest, but brawl.take.json plays l12short).
rex: 9 on Rex_final's face mesh (SKM_Rex_final_FaceMesh): l01..l06, x01..x03.
Named walt_<id> and rex_<id>, the same stem as the wav (walt_l05 goes with walt_l05.wav).
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\LipSync\{walt,rex} (/Game/KKCast/LipSync/<character>/<line id>)
Staged on the laptop: D:\megajam\lipsync\stage\LipSync\{walt,rex} (45 MB, 39 uasset, SHA-256 matched against tower 2), numbers in D:\megajam\lipsync\stage\lipsync_check.json
Check (game/casting/ls_check.py): every anim is within 20 ms of its wav (limit 50). Jaw-open curve vs the wav's RMS envelope: r at zero lag walt mean 0.52, rex mean 0.47, range 0.16 to 0.94;
best lag is usually 20 to 60 ms early (the mouth leads the sound, as in life), r at best lag mostly 0.5 to 0.6. Weakest: walt_l05 0.16, walt_l01 0.19, walt_l16 0.22, walt_l17 0.23 (shouted, pause-heavy lines;
the jaw is shut on loud m/b sounds, so r is only a sanity check, see LIPSYNC.md). Judge sync by eye in the editor.
Not judged by eye (no MetaHuman frame goes to an AI model). The director should watch a few in the lineup level.
Import (same package paths as on tower 2, so no redirects):
1. Laptop editor CLOSED: robocopy D:\megajam\lipsync\stage\LipSync C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\LipSync /E
2. The anims target each face's skeleton (Face_Archetype_Skeleton in the character's own B1658 or B1139 Common/Face folder), which the laptop already holds with Walt_v3 and Rex_final. Import after those two are in.
3. Package size about 45 MB raw; check the 950 MB zip cap.
How the game should play a face anim with the voice line (PROPOSAL, game/KidKatapult not edited):
The take JSON already has "lines": [{"t", "speaker", "audio", "text"}], and prep/scripts/director/director_build.py (line ~1379) already reads an optional "face_anim" per line and plays it on the speaker.
Two things stop it working for these assets as it stands:
a. It puts the anim on actors[speaker]'s anim_comps entry, which is the Body component ("Body"). A face anim has to go on the blueprint's Face component (a different skeleton), so the track lands on nothing useful.
b. In the three takes "speaker" is "kid" on every line, including Walt's. Walt speaks as actor "walt" (BP_Walt_v3), Rex as "kid" (BP_Rex_final).
Proposed fields (all optional, nothing breaks without them):
line.face_anim asset path of the AnimSequence, e.g. "/Game/KKCast/LipSync/walt/walt_l05". Or just "lipsync": true and the builder derives /Game/KKCast/LipSync/<char>/<wav stem>, where <char> is the wav stem before the underscore.
line.face_actor take actor name whose Face plays it. Default: speaker. Set it to "walt" on Walt's lines until the speaker names are corrected. (Fixing speaker to "walt" is cleaner; check nothing else reads speaker first.)
actor.face_component component name of the blueprint's face mesh, default "Face" (MetaHuman blueprints name it Face; the builder already logs the skeletal component names at spawn).
Builder change: in the actor loop keep a second dict face_comps[name] = the component named face_component; for each line with a face anim add a MovieSceneSkeletalAnimationTrack on that component's possessable (parented to the actor like the body one),
section start = line t (+ line "delay" in flub branches, same as the wav), length = the anim's length, play rate 1, ease 0. Start it at the same time as the audio section so wav and curves share the clock; the anims are
exact to the wav (within 20 ms) and begin at wav time 0, so no offset is needed. If a line's audio is cut with "len" or started with an offset, give the anim the same start_frame_offset.
Flub branches and resets that replay a line need the same section as the audio entry. For slomo, the face section gets the same play rate as the audio.
Gotchas:
- Sequencer plays face curves only if the Face component's anim mode lets the sequence drive it (the humanlab method: skeletal animation track on the Face component binding). Check once in the lineup level before wiring all takes.
- Walt is a play-view extra standing off to the side; his face may be too small to read at play distance. Rex's face is the premiere close-up. Prioritise Rex and the cut scenes.
- Eyes and blinks are not in the solve (eyeLook curves are empty); add them as in humanlab eyes.py if a close-up needs them.
Scripts: game/casting/ls_solve.py (runs in the editor), ls_run.py (header and ssh/MCP wrapper), ls_check.py (the numbers).
ADDITION 2026-11-12 (second batch): 21 anims for the walk-through lines (commit 1314614), same method, same settings, same 150 ms pad and trim.
walt: 18 on Walt_v3's face mesh: walt_w01..w12 (walk lines) and walt_c01..c06 (calls). rex: 3 on Rex_final's face mesh: rex_w01..w03.
Eye blinks and saccades are baked in (game/casting/ls_eyes_new.py, the same code as ls_eyes.py part 1, limited to the new names; EL_walt and EL_rex are untouched).
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\LipSync\{walt,rex} (now 48 walt, 12 rex). Tower 2's editor was left on L_HeavyLineup, as found.
Staged on the laptop: D:\megajam\lipsync\stage2\LipSync\{walt,rex} (32 MB, 21 uasset, SHA-256 matched against tower 2), numbers in D:\megajam\lipsync\stage2\lipsync_check2.json
Check (ls_check.py): all 21 within 17 ms of the wav (limit 50). Jaw-open vs wav RMS envelope r at zero lag: walt mean 0.55, rex mean 0.48, range 0.23 to 0.97;
r at best lag 0.28 to 0.98 (best lag 20 to 80 ms early). Longest walk lines are the weakest (walt_w01 0.25, walt_w04 0.26, rex_w01 0.23, walt_w03 0.32, walt_w02 0.33); the short calls are strong (walt_c02 0.97, c04 0.92, c05 0.89).
Import: after the first batch, same robocopy with the stage2 path (a merge, no file overlaps):
robocopy D:\megajam\lipsync\stage2\LipSync C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\LipSync /E (laptop editor CLOSED)
The walk takes (walk_chase, walk_brawl, walk_cannon) still need face_anim or "lipsync": true on these lines, as in the first batch. Not judged by eye.
ADDITION 2026-11-12 (third batch): 15 anims for the between-scene beat lines (commit 5ab495b, list in game/takes/BEATS.md), same method, settings, 150 ms pad and trim.
walt: 12 on Walt_v3's face mesh: walt_b01..b12. rex: 3 on Rex_final's face mesh: rex_b01..b03. Written to /Game/KKCast/LipSync/{walt,rex}/.
Blinks and saccades baked in (game/casting/ls_eyes_new.py, now matching *_b## only; the walk-through batch used the same file with _w## and _c##).
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\LipSync\{walt,rex} (now 60 walt, 15 rex). Tower 2's editor was left on L_HeavyLineup, as found.
Staged on the laptop: D:\megajam\lipsync\stage3\LipSync\{walt,rex} (26 MB, 15 uasset, SHA-256 matched against tower 2, hashes in stage3\SHA256.txt), numbers in D:\megajam\lipsync\stage3\lipsync_check3.json
Check (ls_check.py): all 15 within 17 ms of the wav (limit 50). Jaw-open vs wav RMS envelope r at zero lag: walt mean 0.45, rex mean 0.29, range 0.20 to 0.70;
r at best lag 0.29 to 0.77 (best lag 20 to 80 ms early). Weakest at zero lag: walt_b10 0.20, rex_b01 0.20, walt_b06 0.29, rex_b03 0.29 (rex_b01 and walt_b10 reach 0.35 and 0.48 at best lag). Strongest: walt_b08 0.70, walt_b04 0.63.
Rex's three lines are weaker than the earlier batches (mean 0.29 against 0.47 and 0.48); judge by eye in the lineup level before wiring.
Import (laptop editor CLOSED, after the first two batches; a merge, no file overlaps):
robocopy D:\megajam\lipsync\stage3\LipSync C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\LipSync /E
The beat takes (beat_1..beat_3) still need face_anim or "lipsync": true on these lines. Not judged by eye.
ADDITION 2026-11-13 (fourth batch): 3 anims for the story-fix voice lines (voice commit 01bf1d6): walt_w12 RE-RECORDED ("land flat on your back", REPLACES the old walt_w12 from the second batch), plus new walt_c07 and walt_c08. Same method, settings, 150 ms pad and trim.
All on Walt_v3's face mesh, written to /Game/KKCast/LipSync/walt/. Blinks and saccades baked in (game/casting/ls_eyes_new.py, now matching walt_w12, walt_c07 and walt_c08 only; walt_w12's solve already drove the blink curve, so its blinks are the solver's, as the script's skip rule does for any driven curve).
Source of truth: tower 2, G:\kk\KKCast\Content\KKCast\LipSync\walt (now 62 walt, 15 rex). Tower 2's editor was left on L_HeavyLineup, as found. The old walt_w12 inputs are backed up on tower 2 in G:\lipsync\mj\_bak_w12.
Staged on the laptop: D:\megajam\lipsync\stage4\LipSync\walt (3 uasset, SHA-256 matched against tower 2, hashes in stage4\SHA256.txt), numbers in D:\megajam\lipsync\stage4\lipsync_check4.json
Check (ls_check.py): all 3 within 10 ms of the wav (limit 50): walt_w12 -10.0 ms, walt_c07 +10.0 ms, walt_c08 -3.3 ms. Jaw-open vs wav RMS envelope r at zero lag: walt_c07 0.63, walt_w12 0.60, walt_c08 0.53 (mean 0.59);
r at best lag 0.64 to 0.70 (best lag 30 to 50 ms early). Not judged by eye.
Import (laptop editor CLOSED, after the first three batches). This one OVERWRITES the old walt_w12.uasset, so use the same robocopy (it replaces the changed file) and drop the stale copy first if the project is under source control:
robocopy D:\megajam\lipsync\stage4\LipSync C:\Users\owner\NEWBOY\lab\megajam\game\KidKatapult\Content\KKCast\LipSync /E
The takes need face_anim or "lipsync": true on the new lines as before. Not judged by eye.
IMPORTED Fri 2026-11-13 09:12 on the laptop (brawl ticket 4): all four stages (stage, stage2, stage3, stage4) robocopied into Content/KKCast/LipSync in order; walt 62 and rex 15 uassets, matching tower 2. walt_w12 is the re-recorded stage4 one (SHA-256 checked against the stage4 file; the other 77 match their stage files). Not wired into any take.