# Using Metahumans

This page explains how to add a Metahuman to your Motion project and integrate them into the Motion character blueprint.

### Importing your MetaHuman

To import your MetaHuman, open the `Quixel Bridge` window inside the editor which you can find in the `Window` toolbar menu.

![](/files/haGz92HLXsmzVPWfvwCT)

Select your MetaHuman then download & import it.

![](/files/13igAM8jEu0nprk8mltF)![](/files/iB6DgEhzMT4DJ9cXgSu6)

Make sure to modify your project settings when prompted by confirming dialog boxes that show up upon first importing a MetaHuman into your project and then restart Unreal Engine.

<figure><img src="/files/4NGLekVnjhPxxrmJu8p7" alt=""><figcaption></figcaption></figure>

Once successfully imported, you'll find your MetaHuman, alongside other common assets used by MetaHumans in your project.

<figure><img src="/files/MpNPDkyZMVGl6NOCNBe9" alt=""><figcaption></figcaption></figure>

### Adding the MetaHuman to your Motion Character Blueprint

Alongside the blueprint of the MetaHuman, open your Motion character blueprint.

Select the shown components from your MetaHuman blueprint and hit CTRL + C or right-click "Copy" to copy the components.

![](/files/5rmWDMojhYYI1kDCyJJD)

Then, in the Motion character blueprint, paste them as children of `Mesh`.

Move the components to their respective parents if the copy-paste-process messed up their hierarchy.

<figure><img src="/files/KAzOGpMlvtdIASvywJkL" alt=""><figcaption></figcaption></figure>

Finally, copy the `LODSync` component from the MetaHuman blueprint into your Motion character blueprint.

![](/files/eRyHDNYUd1O8Tw8IML2q)

#### Copy MetaHuman Blueprint Logic

#### Functions

MetaHumans require some setup upon start, so we need to copy that code from the MetaHuman blueprint into the Motion character blueprint.

Copy the following functions from the Metahuman blueprint and paste them in the Motion blueprint.

1. EnableMasterPose
2. ARKit\_Setup

<mark style="color:blue;">The ARKit Setup is optional.</mark>

#### Event Graph

Head to the `Event Graph` of the Motion character blueprint and create a new function and name it `Initialize MetaHuman`.

![](/files/VZTDpzEobuP4iJmtHFgv)

Then, head back to the MetaHuman blueprint, and copy all nodes from it's Event Graph. Paste them into the function.

<figure><img src="/files/8EIpqRDDseqjhz4CmfaB" alt=""><figcaption></figcaption></figure>

Back in the `Event Graph` of the Motion character blueprint, add a call to `Initialize Metahuman` to the `Event Begin Play` sequence.

<figure><img src="/files/KMMFHvZnWjgUAngtzNZd" alt=""><figcaption></figcaption></figure>

#### Construction Script

Open the `Construction Script` of the Motion character blueprint and add these four calls to `Enable Master Pose`.

<figure><img src="/files/crgBgWmhPjOksyCuq2rJ" alt=""><figcaption></figcaption></figure>

Then remove everything else so only these five nodes come right after

<figure><img src="/files/AOYzkZXJ4tqYFXIvewoR" alt=""><figcaption></figcaption></figure>

#### Create Retarget Animation Blueprint

In order for the Metahuman to work with the animations that ship with Motion, a new animation blueprint has to be created.

Head over to the body mesh of your metahuman (e.g. f\_med\_nrw\_body) by clicking on the `Body` component and then clicking the folder-icon to navigate to the mesh.

Right-click the mesh and select `Anim Blueprint`.

<figure><img src="/files/oHaM0B5kCiGjU6yCezJB" alt=""><figcaption></figcaption></figure>

Right-click in the AnimGraph, then search for and create a Retarget Pose from Mesh node. Connect this node to the Output Pose node, as shown below.

![](/files/iRhG4Viy6ta14LaFxQt3)

Click the Retarget Pose from Mesh node to select it. Then, in the Details panel, in the Retargeter Asset dropdown, select the `RTG_Mannequin_Motion` Retarget Asset.

Finally, in the Motion character blueprint, select `Body` and give assign it the animation blueprint you just created.

<figure><img src="/files/a4IHD8X4Xz56Oc3WJaXE" alt=""><figcaption></figcaption></figure>

### Fitting Motion to your Metahuman

Depending on the size and volume of your Metahuman, the default configuration for Motion may lead to unintended and / or undesirable results.

We recommend the following steps:

1. Adjust the Capsule Half Height and Capsule Radius to match the shape of the Capsule Component to your Metahuman.
2. Enable `Owner No See` and `Hidden Shadow` for the following components:

* Face
* Fuzz
* Eyelashes
* Beard
* Mustache
* Hair
* Eyebrows

### Finished!

If everything was set up correctly, launching a session should result in your Metahuman being used as the character with all animations and features applied!

For additional information, please check out the [official documentation](https://docs.metahuman.unrealengine.com/en-US/retargeting-animations-to-a-metahuman-at-runtime/) for retargeting by Epic Games.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://motion.docs.regensturm.com/tutorials/using-metahumans.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
