# 项目与引擎 — AI Game Dev 应用与 CLI · AI Game Developer Wiki

在 AI Game Dev 应用中打开或创建 Unity、Unreal 或 Godot 项目，安装引擎插件，并让 agent 在需要时打开编辑器。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/docs/wiki/app/projects-and-engines)。

AI Game Dev 应用中的一切都发生在项目里：也就是你电脑上的一个文件夹。当这个文件夹是 Unity、Unreal Engine 或 Godot 项目时，应用会识别引擎、配置对应的 MCP 插件，并把编辑器的工具连接到你的对话中。本页介绍如何在桌面应用和 CLI 中打开和创建项目、插件的安装与更新，以及 agent 如何与编辑器协作。

## 支持的引擎

| 引擎 | 插件 | 应用的识别方式 | 支持的版本 |
| --- | --- | --- | --- |
| Unity | [Unity MCP](https://ai-game.dev/zh-hans/docs/wiki/unity) | `ProjectSettings/ProjectVersion.txt`，或包含 `Packages/manifest.json` 的 `Assets/` 文件夹 | Unity 2022.3 LTS 或更高版本 |
| Unreal Engine | [Unreal MCP](https://ai-game.dev/zh-hans/docs/wiki/unreal) | 文件夹中存在 `*.uproject` 文件 | Unreal Engine 5.5 或更高版本，C++ 项目 |
| Godot | [Godot MCP](https://ai-game.dev/zh-hans/docs/wiki/godot) | 文件夹中存在 `project.godot` 文件 | Godot 4.3 至 4.5 (.NET) |

你也可以打开任意其他文件夹，例如仅用于 Blender 的素材项目、设计文档文件夹或工具仓库。此时 agent 仍可处理文件、包和工具，只是没有引擎工具。

## 在桌面应用中打开项目

空白窗口就是启动器，它提供以下选项：

- **Open folder…** 用于选择项目文件夹。
- **Create new project** 用于新建 Unity、Unreal 或 Godot 项目。
- 你最近打开的项目。

每个项目都位于各自的窗口中。Ctrl-点击（Windows、Linux）或 Cmd-点击（macOS）最近项目，可在新窗口中打开它，而不是替换当前窗口。重新启动应用时，所有之前打开的项目窗口都会恢复，并保留其大小、位置和布局。

## 安装或更新引擎插件

打开引擎项目后，侧边栏会显示该项目所用的引擎及其操作：

- 当项目中还没有引擎插件时显示 **Install Package**，当有更新的插件版本时显示 **Update Package**。
- **Open Editor** 用于启动此项目的引擎编辑器。

点击 **Install Package** 添加插件。应用绝不会自行修改现有项目：点击即代表你的同意，因为安装会写入你的项目（例如对 Unity，它会将包添加到 `Packages/manifest.json`）。从应用中创建的项目，插件会在创建过程中自动安装。

插件安装器内置于应用中：你无需在机器上安装 Node.js、npm、`unity-mcp-cli`、`unreal-mcp-cli` 或 `godot-cli`。

在 CLI 中，同样的操作以斜杠命令的形式提供：

```text
/install-plugin            install the MCP plugin into the current project
/install-plugin C:/Games/MyGame
/open                      open the editor for the current project
```

## 引擎扩展

引擎扩展为插件增加更多工具，例如针对粒子系统或动画的额外 Unity 工具。你可以在桌面应用侧边栏的扩展操作中浏览并安装它们，或在 CLI 中使用 `/install-extension`。[扩展页面](https://ai-game.dev/docs/extensions)列出了各引擎可用的扩展。

## 创建新项目

在桌面应用中，选择 **Create new project**：

1. 选择引擎。
2. 输入项目名称。项目会在你所选父文件夹下以该名称创建的子文件夹中创建；缺失的文件夹会自动创建。
3. 选择编辑器：默认选中已安装的最新版本，也可手动选择已安装的编辑器。如果该引擎没有安装任何编辑器，应用会提示；请先安装引擎，然后继续。
4. 应用会创建项目、安装插件并打开它。

在 CLI 中：

```text
/create-project unity SkywardKeep
/create-project godot SkywardKeep D:/Games
```

语法为 `/create-project <unity|godot|unreal> <name> [parentDir]`。

## agent 如何与编辑器协作

你可以在编辑器启动之前就开始对话。普通讨论绝不会启动任何东西。当 agent 需要编辑器来完成任务时，它会请求应用打开该项目的编辑器，等待编辑器的工具可用，然后继续同一任务。会话进行中稍后才上线的编辑器（例如你自己打开的）会连接到正在运行的对话，而不会新开一个对话。

几条规则让这一切保持可预测：

- 每个项目只启动一个编辑器，即使多个会话同时需要它。
- 已发送的引擎调用在断开连接后绝不会自动重放；agent 会先检查结果，再尝试下一次写入。
- **Stop** 会取消对编辑器的等待。已经启动的编辑器会保持打开。
- 启动大型项目可能需要一段时间。一次启动最多等待 15 分钟，之后最多再等 2 分钟让工具出现。

**提示**

在开始长时间会话之前先打开编辑器，可以省去第一次引擎步骤时的启动等待。

## 编辑器内部

每个插件在编辑器中都有自己的窗口（在 Unity 中为 **AI Game Developer** 窗口），用于显示连接状态。应用打开编辑器时会传递你已登录的会话，因此插件无需手动填写令牌即可通过 ai-game.dev 连接。如果编辑器显示“Disconnected”，请打开该窗口，选择 **Cloud** 并点击 **Authorize**，然后等待出现 **Ready**。

插件专属设置、手动安装以及连接其他 AI 客户端分别在各引擎的 wiki 中介绍：

- Unity：[安装](https://ai-game.dev/zh-hans/docs/wiki/unity/installation)、[连接 AI 客户端](https://ai-game.dev/zh-hans/docs/wiki/unity/connecting-ai-clients)、[`unity-mcp-cli`](https://ai-game.dev/zh-hans/docs/wiki/unity/cli)。
- Unreal：[安装](https://ai-game.dev/zh-hans/docs/wiki/unreal/installation)、[连接 AI 客户端](https://ai-game.dev/zh-hans/docs/wiki/unreal/connecting-ai-clients)、[`unreal-mcp-cli`](https://ai-game.dev/zh-hans/docs/wiki/unreal/cli)。
- Godot：[安装](https://ai-game.dev/zh-hans/docs/wiki/godot/installation)、[连接 AI 客户端](https://ai-game.dev/zh-hans/docs/wiki/godot/connecting-ai-clients)、[`godot-cli`](https://ai-game.dev/zh-hans/docs/wiki/godot/cli)。

## 在 CLI 中打开项目

CLI 会在当前目录中工作，也可以在你指定的文件夹中工作：

```bash
cd /path/to/your/game
gamedev

# or
gamedev /path/to/your/game
gamedev --project /path/to/your/game
```

启动时，CLI 会说明它检测到了什么，例如“Unity project detected”，或者说明该文件夹中没有 Unity、Godot 或 Unreal 项目。

## 智能体可以在你的项目中做什么

连接引擎后，用自然语言提出请求，例如：

- “列出活动场景中的所有内容。”
- “在原点创建一个立方体，并给它添加物理刚体。”
- “截取当前视图的屏幕截图。”

[工具目录](https://ai-game.dev/docs/tools) 列出了所有引擎工具，[最佳实践](https://ai-game.dev/docs/best-practices) 则说明了如何编写有效的请求。[Unity](https://ai-game.dev/zh-hans/engines/unity)、[Unreal](https://ai-game.dev/zh-hans/engines/unreal) 和 [Godot](https://ai-game.dev/zh-hans/engines/godot) 的引擎页面分别概述了各自的集成方式。

---

Source (HTML): https://ai-game.dev/zh-hans/docs/wiki/app/projects-and-engines

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/docs/wiki/app/projects-and-engines