Skip to Content
Poly Hammer

Import Animation

Import FBX or NPZ body animation and retarget it onto the FK controls of a MetaHuman control rig.

Read Markdown0.5.2

Import a body animation from an FBX or NPZ file and retarget it onto the FK controls of your control rig. The source skeleton is detected automatically, and the result is a regular Blender Action you can keyframe over.

fk animation import

Import a Body Animation

  1. Select the rig instance and make sure its control rig has been generated.
  2. Open the Animation panel.
  3. Under Body FK Animation, click Import.
  4. Choose an .fbx or .npz file.
  5. Confirm. The file becomes a new source animation with its own retarget settings, and the animation lands on the control rig's FK controls as its own Action.

Select the control rig and enter Pose Mode to play it back.

Each source animation keeps its own retarget settings: turning IK off for one clip never changes another, and a new import starts from the preset chosen in the import dialog. Importing the same file again, or Duplicate in the source list, gives a second source animation, so one clip can be tried with different settings side by side. To use one clip's settings on others, choose Copy Settings To next to the settings' preset menu; to reuse them later, save them as a preset.

Import Options

OptionDefaultEffect
SettingsDefault HumanoidThe preset the new source animation's retarget settings start from.
Source SkeletonAuto DetectForces a source skeleton template instead of detecting it.
Source ConventionAuto DetectReads the file as a plain skeleton, or as a control-rig export, instead of detecting it.
Source Frame Rate30Rate assumed for formats that don't declare one, such as NPZ. Ignored when the file does.
Match Frame RateOnRe-times the source samples onto the current scene frame rate, FPS divided by Base.
Round Sub-framesOnRounds re-timed samples to whole scene frames.
Merge Colliding FramesOffKeys a frame that several re-timed samples land on once, with the last sample, as the source preview shows it, instead of duplicate keys.
Rotation ResamplingLinearHow an FBX file's rotations are sampled between keys: Linear, as before, or Spherical, along the shortest arc. NPZ files are never resampled.
Prefix Instance NameOnPrefixes the Action name with the rig instance name, avoiding collisions between characters.
Prefix Component NameOffPrefixes the Action name with body.

Note

Each Action remembers what it was built from: the control rig, the settings and the source options. When one of them changes (say the control rig was removed and generated again with another rig framework), the Retargeting panel says why the Action is out of date, and Run Retarget or Retarget All Stale builds it again from the source file. Keys edited by hand are never overwritten without asking; Keep Edited Copy keeps them in a copy.

Every option but the two prefixes stays with the source animation and can be changed later in the Source box of the Retargeting panel; Run Retarget then builds the animation again with it. An Action never replaces another: a name already taken gets a numbered suffix.

Note

The scene frame rate includes its Base, so an NTSC scene (29.97, 59.94 or 23.976 fps, Base 1.001) imports a clip of the same NTSC rate one sample per frame. Earlier versions re-timed such clips to the whole-number rate (30, 60 or 24 fps), which drifted by about one frame in a thousand; re-running a source imported earlier in an NTSC scene re-times it to the scene's rate. Scenes whose Base is 1 import exactly as before.

Note

The source's first sample always lands on frame 1, and a re-timed clip's later samples follow at the scene rate. Earlier versions keyed a re-timed clip a fraction of a frame off (0.2 frame early for a 30 fps clip in a 24 fps scene); Migrate Legacy Data retargets such animations again.

Tip

Merge Colliding Frames matters when the scene rate is lower than the clip's, such as a 30 fps clip in a 24 fps scene with Round Sub-frames on: several samples then land on one frame. Without it the Action keeps one key per sample there, and Blender plays one of them; with it the frame holds the last sample, as the source preview shows.

Supported Animation Templates

The source skeleton in your file is matched against these templates automatically:

TemplateTypical source
MetaHumanMetaHuman body animation from Unreal Engine
UE5 Mannequin (Manny/Quinn)Unreal Engine 5 Manny and Quinn
UE4 MannequinUnreal Engine 4 mannequin
MixamoAdobe Mixamo clips
Reallusion Character CreatorCharacter Creator and AccuRig
RokokoRokoko Studio suit capture
XsensXsens suit capture
SOMAGenerated motion from Kimodo on SOMA rig

Note

The addon has its own source skeleton detection algorithm that will choose the right retargeting steps for you if the animation you are importing is supported.

Tip

You can export from the processed full body performance by right-clicking MetaHuman_ControlRig_Simple to export the body track with Export Control Rig FBX instead of baking an animation sequence.

Face Board Animation

The Face Board section of the same panel has its own Import button. You can import your Face Board animations the you exported from MetaHuman Animator in a single click.

metahuman animator face board support

Tip

Check out this video on how to do this.

On this page