ue-mcp-animation

UE-MCP native animation workflow

Create quality animation from measured pose constraints, not guessed control angles. Control names, local axes, palm axes, handedness, and scale are properties of the selected rig. Discover them again for every unfamiliar rig; never paste values from another rig or negate a left-side Euler pose to make a right-side pose.

Focused skeletal mesh weighting

Use the existing skeleton-edit actions for bone creation, removal, reparenting, and reference-pose changes. For a small, explicit skin-weight correction:

1. Call asset(action="list_skeleton_bones", assetPath=<mesh>, includeTransforms=false) and use the returned names exactly.
2. Call asset(action="read_skeletal_mesh_skin_weights", assetPath=<mesh>, lodIndex=0, vertexIndices=[...]). Keep each read to the selected source vertex IDs; the action caps a call at 256 vertices.
3. Call asset(action="set_skeletal_mesh_skin_weights", assetPath=<mesh>, lodIndex=0, edits=[{vertexIndex, influences:[{boneName, weight}]}]) with the complete replacement influence set for every selected vertex. Inspect the returned before and after: Unreal normalizes and prunes the list, and stores source weights as uint16 values. The render buffer may quantize again to 8-bit unless the LOD enables high-precision skin weights.
4. Open the rebuilt mesh with editor(action="open_asset", assetPath=<mesh>) and capture the asset editor at the reference pose and useful preview poses. Re-read the same selected vertices before moving on.

The weight setter edits one existing source LOD and profile, saves only when a selected value changed, and leaves all unlisted vertices, LODs, and profiles alone. It does not infer bones, fit a mesh, or auto-rig a character.

To size a physics body, socket or hit volume from the mesh, call asset(action="read_skeletal_mesh_bone_vertex_bounds", assetPath=<mesh>). Each bone's boneSpace box is its dominant vertices in the bone's own bind-pose frame, the frame a physics body on that bone uses; componentSpace is the same set in the mesh's bind pose. Pass boneNames to limit the report, or minWeight to count a vertex for every bone weighing at least that much.