LogoLogo
PlaygroundVideosBlogPricingForum
  • Welcome
  • Convai Playground
    • Playground Walkthrough
    • Get Started
    • Character Creator Tool
      • Create Character
      • Language and Speech
      • Knowledge Bank
      • Personality and Style
      • State of Mind
      • Memory
      • Actions
      • Narrative Design
      • Character Versioning
    • F.A.Q
  • Plugins & Integrations
    • Introduction
    • Unity Plugin
      • Pre-Requisites
      • Compatibility
      • Downloads
        • Limitations of WebGL Plugin
      • Setting Up Unity Plugin
      • Troubleshooting Guide
        • Disable Assembly Validation
        • Missing Newtonsoft Json
        • Microphone Permission Issues
        • Default Animations Incompatibility
        • Animations have Facial Blendshapes
        • Jaw Bone in Avatar is not Free
        • macOS Permission Issues
      • Creating a Convai Powered Scene from Template
      • Importing Ready Player Me (RPM) Characters
      • Importing Custom Characters
      • Adding Actions to your Character
      • Adding Lip-Sync to your Character
      • Adding Narrative Design to your Character
        • Narrative Design Keys
      • Adding NPC to NPC Conversation
      • Adding Scene Reference and Point-At Crosshairs
      • Utilities
        • Character Emotion
        • Player Data Container
        • Long Term Memory
        • Language Support
        • Managing sessionID Locally
        • Transcript UI System
        • Pre-built UI Prefabs
        • Input Management
        • Notification System
        • Settings Panel
        • Dynamic Information Context
      • Building For Supported Platforms
        • Building for iOS/iPadOS
        • Building for WebGL
        • Convai XR
          • Building for VR
            • VR Automatic Installation
            • VR Manual Installation
          • Building for MR
            • MR Automatic Installation
            • MR Manual Installation
          • Building for AR
          • Interacting with XR UI Elements
        • Building for macOS Universal apps
      • Changelogs
      • Tutorials
        • Narrative Design
        • NPC2NPC
    • Unreal Engine
      • Supported Platforms
      • Installation
      • Guides
        • Dynamic Environment Info
        • Change AI Character Movement Speed
        • Integration with Pixel Streaming
        • Adjust Interaction Radius
        • Creating MetaHuman Characters
          • Adding MetaHuman
          • Adding LipSync to MetaHuman (From plugin version 3.0.0 or later )
          • Change the Parent Class for MetaHuman
          • Change the parent class for Player.
          • Adding LipSync to MetaHuman (Deprecated)
        • Creating ReadyPlayerMe Characters
          • Download Plugins
          • Adding ReadyPlayerMe Character
          • Change the parent class for Player.
        • Creating Reallusion Characters
          • Creating a Reallusion Character
          • Importing Reallusion character and setting up the Convai plugin
          • Binding objects to Reallusion Character
        • Event-Aware Convai Characters
        • Operations Based on the Presence of Certain Words
        • Narrative Design
          • Narrative Design Trigger
          • Narrative Design Keys
        • Actions Guide
          • Stage 1: Default Actions
            • Moves To
            • Follows
          • Stage 2: Custom Actions
            • Simple actions
            • Adding Descriptions to Actions
          • Stage 3: Custom Actions with Single Parameter
          • Main Character and Attention Object
        • Customization
          • Push to Talk
          • Alter Character Response Audio Rate
        • Speech To Text Transcription
        • Enable Multiplayer Support
        • 3D Chat Widget
        • Long Term Memory
        • Saving and Loading Session
      • Blueprints Reference
        • Convai Player
        • Convai Chatbot
        • Convai Environment
        • Convai Object Entry
        • Convai Result Action
        • Convai Extra Params
        • Speech To Text
        • Text To Speech
        • Utility Functions
      • Troubleshoot Guide
        • Missing Unreal Engine Tool Set in Microsoft Visual Studio Toolchain
        • Convai Module Not Found
        • MetaHuman Plugin Conflict
        • Failure to Load Character IDs
      • Microphone Settings
        • Set Audio Gain
        • Set Microphone
        • Microphone test
        • List Microphone Devices
      • Mac Microphone Permission: Required for UE 5.0 and 5.3
      • Guides V2 (Under Development)
        • Getting Started
          • Installation
          • Simple Talking Cube
          • Adding Premade Chat and Settings UI
    • Web Plugin
      • PlayCanvas Plugin
        • Adding External Script
        • First Person View
        • Adding characters to scene
        • Character Animations
        • Convai Integration
        • Chat Overlay
      • Convai Web SDK
        • Getting Started
        • Facial Expressions
        • Actions
      • JavaScript Chat UI SDK
        • Getting Started
        • ChatBubble Props
      • Narrative Design Guide
        • Narrative Design Triggers
        • Narrative Design Keys
      • GLB Characters for Convai
      • GLB/FBX animations for Convai
    • Modding Framework
      • Modding Cyberpunk 2077
    • Other Integrations
      • Roblox
        • Sample Game 1
        • Sample Game 2
        • Code Example
          • Character Conversation API
      • Discord
        • Create a Discord Bot
        • Hosting Discord Bot from Personal Server
        • Hosting Discord Bot from Replit
      • Omniverse Extension
      • Third-Party API Integrations
        • ElevenLabs API Integration
    • Convai Pixel Streaming Embed
      • Whitelisting & Publishing an Experience
      • React Typescript
      • ReactJS (JavaScript)
      • Vanilla JavaScript (ES Modules)
      • CDN (UMD Script)
      • On Premise Deployment
      • API Reference
  • User Generated Content (UGC)
    • Avatar Studio
      • Creating a Convai Character
      • Customizing Your Avatar
        • Configure Avatar
          • Uploading Avatars
            • Metahuman Avatars
            • Reallusion Avatars
        • Face Filter
        • Environment
        • Lighting Adjustments
        • Animation & Expression Settings
        • Interface Configuration
        • Experience Settings
        • Publishing an Experience
    • Convai Sim
      • Creating a Convai Character
      • Creating Your AI Simulation with Convai Sim
      • Avatar Customization
      • Tour Guide
      • Publishing an Experience
    • Modding Tool
  • Reference
    • Core API Reference
      • Character Base API
      • Interaction API
      • Core AI Setting API
      • Backstory API
      • Chat History API
      • Knowledge Bank API
      • Narrative Design API
      • Action API
      • Language List API
      • Voice List API
      • Character List API
      • Evaluation API
