Skip to Content
Poly Hammer

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.

Read Markdown0.4.3

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.

Assembling a complete MetaHuman in Blender

Requirements

RequirementDetails
Blender5.2. This release requires at least Blender 5.2 and does not support earlier Blender versions.
Character DNA addonInstalled and enabled. The free edition is sufficient.
Poly Hammer InterchangeInstall the free Unreal Engine plugin to export your MetaHuman. The export workflow requires Unreal Engine 5.8 or later.

Install the Addon

Create an account on the Poly Hammer Portal, then follow the Blender extensions server instructions to install Character Assembly.

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

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

OptionWhat it does
Hair / Clothing / MaterialsChoose which parts of the assembly to include.
LightingAdd the bundled environment lighting.
CameraAdd a portrait camera and focus object. Available only when the scene has no camera.
Collision SourceChoose Body, Head and Outfit (default), Body and Head, or Head Only for generated hair collision.
Skin CullingHide skin beneath clothing using editable masks. Auto Bake + Min is the default; Auto Baked uses clothing coverage alone; None keeps skin unmasked.
Apply Scene SettingsApply the selected render template to the scene. Currently, the importer offers Cycles.
Apply Render PreferencesConfigure 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.

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.

Next Steps

  • Choose an environment and adjust its appearance — Lighting.
  • Simulate hair, bake it, and set custom collision — Physics.

On this page