# Rig Building

Build a control rig and bind it to the MetaHuman body skeleton imported by Character DNA.

Canonical URL: https://docs.polyhammer.com/blender-addons/character-control-rig/0.5.2/rig-building
Product: character-control-rig
Version: 0.5.2
Channel: production
Updated: 2026-11-21T13:45:20Z
Documentation source: initial main snapshot approved 2026-11-21T13:45:20Z
Documentation commit: 3da85b494e9468a17cd765231fcd260aa6bdfae0
Release tag commit: bd557d6d7d6222effd11e3740111c2debb284802
Owner-approved migration baseline: use current main documentation for the current stable release once; all subsequent releases use their tag snapshots.

The addon builds a control rig for a MetaHuman and binds it to the body skeleton that the
Character DNA addon imported from a `.dna` file. You pose the control rig, and OpenRigLogic
keeps evaluating against the DNA. This make the MetaHuman body deform exactly as it does in Unreal Engine, while giving you an animator friendly rig.

## Supported Rig Frameworks [#supported-rig-frameworks]

| Framework         | Requirement                                | Notes                                                                                                                                                 |
| ----------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rigify**        | Enable it in Blender's addon preferences   | Free and bundled with Blender. Full IK/FK body controls.                                                                                              |
| **Auto Rig Pro**  | Auto Rig Pro **3.78.34+**, enabled         | This is also a popular framework, but it is paid and made by another third party. [get here](https://superhivemarket.com/products/auto-rig-pro).      |

Pick the framework from the **Rig Framework** dropdown in the **Rig Generation** panel
before generating.

Whichever framework you choose, Character DNA remains responsible for the evaluating the MetaHuman face board and the secondary twist, swing, and RBF corrective bones.

## The Two-Phase Workflow [#the-two-phase-workflow]

[Video: two phase](https://docs.polyhammer.com/docs-assets/character-control-rig/3cafbb21566b05a6ab34359058f80bd795d78748abecf2773631524fedabcae3/images/getting-started/two-phase.webm)

Rig generation is split into two steps so you get a chance to adjust the metarig after the bone snapping phase, but before the final control rig is
created.

1. **Generate Metarig** — snaps the framework's editable reference rig to the source
   skeleton. The metarig stays in the scene.
2. *(Optional)* **Adjust the metarig** in Edit Mode.
3. **Generate Control Rig** — generates the final rig from the metarig, constrains it to
   the source skeleton, and removes the metarig.

## Adjusting the Metarig [#adjusting-the-metarig]

Between the two phases you can fix anything the automatic snapping got slightly wrong. This should work perfectly if your head and body meshes match the MetaHuman topology. However, if you have a custom mesh turn of `Snap Bones to Mesh`, then adjust the leaf bones for finger, toe, spine, or jaw placement.

Safe to change in Edit Mode:

- Bone head and tail positions
- Bone lengths and roll

Do not change:

- Bone names — generation resolves bones by name
- Rigify bone parameters or rig types
- The bone hierarchy, or adding and deleting bones

<Callout type="warn" title="Warning">
The metarig is consumed when you click **Generate Control Rig**. To change it
afterwards, remove the control rig and generate again.
</Callout>

## Migrating Legacy Data [#migrating-legacy-data]

When a newer version of the addon changes how control rigs are generated or how animation is retargeted, a file saved
with an earlier version shows a **Migrate Legacy Data** panel at the top of the sidebar, listing each character whose
control rig or imported animations an earlier version made. Until you migrate, **Import FK Animation** and **Run
Retarget** refuse a control rig an earlier version generated.

Click **Migrate Now**, then save the file. For each listed character the migration:

- generates the control rig again from the character's body rig, with the same rig framework and **Snap Bones to
  Mesh** setting, and plays the same Action and NLA strips on it;
- retargets every animation an earlier version imported again, from its source file, keeping a copy of each replaced
  Action as `<name> (before migration)`.

<Callout type="warn" title="Warning">
Changes you made by hand to the old control rig, or to its metarig before generating it, are not kept. An
animation whose source file is missing or changed is left as it was; relink it and run **Run Retarget**.
</Callout>

## Multi-Character Scenes [#multi-character-scenes]

[Video: multi character](https://docs.polyhammer.com/docs-assets/character-control-rig/3cafbb21566b05a6ab34359058f80bd795d78748abecf2773631524fedabcae3/images/rig-building/multi-character.webm)

Every generated object is name-spaced with its rig instance name, so any number of
characters can coexist in one scene:

| Object      | Name                  |
| ----------- | --------------------- |
| Metarig     | `{name}_metarig`      |
| Control rig | `{name}_control_rig`  |

Generation, animation import, export, and removal all act on whichever rig instance is
selected in the **Rig Instances** list, so each character is managed independently.
