项目与引擎

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

支持的引擎#

你也可以打开任意其他文件夹，例如仅用于 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 中，同样的操作以斜杠命令的形式提供：

/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。扩展页面列出了各引擎可用的扩展。

创建新项目#

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

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

在 CLI 中：

/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：安装、连接 AI 客户端、unity-mcp-cli。
• Unreal：安装、连接 AI 客户端、unreal-mcp-cli。
• Godot：安装、连接 AI 客户端、godot-cli。

在 CLI 中打开项目#

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

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 项目。

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

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

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

工具目录 列出了所有引擎工具，最佳实践 则说明了如何编写有效的请求。Unity、Unreal 和 Godot 的引擎页面分别概述了各自的集成方式。