> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/set-up-a-reallusion-cc-character.md).

# Set up a Reallusion (CC) character

This guide covers the full flow for connecting a Reallusion Character Creator 5 (CC5) avatar to the Convai Unreal Engine plugin.

{% embed url="<https://www.youtube.com/watch?v=nyPNP-S92QI>" %}
Set up a Reallusion character walkthrough
{% endembed %}

### Prerequisites

* Reallusion Character Creator 5 is installed.
* The Convai plugin is installed and your API key is configured — see [Install the Convai plugin](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/install-the-convai-plugin.md) and [Configure your API key](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/configure-your-api-key.md).
* You have a Convai character ID from the dashboard.

### Prepare the animation in Character Creator 5

{% stepper %}
{% step %}

#### Load your character

Open Character Creator 5. Navigate to **Project > Templates > CC Project** and select the character you want to use. Alternatively, load an existing CC project.
{% endstep %}

{% step %}

#### Add an idle animation

Click **Animation** and locate an idle animation. A subtle idle (such as `idle03`) works well. Drag it onto the avatar to apply it. Verify that the animation plays on the avatar.
{% endstep %}

{% step %}

#### Add the animation to the Perform List

Right-click on the animation in the animation panel and select **Find File**. This opens the animation's directory in your file system. Right-click the animation file and copy its path.

Go to **Motion > Perform > Perform List Editor**. Click **Add**, paste the path, select the animation, and click **Open**.
{% endstep %}

{% step %}

#### Add a talking animation (optional)

Optionally, add a standing-and-talking animation that does not include lip sync — the plugin handles lip sync separately. Repeat the Find File and Perform List steps for the talking animation. Choose animations where the first and last frames are identical so looping plays without a visible cut.
{% endstep %}
{% endstepper %}

### Export the avatar from Character Creator 5

{% stepper %}
{% step %}

#### Start the FBX export

In Character Creator 5, go to **File > Export > FBX > Clothed Character (Closed Character)**.
{% endstep %}

{% step %}

#### Configure export settings

In the export dialog:

* Set **Target Tool Preset** to **Unreal (UE5)**.
* Set **FBX Option** to **Mesh and Motion**.
* Increase the **Max Texture Size** if you need higher-resolution textures.
* Ensure **Custom** is checked, then click the icon to **Load Perform** and select your animations.
* Check **Delete Hidden Faces**.
  {% endstep %}

{% step %}

#### Export the file

Click **Export**. Enter a filename, choose a destination folder, and click **Save**. The export takes a few minutes.
{% endstep %}
{% endstepper %}

### Install the Reallusion CC Auto Setup for Unreal Engine

CC Auto Setup is a third-party tool provided by Reallusion — it is not part of the Convai plugin. It sets up the correct materials, shaders, and skeleton for Reallusion characters imported into Unreal Engine.

{% stepper %}
{% step %}

#### Download and install CC Auto Setup

