Skeletal Meshes

Read a skeletal mesh or skeleton: bones, LODs, materials, sockets, morph targets, physics asset

List bones with parents, optionally under one bone, with reference-pose transforms

Read one bone: local/global reference transform, children, retarget mode, sockets

Add a socket on a bone of a skeletal mesh (mesh-only) or skeleton (shared)

  cfa add_socket --asset-path /Game/Characters/SK_Hero --socket-name WeaponGrip --bone-name hand_r --location '[10,0,0]' --rotation '[0,90,0]'

Rename a socket, move it to another bone, or change its transform

Remove a socket from the mesh or its skeleton

List sockets of a mesh (own + skeleton) or a skeleton

Add a virtual bone from a source bone to a target bone

Remove virtual bones

Set a bone's translation retargeting mode, optionally for its subtree

  cfa set_bone_retarget_mode --asset-path /Game/Characters/SK_Hero_Skeleton --bone-name pelvis --mode AnimationScaled
  cfa set_bone_retarget_mode --asset-path /Game/Characters/SK_Hero_Skeleton --bone-name spine_01 --mode Skeleton --children-too

Add, remove, rename, re-parent or move bones in one committed edit

--ops is a JSON array applied in order, then committed to the mesh and its skeleton once: {"op":"add","bone":"tail_01","parent":"pelvis","location":[0,0,-10],"rotation":[0,0,0]} {"op":"remove","bone":"tail_01","children":true} {"op":"rename","bone":"tail_01","new_name":"tail_base"} {"op":"parent","bone":"tail_01","parent":"spine_01"} {"op":"transform","bone":"tail_01","location":[0,0,-12],"rotation":[0,0,0],"move_children":true} Needs the Modeling Tools plugin (SkeletalMeshModifiers). Animations and physics assets that reference removed bones must be fixed afterwards.

  cfa edit_skeleton --asset-path /Game/Characters/SK_Hero --ops '[{"op":"add","bone":"tail_01","parent":"pelvis","location":[0,0,-10]}]'

Set a LOD's screen size, hysteresis, CPU access, build or reduction settings

  cfa set_skeletal_mesh_lod --asset-path /Game/Characters/SK_Hero --lod 1 --screen-size 0.4
  cfa set_skeletal_mesh_lod --asset-path /Game/Characters/SK_Hero --lod 0 --build-settings '{"BoneInfluenceLimit":4}'

Regenerate generated LODs, optionally to a new count

Remove LODs (never LOD 0)

Assign a material to a slot or rename the slot

Assign a Physics Asset to a mesh after a compatibility check

Add or remove a compatible skeleton

List morph targets with how many vertices each moves

Read a morph target: moved vertices and its largest deltas

Create or edit a morph target from per-vertex deltas and rebuild

Vertex ids are the mesh data's import vertex ids (as get_skin_weights and get_morph_target report), not render vertex indices. Mode replace zeroes every vertex not listed; merge changes only the listed ones.

  cfa set_morph_target --asset-path /Game/Characters/SK_Hero --name Smile --deltas '[{"vertex":120,"delta":[0,0.5,1.2]},{"vertex":121,"delta":[0,0.4,1.0]}]'

Remove a morph target from every LOD and rebuild

Read per-vertex bone influences from the mesh data

Write per-vertex bone influences (normalised) and rebuild

  cfa set_skin_weights --asset-path /Game/Characters/SK_Hero --weights '[{"vertex":120,"influences":{"hand_r":0.7,"lowerarm_r":0.3}}]'

Prune tiny influences, cap the influence count, renormalise, rebuild

Verdict on a LOD's skin weights: no-influence vertices, unnormalised, over limit, bad bones

Generate a Physics Asset from a skeletal mesh's skinned vertices

Runs the same generator as the editor's Create Physics Asset: one body per bone above the minimum size, shapes fitted from the vertices skinned to each bone, constraints between neighbouring bodies. --params takes FPhysAssetCreateParams fields: MinBoneSize (20), GeomType (EFG_Sphyl, EFG_Box, EFG_Sphere, EFG_SingleConvexHull, EFG_MultiConvexHull...), VertWeight (EVW_DominantWeight / EVW_AnyWeight), bBodyForAll, bCreateConstraints, bDisableCollisionsByDefault, bWalkPastSmall, HullCount, MaxHullVerts.

  cfa create_physics_asset --asset-path /Game/Characters/PA_Hero --skeletal-mesh /Game/Characters/SK_Hero
  cfa create_physics_asset --asset-path /Game/Characters/PA_Hero --skeletal-mesh /Game/Characters/SK_Hero --params '{"MinBoneSize":10,"GeomType":"EFG_Box"}'

Read bodies, shapes, constraints and collision pairs of a Physics Asset

Add a body on a bone, fitted from the mesh, with a constraint to its parent body

  cfa add_physics_body --asset-path /Game/Characters/PA_Hero --bone-name spine_02
  cfa add_physics_body --asset-path /Game/Characters/PA_Hero --bone-name hand_r --geom-type box --constraint=false

Remove a body, re-hanging its children's constraints on the next body up

Change a body's physics type, mass scale, or any body setup property

  cfa set_physics_body --asset-path /Game/Characters/PA_Hero --bone-name pelvis --physics-type kinematic
  cfa set_physics_body --asset-path /Game/Characters/PA_Hero --bone-name head --properties '{"DefaultInstance":{"LinearDamping":0.5}}'

Add a sphere, box, capsule or tapered capsule to a body

  cfa add_physics_shape --asset-path /Game/Characters/PA_Hero --bone-name head --type sphere --radius 12 --center '[0,0,8]'
  cfa add_physics_shape --asset-path /Game/Characters/PA_Hero --bone-name hand_r --type box --extents '[10,6,4]' --rotation '[0,0,90]'

Change a shape's placement, size, collision or any field

Remove a shape from a body

Add a constraint between two bodies, frames snapped to the bones

Remove a constraint by name or bone pair

Set swing/twist/linear limits, collision, snap frames, or any constraint field

  cfa set_physics_constraint --asset-path /Game/Characters/PA_Hero --name neck_01 --swing1 limited --swing1-limit 30 --twist locked
  cfa set_physics_constraint --asset-path /Game/Characters/PA_Hero --child-bone hand_r --parent-bone lowerarm_r --properties '{"ProfileInstance":{"bLinearBreakable":true}}'

Enable or disable collision between two bodies

Verdict on a Physics Asset: shapeless bodies, missing bones, colliding overlaps, default frames, mass