Powered by GitBook
On this page
  • Introduction
  • Prerequisites
  • Step-by-Step Guide
  • 1. Open the Project
  • 2. Import Reallusion Character & Animations
  • 3. Connect Convai Animations
  • 4. Add FaceSync for Lipsync
  • 5. Set Correct Rotation
  • 6. Prepare Files for Upload
  • 7. Open the AssetUploader Tool
  • 8. Select the Character Asset
  • 9. Capture a Thumbnail
  • 10. Verify Before Upload
  • 11. Upload the Avatar
  • Accessing the Avatar
  • Summary

Was this helpful?

  1. User Generated Content (UGC)
  2. Avatar Studio
  3. Customizing Your Avatar
  4. Configure Avatar
  5. Uploading Avatars

Reallusion Avatars

Upload custom Reallusion characters from Unreal Engine 5.3 to Avatar Studio using the Convai Modding Tool.

PreviousMetahuman AvatarsNextFace Filter

Last updated 1 month ago

Was this helpful?

Introduction

This guide explains how to prepare and upload Reallusion-based avatars using the Convai Modding Tool. You’ll import your Reallusion character and animations, apply Convai’s animation and lipsync systems, and then upload your avatar to Avatar Studio using the built-in AssetUploader tool.


Prerequisites

Make sure you have the following ready:

  • A project created with the , where you answered N to “Are you using a Metahuman?”

  • A custom Reallusion character exported and ready for import


Step-by-Step Guide

1. Open the Project

Navigate to your project directory and open the .uproject file to launch it in Unreal Engine 5.3.


2. Import Reallusion Character & Animations

Follow this to import your Reallusion assets:

  • [00:00 – 07:25]: Import your character and animations

  • [07:50 – 08:20]: Create a new Blueprint Class for your character


3. Connect Convai Animations

Now we’ll bind the correct animation logic to your character.

We’ve already added the necessary Animation Blueprint for you:

  • Go to Content/ConvaiReallusion/

  • Locate and assign the ConvaiReallusion Animation Blueprint to your character’s Skeletal Mesh

This blueprint ensures that your Reallusion character plays proper idle/talking animations in sync with Convai interactions.


4. Add FaceSync for Lipsync

To enable lipsync:

  • Add the FaceSync component to your character’s Blueprint


5. Set Correct Rotation

Reallusion characters typically face the wrong direction by default. Fix this by:

  • Opening the character Blueprint

  • Selecting the SkeletalMesh component

  • Set the Z Rotation to -90 in the Details panel


6. Prepare Files for Upload

  1. Go to: Plugins/<random code> Content/ (e.g., Plugins/AHK3LNKVC7FZA3I5JG3V Content/)

  2. Drag and Move both of the following folders into this directory:

    • Your character’s folder (containing the Blueprint and animations)

    • Content/ConvaiReallusion/ (contains the animation blueprint)

    • The final structure should mirror what’s shown in the screenshot.

This folder determines what gets packaged and uploaded. Make sure everything is placed correctly.


7. Open the AssetUploader Tool

  • Navigate to Content/Editor/AssetUploader

  • Right-click and select Run Editor Utility Widget


8. Select the Character Asset

  • Navigate to Plugins/<random code> Content/YourCharacterFolder/

  • Select your character’s Blueprint Class

  • Then, in the Asset Uploader window, click Pick Asset


9. Capture a Thumbnail

Click Capture Thumbnail to create a preview image that will appear in Avatar Studio.


10. Verify Before Upload

Before uploading, do a quick functional test:

  1. Drag the character into your Level

  2. Select it and locate the BP_ConvaiChatbotComponent in the Details panel

  3. Paste in a test Character ID

  4. Press Play and verify:

    • Animation is working

    • Lipsync is functioning

    • Character is correctly positioned and oriented


11. Upload the Avatar

  • In the Asset Uploader, click Create Asset

  • This triggers:

    • Packaging the asset for Win64

    • Uploading to Avatar Studio

Monitor the Output Log:

  • Wait for Package completed

  • Then look for Uploaded Asset

To delete a previously uploaded asset, open AssetUploader and click Delete.


Accessing the Avatar

  1. Go to Upload Your Custom Avatar

  2. Your Reallusion character will now be available for selection and use


Summary

Using the Convai Modding Tool, uploading Reallusion avatars is quick and reliable. With proper setup and a few clicks, your characters are live in Avatar Studio and ready for real-time AI interaction.

Refer to the for this step: [10:12 – 12:48]

See how in the same : [12:48 – 12:56]

If there’s an error during packaging, check the logs and share them on the for support.

Visit

Convai Modding Tool
video tutorial
tutorial
video
Convai Developer Forum
Avatar Studio