القائمة
Use when a creature's locomotion or mounted-rider animation looks wrong (pace/float/walk-in-place/idle) and needs refining or authoring in Blender before Kit-compile.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Root-cause native Bannerlord CTDs (AccessViolation in TaleWorlds.Native.dll) via Event Log offsets, offline disassembly, and live debugger forensics. No symbols needed.
Dispatch an independent Codex verification job directly via `codex exec` Bash call, then retrieve and present results
Inspect all changed files, group by logical concern, and guide atomic per-concern commits following TAOM's 50/72 rule and commit trailer convention.
Load a snapshot saved by /context-save and present it so this session can pick up where the last one left off without re-deriving decisions.
Launch parallel deep-dive agents to review completed work for quality, standards, compatibility, completeness, and cross-system data flow
Respond to a Bannerlord engine update (Steam force-bump or deliberate migration) — preserve the decompile baseline, regen, diff, re-verify bindings and creature data, control-battle.
| name | refine-creature-anim |
| description | Use when a creature's locomotion or mounted-rider animation looks wrong (pace/float/walk-in-place/idle) and needs refining or authoring in Blender before Kit-compile. |
Thin entry point. The authoritative workflow, theory, toolkit, and lessons live in
docs/ai-includes/creature-animation-blender-mcp-workflow.md — READ IT FIRST.
NOT for the data/XML/C# side of a mount (that is /new-creature-mount), and NOT for Kit-compile or in-game testing (GUI-only, out of scope — the hand-off target).
Live Blender 5.1.2 session with Blender-MCP connected, plus the toolkit on the E: drive
(E:\LOTRAOMAssets\Elephant\_refine_tools\harness.py, tpac_clipinfo.py, _spider_refine\spider_cfg.py).
If Blender-MCP is down or the harness is missing, STOP and report — do not self-heal.
tpac_clipinfo.py on the deployed _anm.tpac → recover per-clip frame ranges.temp_override; confirm bone names match the target rig 1:1.extract_clip(src,f0,f1,name) → retimed in-place clip; snapshot a _SRC copy.analyze_gait → quantify defects (lift asymmetry, swing-phase order, stance slip, bob, loop seam).phase_shift_bones
(re-phase a gait), damp_leg_lift (tame over-lift), timescale_action (cadence), reverse_action
(walk_backwards), freeze_toward_rest (walk→idle). Loop: render_frame → montage → READ the PNG + re-analyze_gait.export_clip_fbx → armature-only, primary_bone_axis=Y, forward=-Y, up=Z, no leaf bones, baked,
take = scene name, armature renamed <skel>_notused; round-trip verify by re-import./new-creature-mount for Kit-compile (tag quad_movement + step points on MOVEMENT clips) + in-game test._anm/_geo tpac — refinement is constant, the swap is where it breaks)Back up the old tpac first (*.backup), then after deploying the new one, BEFORE battle-testing:
python tools/verify_mount_assets.py <spider|elephant>
It catches the three silent regressions a Kit re-export causes — dropped <creature>_skeleton
resource (mesh-only re-export → CreateAgentSkeleton null → RIDERLESS mount, NO crash),
dropped quad_movement on a measured-gait clip (TickAnimations AV), and orphaned bindings.
PASS is necessary, not sufficient — it can't see the mesh bone-palette split or in-game behaviour,
so still do an in-game spawn-with-rider check. Full requirements + the four failure modes:
creature-mount-authoring.md → "REPLACING
FBX / TPAC FILES". Lesson: feedback-mesh-reexport-drops-skeleton-resource (spider rework
2026-06-13 shipped mesh-only → riderless until caught).
For rider clips use the composite method (master §4a): parent rider human_skeleton to the mount's sit
bone, verify fit with the meshed orc_rider.fbx, re-pose per clip, export rider_<mount>_*, bind an as_human_warrior partial.
quad_movement is MANDATORY on movement clips or the game AVs at Skeleton.TickAnimations
(mission-only). This skill produces FBX; the tag is applied at Kit-compile — never ship an untagged
gait. Byte-graft recipe in spider.md How-to.analyze_gait → rootY_net ≈ 0);
the engine supplies translation. Baked root motion double-speeds + slides.Action.fcurves is GONE; author via pose_bone.keyframe_insert.
FBX import/export needs bpy.context.temp_override(window, area=VIEW_3D, region=WINDOW).damp_leg_lift) or the stance foot floats.
Re-phasing (phase_shift_bones) is float-safe.Spine1_M, spider chest_m, elephant Spine1_05, horse horsespine2.