> 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/convai-unreal-engine-plugin/getting-started/stack-o-bot-tutorial-setup.md).

# Stack O Bot 教程设置

构建 Convai 角色动作教程使用的示例项目，从 Epic 的免费 Stack O Bot 开始并应用 Convai 教程文件。

Convai 的 AI 玩家教程系列是在 Epic Games 免费的 Stack O Bot 示例项目中拍摄的，并在项目上应用了一组 Convai 文件。视频中，一名玩家和一位由 Convai 驱动的队友共同解开一个双人谜题，任何一方都无法独自完成。本页将从头构建该项目，让你的编辑器与视频中的内容一致。只有想在同一个场景中跟着操作时，才需要本页；系列中介绍的所有功能都适用于任何项目。

{% embed url="<https://youtu.be/KcJETVhI7KM>" %}
AI 玩家系列第一部分，使用本项目拍摄
{% endembed %}

### 开始之前

* **Unreal Engine 5.8。** 教程文件是针对 5.8 准备的。使用其他引擎版本创建的项目将与教程不一致。
* **Epic Games 账号**，用于从 Fab 领取 Stack O Bot。
* **已安装 Convai 插件并配置好 API 密钥。** 请参阅 [安装 Convai 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/install-the-convai-plugin.md) 和 [配置 API 密钥](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-your-api-key.md).

{% hint style="info" %}
Stack O Bot 由 Epic Games 发布，且可免费使用。Convai 教程文件是单独下载的内容，仅添加教程所用的地图、蓝图和配置。
{% endhint %}

### 创建 Stack O Bot 项目

{% stepper %}
{% step %}

#### 在 Fab 上领取 Stack O Bot

打开 [Fab 上的 Stack O Bot](https://www.fab.com/listings/b4dfff49-0e7d-4c4b-a6c5-8a0315831c9c)，使用 Epic Games 账号登录，然后选择 **添加到我的库**。如果系统提示，请接受许可协议。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fkms4ACNuh5z7r2lWpEOq%2Fimage.png?alt=media&amp;token=87fe257b-637c-4294-813d-9fd2400f13fe" alt="The Stack O Bot listing on Fab, showing the Add to My Library button"><figcaption><p>Stack O Bot 由 Epic Games 发布，且可免费使用。</p></figcaption></figure>
{% endstep %}

{% step %}

#### 通过 Epic Games Launcher 创建项目

打开 Epic Games Launcher，然后前往 **Unreal Engine > Library > Fab Library**。找到 **Stack O Bot**，选择 **创建项目**，然后选择 Unreal Engine 5.8。
{% endstep %}

{% step %}

#### 记下项目位置

创建项目之前，请复制或记下项目文件夹的路径。下一节需要用到此路径，而且启动器之后不会再显示该路径。
{% endstep %}
{% endstepper %}

### 应用 Convai 教程文件

教程文件是一个增量包：其中仅包含 Convai 教程新增或修改的内容，目录结构可直接复制到你刚创建的项目中。

{% stepper %}
{% step %}

#### 下载教程文件

从此处下载 Convai Stack O Bot 教程增量包： [Convai 教程增量包下载](https://drive.google.com/uc?export=download\&id=1RvlntYxX_Q-pr7Q_O0jYwhzrmob1WEgd)。压缩包中包含一个 `Content` 文件夹和一个 `Config` 文件夹。
{% endstep %}

{% step %}

#### 解压压缩包

右键单击下载的 ZIP 文件，选择 **全部解压**，然后打开解压后的文件夹。确认其中直接包含 `Content` 和 `Config` 文件夹。
{% endstep %}

{% step %}

#### 将增量包复制到项目中

打开你之前记录的 Stack O Bot 项目文件夹。复制所有内容 **放入** 提取出的文件夹内容复制到项目文件夹中，并选择 **替换目标位置中的文件** 当 Windows 询问时。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
复制 delta 文件夹中的内容，而不是文件夹本身。复制正确后， `Content` 和 `Config` 应直接与 `StackOBot.uproject`位于同一目录。多嵌套一层文件夹是地图无法显示的最常见原因。
{% endhint %}

### 打开并测试项目

{% stepper %}
{% step %}

#### 打开项目

使用 Unreal Engine 5.8 打开 `StackOBot.uproject` 。如果编辑器提示重新构建模块，请允许。
{% endstep %}

{% step %}

#### 登录 Convai

打开 Convai Editor 窗口并登录。请参阅 [登录并管理账户](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/sign-in-and-manage-your-account.md).
{% endstep %}

{% step %}

#### 运行教程关卡

打开 `Content/StackOBot/Maps/Convai/Lvl_Convai` 并按下 **Play**.
{% endstep %}
{% endstepper %}

### 验证设置

当以下情况出现时，项目便已准备就绪： `Lvl_Convai` 显示在 **内容浏览器** 中的 `Content/StackOBot/Maps/Convai`下方；关卡打开时没有缺失资源警告；并且在 Play 模式下对 Convai 角色说话时，它会做出回应。

如果地图缺失，说明 delta 内容多复制了一层——请检查 `Content` 和 `Config` 是否与 `StackOBot.uproject` 位于同一目录，而不是另一个文件夹中。如果地图可以打开，但角色没有响应，说明插件已安装但尚未完成身份验证；请按照 [配置 API 密钥](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-your-api-key.md).

### 后续步骤

项目运行后，请在拍摄该系列视频的场景中跟着教程操作。第一部分会将 AI 队友加入关卡、启用动作，并为压力板和移动平台添加标签；第二部分则为板条箱添加自定义拾取和放下动作。以下页面以文字形式介绍相同内容。

{% content-ref url="/pages/e40e8b0853ec91418830a025e7b0c9acccd8d371" %}
[角色动作快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/character-actions-quick-start.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/stack-o-bot-tutorial-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
