search
Ctrlk
PlaygroundConvai ExperienceVideosPricingBlogForum

Uploading Scenes

Upload your custom Unreal Engine Levels to Avatar Studio with Convai Modding Tool.

hashtag
Introduction

This guide explains how to upload custom scenes (Levels) from Unreal Engine 5.3 to Avatar Studio using the Convai Modding Tool. Whether you’re building rich environments or AI-driven stages, you’ll learn how to prepare, tag, and upload them in just a few steps.

hashtag
Prerequisites

Make sure you have:

  • Created your project using the Convai Modding Tool

    • Selected 1 when asked whether you are uploading a Scene or Avatar

  • A fully prepared and tested Unreal Engine Level (with all necessary assets)

hashtag
Step-by-Step Guide

hashtag
1. Open the Project

Open the project created by the Modding Tool by double-clicking the .uproject file.

hashtag
2. Import the Scene

Import your custom Level and all required assets (meshes, environment packs, etc.) into your project.

Make sure the Level is fully playable and doesn’t contain any broken references.

hashtag
3. Editor (Player) Start Point

To set the spawn location of the editor (Player) in the Level

  1. Place an Actor in your Level

  2. Move it to the desired spawn location

  3. In the Details panel, set the Tag of the Actor to:

circle-exclamation

This tag is essential. It helps the system know where to place the editor (player) once the scene is loaded in Avatar Studio.

hashtag
4. Prepare Files for Upload

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

  2. Drag and Move your Level’s folder and its dependencies into this directory.

circle-info

This ensures the Level and all its references are included during packaging and upload.

hashtag
5. Open the AssetUploader Tool

  • Go to Content/Editor/AssetUploader

  • Right-click and choose Run Editor Utility Widget

hashtag
6. Select the Level Asset

  • In the Content Browser, go to the directory inside Plugins/<random code> Content/

  • Select your Level asset

  • Return to the Asset Uploader window and click Pick Asset

hashtag
7. Capture a Thumbnail

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

hashtag
8. Upload the Scene

Once everything is ready, click Create Asset in the Asset Uploader.

The process includes:

  • Packaging the Level for Win64

  • Uploading the Level to Avatar Studio

Check the Output Log:

  • Look for Package completed

  • Then Uploaded Asset to confirm successful upload

circle-exclamation

If there’s an error during packaging, check the logs and share them on the Convai Developer Forumarrow-up-right for support.

circle-info

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

hashtag
Accessing the Scene

  1. Visit Avatar Studioarrow-up-right

  2. Open the Upload Your Custom Scene section

  3. Your Level will appear in the list, ready for testing or integration with avatars

hashtag
Summary

Uploading custom Levels allows you to create rich environments for your AI avatars in Convai Sim. The Modding Tool automates most of the setup — just make sure to set your spawn point and move your assets to the correct folder.

Last updated

Was this helpful?