# Character Assembly Addon

Bring a complete MetaHuman into Blender with its materials, outfit, and simulation-ready hair. Export the character from Unreal Engine, then let Character Assembly put the pieces together.

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

Bring a complete MetaHuman into Blender with its materials, outfit, and simulation-ready hair.
Export the character from Unreal Engine, then let Character Assembly put the pieces together.

[Video: Assembling a complete MetaHuman in Blender](https://docs.polyhammer.com/docs-assets/character-assembly/20394717e939172fa06f7afd81da4a3da899959e9d98df33f97239af33467f49/images/getting-started/assembly.webm)

## Requirements [#requirements]

| Requirement | Details |
| --- | --- |
| **Blender** | 5.2. This release requires at least Blender 5.2 and does not support earlier Blender versions. |
| **Character DNA addon** | Installed and enabled. The [free edition](https://polyhammer.com/character-dna-addon) is sufficient. |
| **Poly Hammer Interchange** | Install the [free Unreal Engine plugin](https://fab.com/s/820c139d9bc5) to export your MetaHuman. The export workflow requires Unreal Engine 5.8 or later. |

## Install the Addon [#install-the-addon]

Create an account on the [Poly Hammer Portal](https://dashboard.portal.polyhammer.com/signup),
then follow the [Blender extensions server instructions](/portal/blender-extension-repo)
to install Character Assembly.

## Import Your Character [#import-your-character]

1. Export your MetaHuman Blueprint using **Poly Hammer Interchange** in Unreal Engine.
2. Keep the exported folder together, including its DNA, grooms, clothing, and textures.
3. Drag **CharacterAssemblyManifest.json** into Blender's 3D Viewport. The import dialog opens.
4. Review the options and confirm the import. You can also use **File > Import > MetaHuman Assembly Manifest (.json)**.
5. Press `N` in the 3D Viewport and open the **Character Assembly** tab. Select your character in **Rig Instances**.

Character DNA imports the head and body. Assembly attaches the grooms and outfit and builds the
skin, eye, teeth, hair, and fabric materials, including facial wrinkle maps driven by OpenRigLogic.
You do not need to write the manifest or import each asset separately.

Outfits use the existing Character DNA body rig and keep their imported skin weights. Their FBX
skeletons and empty objects are removed. Skinned hair with custom weighted bones missing from its
DNA target keeps its own rig; the import report identifies those bones. Vampire's hair uses this
exception, while its body and cape use the DNA body rig directly.

After updating the addon, **Re-apply Manifest** replaces existing outfit components and removes
their old imported rigs and bind helpers.

## Import Options [#import-options]

The defaults provide a starting point for rendering. Adjust these options in the import dialog:

| Option | What it does |
| --- | --- |
| **Hair / Clothing / Materials** | Choose which parts of the assembly to include. |
| **Lighting** | Add the bundled environment lighting. |
| **Camera** | Add a portrait camera and focus object. Available only when the scene has no camera. |
| **Collision Source** | Choose **Body, Head and Outfit** (default), **Body and Head**, or **Head Only** for generated hair collision. |
| **Skin Culling** | Hide skin beneath clothing using editable masks. **Auto Bake + Min** is the default; **Auto Baked** uses clothing coverage alone; **None** keeps skin unmasked. |
| **Apply Scene Settings** | Apply the selected render template to the scene. Currently, the importer offers Cycles. |
| **Apply Render Preferences** | Configure Blender's global Cycles GPU device preferences. Off by default. |

Camera and lighting options are independent of the render settings. After import, adjust the camera
and materials using Blender's usual tools.

<Callout type="info" title="Existing Character DNA rigs">
Update Character DNA, open your saved file, and run its legacy migration operator if it appears
in the 3D Viewport sidebar. Save the migrated file before continuing.
</Callout>

## Next Steps [#next-steps]

- Choose an environment and adjust its appearance — [Lighting](/blender-addons/character-assembly/0.4.3/lighting).
- Simulate hair, bake it, and set custom collision — [Physics](/blender-addons/character-assembly/0.4.3/physics).