Download CC Auto Setup from the [Reallusion CC Auto Setup for Unreal Engine](https://www.reallusion.com/auto-setup/unreal-engine/default.html) page. Double-click the installer, accept the license, and click **Next**. Note the destination folder path — you will need it in the next step.
{% endstep %}

{% step %}

#### Copy the content and plugins folders

After installation, open the destination folder. Navigate to the subfolder matching your Unreal Engine version. Copy the `Content` and `Plugins` folders from that subfolder.
{% endstep %}

{% step %}

#### Paste into your Unreal project

Open your Unreal project's root directory. Paste the copied `Content` and `Plugins` folders into the project root, merging with any existing folders.
{% endstep %}

{% step %}

#### Launch the project

Open the project in Unreal Engine. The Auto Setup content and plugin are now available.
{% endstep %}
{% endstepper %}

### Import the Reallusion avatar into Unreal Engine

{% stepper %}
{% step %}

#### Create a folder and import the FBX

In the **Content Browser**, create a new folder for the character. Drag the exported FBX file from your file system into this folder.
{% endstep %}

{% step %}

#### Configure import settings

In the **FBX Import Options** dialog:

* Enable **Import Animations**.
* Set the **Custom Sample Rate** to **30 fps** (some animations import at a very high rate, which can cause playback issues).
* Expand the **Advanced** section and check **Import Morph Targets**.
* Click **Import All**.

Dismiss any warning popups that appear during import.
{% endstep %}

{% step %}

#### Verify the import

Open the imported skeletal mesh in the editor. Confirm that the mesh has no deformations and that morph targets appear in the morph target list. Double-click an animation asset and confirm it plays smoothly with matching first and last frames.
{% endstep %}
{% endstepper %}

### Set up Convai in Unreal Engine

{% stepper %}
{% step %}

#### Create a character Blueprint

In the character's **Content Browser** folder, right-click and select **Blueprint Class > Actor**. Name the Blueprint (for example, `BP_MyReallusionCharacter`).
{% endstep %}

{% step %}

#### Add a Skeletal Mesh component

Open the Blueprint. In the **Components** panel, click **Add** and add a **Skeletal Mesh** component. In the **Details** panel, set the **Skeletal Mesh** to your imported Reallusion avatar.
{% endstep %}

{% step %}

#### Add the Convai Chatbot component

Click **Add** in the **Components** panel. Search for `BP Convai ChatBot Component` and select it. In the **Details** panel, paste your **Character ID** from the Convai dashboard into the **Character ID** field.
{% endstep %}

{% step %}

#### Place the character in the level

Drag the character Blueprint from the **Content Browser** into the level viewport and position it.
{% endstep %}
{% endstepper %}

### Add the Convai Player component to the player pawn

If you have not already done this, open your player pawn Blueprint and add `UConvaiPlayerComponent`. For detailed steps, see [Add your first Convai character](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/add-your-first-convai-character.md).

To find the player pawn from Play mode: press **Shift+F1** to release the mouse, click **Detach** in the toolbar, then click on the player character in the viewport and click **Edit Blueprint**.

### Test the conversation

Enter Play mode and speak to the character using push-to-talk (default: **T**) or the chat widget. At this stage, expect voice and text responses with audio playback only — body animation and lip sync require the animation Blueprint and Face Sync steps below.

### Add the Reallusion animation Blueprint

The Reallusion character needs the Convai Reallusion animation Blueprint (`Convai_Reallusion_AnimBP`) to drive idle, talk, focus, and walk states during conversation.

{% stepper %}
{% step %}

#### Download the animation Blueprint

Download the Reallusion animation Blueprint from the Convai Google Drive folder:

[Convai Reallusion animation Blueprint (Google Drive)](https://drive.google.com/drive/folders/1k3072DH3zJXk2xTg-CJ_najnm0pyvZJS)

{% hint style="info" %}
This Google Drive folder is the official distribution channel for the Reallusion animation Blueprint. If the link is unavailable, post a request in the [Convai Developer Forum](https://forum.convai.com) and the team will provide the asset directly.
{% endhint %}

Download the zip, extract it, and locate the animation Blueprint asset file.
{% endstep %}

{% step %}

#### Copy the asset into your project

Copy the animation Blueprint asset into the `Content` folder inside your Unreal project's directory on disk — copy it directly to the file system, not through the editor. Then restart the Unreal Editor so it detects the new asset.
{% endstep %}

{% step %}

#### Configure the animation Blueprint

After restart, find `Convai_Reallusion_AnimBP` in the **Content Browser** and double-click it. When prompted, select your Reallusion avatar's skeleton.

Open the **Animation Graph** inside `Convai_Reallusion_AnimBP`. In the **Content Drawer**, navigate to the character's motion folder and locate the animation assets you exported from Character Creator 5. Drag and drop each animation into the graph and connect it to the matching state:

| State             | Animation role                                          |
| ----------------- | ------------------------------------------------------- |
| `BaseAnimation`   | Idle animation — the default resting pose               |
| `Talk Animation`  | Body animation while the character is speaking          |
| `Focus Animation` | Animation while the character is listening or attentive |
| `Walk Animation`  | Locomotion animation when the character moves           |

* If drag and drop does not connect, right-click in the graph, type `Play`, and manually select the animation by name.
* Set transition blends between states to use the idle animation where appropriate.
* Ensure all looped animations are set to **Loop**.

Click **Compile** and **Save**.
{% endstep %}

{% step %}

#### Assign the animation Blueprint to the character

Open the character Blueprint. Select the **Skeletal Mesh** component. In the **Details** panel, under **Animation**, set **Anim Class** to `Convai_Reallusion_AnimBP`.

Compile and save the Blueprint.
{% endstep %}
{% endstepper %}

### Add facial animation with Convai Face Sync

{% stepper %}
{% step %}

#### Add the Convai Face Sync component

Open the character Blueprint. In the **Components** panel, click **Add** and search for `Convai Face Sync`. Add `UConvaiFaceSyncComponent`.
{% endstep %}

{% step %}

#### Set the lip sync mode

Select the **Convai Face Sync** component. In the **Details** panel, set **Lip Sync Mode**:

* **MetaHuman Blendshapes** — for CC5 characters (which use a MetaHuman-compatible rig).
* **CC4 Extended Blendshapes** — for CC4 characters.
  {% endstep %}

{% step %}

#### Compile, save, and test

Click **Compile** and **Save**. Enter Play mode and speak to the character.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
When the setup is complete, the Reallusion character's lips and facial expressions animate in sync with its spoken responses.
{% endhint %}

### Troubleshooting

#### No facial animation

**Symptom:** The character's mouth does not move during speech even though audio plays correctly.

**Cause:** `UConvaiFaceSyncComponent` is missing, **Lip Sync Mode** is set to the wrong blendshape target, or the FBX was imported without **Import Morph Targets** enabled.

**Fix:**

* Confirm that the **Convai Face Sync** component is present on the character Blueprint.
* Confirm that **Lip Sync Mode** is set to **MetaHuman Blendshapes** for CC5 characters, or **CC4 Extended Blendshapes** for CC4 characters.
* If the issue persists, re-import the FBX with **Import Morph Targets** checked under the **Advanced** section of the FBX Import Options dialog.

**Verify:** Enter Play mode and speak to the character. The lips should animate in sync with the spoken response. If they do not, open **Window > Output Log**, filter on `ConvaiFaceSync`, and check for errors during speech.

#### Body animation does not play

**Symptom:** The character stands frozen — no idle or talking animations play during the conversation.

**Cause:** **Anim Class** on the Skeletal Mesh is not set to the Reallusion animation Blueprint, animations are not set to loop, or the first and last frames do not match, causing the animation to snap.

**Fix:**

* Confirm that **Anim Class** on the Skeletal Mesh component is set to `Convai_Reallusion_AnimBP`.
* Open `Convai_Reallusion_AnimBP` and confirm each state (`BaseAnimation`, `Talk Animation`, `Focus Animation`, `Walk Animation`) has the correct animation assigned.
* Confirm every looped animation asset is set to **Loop**.
* Confirm that the first and last frames of each animation are identical.

**Verify:** Enter Play mode and confirm the character plays an idle animation and transitions to a talking animation when responding. Check **Window > Output Log** for animation or Convai errors if states do not change.

#### Character does not respond to voice or text

**Symptom:** The Reallusion character is in the level but does not react to input.

**Cause:** The **Character ID** is missing or incorrect, the API key is not configured, or `UConvaiPlayerComponent` is absent from the player pawn.

**Fix:** Verify the **Character ID** on the **Convai Chatbot** component and confirm your API key is set (see [Configure your API key](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/configure-your-api-key.md)). Confirm the player pawn has `UConvaiPlayerComponent` added.

**Verify:** Open **Window > Output Log**, filter on `ConvaiChatbotComponentLog` or `ConvaiConnectionManagerLog`, and look for authentication or connection errors when you enter Play mode.

### Next steps

{% content-ref url="/pages/9KUQ9XKjAMU6OaZfGxfJ" %}
[Configure the microphone](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/configure-the-microphone.md)
{% endcontent-ref %}

{% content-ref url="/pages/wO1MGAXD0InYM2apk7cV" %}
[Configure conversation input](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/configure-conversation-input.md)
{% endcontent-ref %}

{% content-ref url="/pages/g8UGNK2Dicyeh9I9zZ6x" %}
[Validate your setup](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/validate-your-setup.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/getting-started/set-up-a-reallusion-cc-character.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.