Ctrlk
PlaygroundExperienceVideosPricingForumStatus
youtube
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migrate Your Unreal Engine 5.5 Convai Assets to 5.8

Migrate an existing Unreal Engine 5.5 Convai asset project to the current supported Unreal Engine version using the Asset Uploader tool.

Migrate an existing Unreal Engine 5.5 Convai asset project to Unreal Engine 5.8 using the Asset Uploader tool. Use this page after Convai updates its plugins and toolchain for the new engine version. At the end, the project opens in Unreal Engine 5.8 with the asset updated through the AssetUploader editor utility.

Prerequisites

  • An existing Convai asset project created in Unreal Engine 5.5

  • The Asset Uploader tool (ConvaiAssetUploader.exe)

  • Unreal Engine 5.8 installed

Migrate the project

Run ConvaiAssetUploader.exe in the parent directory of your asset project, not inside the project folder itself. For example, if your project is at C:/ConvaiAsset/Avatar1, run the tool in C:/ConvaiAsset/.

1

Run the Asset Migration Tool

Navigate to the parent directory of your project and run ConvaiAssetUploader.exe.

2

Select the migration option

If the tool detects valid Convai projects, it presents three options:

What do you want to do?
1. Upload a new asset
2. Update and existing asset
3. Migrate an existing asset to 5.8 UE version
Enter your choice (1, 2, or 3):

Enter 3 and press Enter.

3

Select the project to migrate

The tool displays a list of all detected projects. Select the project to migrate to Unreal Engine 5.8.

4

Let the tool prepare the project

The tool creates a copy of the existing project as a backup and downloads all required dependencies.

5

Finalize the migration in Unreal Engine

Open the newly copied project in Unreal Engine 5.8, run the AssetUploader editor utility inside the Unreal Engine Editor, and click Update Asset.

Verify the migration

The migration is complete once the AssetUploader editor utility finishes updating the asset in Unreal Engine 5.8 without errors.

Manual migration steps

Migrate the project manually if the automated process encounters an issue

The automated tool performs the following steps internally. Follow them manually if the automated migration fails.

  1. Back up the project. Copy the existing asset project to a safe location.

  2. Update modding project components. Run ConvaiAssetUploader.exe to update the necessary plugins and related components.

  3. Switch the Unreal Engine version. Right-click the .uproject file, select Switch Unreal Engine version..., and choose 5.8.

    Screenshot required before publishing: Capture the Switch Unreal Engine version... dialog with Unreal Engine 5.8 selected in the version list. The image must show the exact dialog title and the full list of available engine versions.

  4. Install the cross-compile toolchain. Download and install the cross-compile toolchain for Unreal Engine 5.8. The recommended compiler is 14.50.35717. Download it from the Linux cross-compile toolchain for Unreal Engine.

  5. Clean up the project folders. Delete all folders in the project directory except Config, Content, ConvaiEssentials, Plugins, Source, and the .uproject file.

  6. Open the project in Unreal Engine 5.8. Open the Unreal Engine project using the 5.8 editor.

  7. Update the asset. Run the AssetUploader editor utility, then click Update Asset to complete the migration.

Next steps

Asset Uploader

Last updated

Was this helpful?