Skip to main content

Model Rigging and Animation Generation

Perform rigging and/or generate action animations for existing 3D models. Use cases: make existing models movable, add skinning, generate custom animations for humanoid characters ("rig this model", "make the model move", "add running animation to character", "rig and generate animation").

For existing models. To generate animated humanoid characters from scratch, please use Animated 3D Character Generation.

Getting Started​

Start from GUI​

Refer to the beginning section of Generate 3D Models.

Start from CLI​

This feature provides 3 tools, choose according to your needs:

NeedToolModel
Rig only (no animation)generate_rigged_modelUniRig
Already Humanoid, only generate animationgenerate_model_motionHunyuanMotion
Rig + Animation in one stepgenerate_rigged_animated_modelUniRig + HunyuanMotion

Before calling any tool, first read the corresponding generator sub-document (generators/unirig.md / generators/hunyuan-motion.md / generators/rig-and-motion.md) to get complete parameters.

Decision Tree:

What do you want to do with an existing model?
  ├── Rig only (no animation)        → generate_rigged_model (UniRig)
  ├── Already Humanoid, just animations → generate_model_motion (HunyuanMotion)
  └── Rig + Animation in one step      → generate_rigged_animated_model

Tools and Output​

Tool A: generate_rigged_model (Rig Only)​

  • Rig any FBX/GLB/OBJ model to Humanoid skeleton (UniRig AI)
  • Output: rigged_model_path (rigged Humanoid FBX) + prefab_path
  • Time: About 1–3 minutes

Tool B: generate_model_motion (Animation Only)​

  • Generate action animations for already rigged Humanoid models (HunyuanMotion)
  • Output: motion_fbx_path
  • Time: About 1–2 minutes

Tool C: generate_rigged_animated_model (Rig + Animation)​

  • Complete rigging and animation generation in one step
  • Output: rigged_model_path + motion_fbx_path + controller_path (AnimatorController) + prefab_path
  • Time: About 2–5 minutes

Interrupt Recovery​

  • Tool A (Rig Only): Regenerate with same parameters + force_overwrite=true
  • Tool B (Animation Only): Regenerate with same parameters (this tool has no force_overwrite)
  • Tool C (Rig + Animation): If rigging is complete, can directly use generate_model_motion to skip re-rigging; otherwise use force_overwrite=true to rerun the entire process

Notes​

  • ⚠️ For existing models; to generate humanoid characters from scratch, please use Animated 3D Character Generation
  • ⚠️ Read generator sub-documents before calling to get complete parameters
  • ⚠️ Generation time: Tool A about 1–3 minutes, Tool B about 1–2 minutes, Tool C about 2–5 minutes
  • ⚠️ Rigging requires Humanoid skeleton: Animation generation (Tool B) requires model to already be Humanoid
  • ⚠️ Domain Reload: Do not write .cs files to disk during generation, use execute_csharp_script instead