> 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/zh/cha-jian-yu-ji-cheng/asset-uploader/migrate-your-unreal-engine-5.5-convai-assets-to-5.8.md).

# 将你的 Unreal Engine 5.5 Convai 资源迁移到 5.8

将现有的 Unreal Engine 5.5 Convai 资源项目迁移到 Unreal Engine <code class="expression">space.vars.asset\_uploader\_unreal\_version</code> 使用 Asset Uploader 工具。在 Convai 为新的引擎版本更新其插件和工具链后使用本页面。最后，项目会在 Unreal Engine 中打开 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code> 并通过 `AssetUploader` 编辑器实用工具。

### 前提条件

* 一个在 Unreal Engine 5.5 中创建的现有 Convai 资源项目
* Asset Uploader 工具（`ConvaiAssetUploader.exe`)
* Unreal Engine <code class="expression">space.vars.asset\_uploader\_unreal\_version</code> 已安装

***

### 迁移项目

{% hint style="warning" %}
在 `ConvaiAssetUploader.exe` 在你的资源项目的父目录中运行，而不是在项目文件夹内部运行。例如，如果你的项目位于 `C:/ConvaiAsset/Avatar1`，则在以下位置运行该工具： `C:/ConvaiAsset/`.
{% endhint %}

{% stepper %}
{% step %}

#### 运行资源迁移工具

导航到项目的父目录并运行 `ConvaiAssetUploader.exe`.
{% endstep %}

{% step %}

#### 选择迁移选项

如果该工具检测到有效的 Convai 项目，它会提供三个选项：

```
你想做什么？
1. 上传新资源
2. 更新现有资源
3. 将现有资源迁移到 UE 5.8 版本
输入你的选择（1、2 或 3）：
```

输入 `3` 并按 Enter。
{% endstep %}

{% step %}

#### 选择要迁移的项目

该工具会显示所有检测到的项目列表。选择要迁移到 Unreal Engine 的项目 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code>.
{% endstep %}

{% step %}

#### 让工具准备项目

该工具会将现有项目复制一份作为备份，并下载所有必需的依赖项。
{% endstep %}

{% step %}

#### 在 Unreal Engine 中完成迁移

在 Unreal Engine 中打开新复制的项目 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code>，运行 `AssetUploader` 在 Unreal Engine 编辑器中打开编辑器实用工具，然后单击 **更新资源**.
{% endstep %}
{% endstepper %}

***

### 验证迁移

当以下项完成后，迁移即完成： `AssetUploader` 编辑器实用工具完成在 Unreal Engine 中更新资源 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code> 且没有错误。

***

### 手动迁移步骤

<details>

<summary>如果自动化过程遇到问题，请手动迁移项目</summary>

自动化工具会在内部执行以下步骤。如果自动迁移失败，请手动按这些步骤操作。

1. **备份项目。** 将现有资源项目复制到安全位置。
2. **更新 modding 项目组件。** 在 `ConvaiAssetUploader.exe` 以更新所需的插件和相关组件。
3. **切换 Unreal Engine 版本。** 右键单击 `.uproject` 文件，选择 **切换 Unreal Engine 版本...**，然后选择 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code>.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>发布前所需截图：</strong> 截取 <strong>切换 Unreal Engine 版本...</strong> 版本列表中已选择 Unreal Engine 5.8 的对话框。图片必须显示准确的对话框标题以及可用引擎版本的完整列表。</p></div>
4. **安装交叉编译工具链。** 下载并安装适用于 Unreal Engine 的交叉编译工具链 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code>。推荐的编译器是 <code class="expression">space.vars.asset\_uploader\_toolchain\_compiler\_version</code>。从以下位置下载： [适用于 Unreal Engine 的 Linux 交叉编译工具链](https://cdn.unrealengine.com/CrossToolchain_Linux/v26_clang-20.1.8-rockylinux8.exe).
5. **清理项目文件夹。** 删除项目目录中的所有文件夹，保留 `Config`, `Content`, `ConvaiEssentials`, `Plugins`, `Source`，以及 `.uproject` 文件。
6. **在 Unreal Engine 中打开项目** <code class="expression">space.vars.asset\_uploader\_unreal\_version</code>**.** 使用 <code class="expression">space.vars.asset\_uploader\_unreal\_version</code> 编辑器打开 Unreal Engine 项目。
7. **更新资源。** 运行 `AssetUploader` 编辑器实用工具，然后单击 **更新资源** 以完成迁移。

</details>

***

### 后续步骤

{% content-ref url="/pages/775cb607c7c773c413bf4787a95748354073b3ea" %}
[资源上传器](/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.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/zh/cha-jian-yu-ji-cheng/asset-uploader/migrate-your-unreal-engine-5.5-convai-assets-to-5.8.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.