本页由英文机器翻译而成。阅读英文原文。

引擎 · Unity

Unity可用

把 AI Game Developer 插件放进你的 Unity 项目,用 AI 驱动编辑器。

Unity 2022.3 LTSUnity 2023Unity 6 (6000.x)任意 2022.3+ 版本
01

安装插件

两种方式把插件装进你的项目——选适合你工作流的那种。

推荐

CLI

通过 unity-mcp-cli 工具安装。无需手动下载——在终端里运行命令即可。

1安装 CLI

从 npm 全局安装 unity-mcp-cli。

npm install -g unity-mcp-cli
2安装 Unity (可选)

使用 CLI 安装 Unity 编辑器。如已安装可跳过。

unity-mcp-cli install-unity 6000.3.9f1
3创建 Unity 项目 (可选)

新建一个 Unity 项目,或使用现有项目。

unity-mcp-cli create-project ./MyUnityProject
4安装插件

将 Unity MCP 包安装到你的项目中。

unity-mcp-cli install-plugin ./MyUnityProject
5打开 Unity 项目

在 Unity 编辑器中打开该项目。

unity-mcp-cli open ./MyUnityProject

安装包

下载 .unitypackage 安装包并直接导入你的 Unity 项目——一次导入即可完成安装。

下载 .unitypackage
1安装 Unity (可选)

下载 Unity Hub,安装任意 Unity 2022.3 LTS 或更高版本的编辑器。如已安装可跳过。

2创建 Unity 项目 (可选)

用 Unity Hub 新建 Unity 项目,或使用现有项目。

3下载安装包

点击上方的 下载 .unitypackage 按钮获取 AI-Game-Dev-Installer.unitypackage。

4导入包

在 Unity 中:Assets → Import Package → Custom Package…,然后选择下载好的文件。

更想用包管理器?可以通过 OpenUPM 添加:openupm add com.ivanmurzak.unity.mcp。完整说明见 Unity 插件安装指南。

02

连接

通过托管的云端端点运行,或指向你自己的服务器。

云端

默认

使用设备码 OAuth 流程通过 ai-game.dev 连接——无需手动复制令牌。在 AI Game Developer 窗口中选择 Cloud,点击 Authorize,然后在浏览器中批准设备码。可跨防火墙使用,并提供用量分析。这是默认方式,也是我们为大多数用户推荐的方式。

自定义

更想全部在本地运行?把插件指向你自己的 gamedev-mcp-server 实例,而不是托管端点。这样你的 AI 客户端会直接与本机通信。各客户端的配置片段见 MCP 端点页面。

需要客户端配置片段(Claude、Cursor、Copilot、Gemini 等)?查看 MCP 端点页面 →

03

配置你的 AI 智能体

选择你使用的 AI 智能体,复制把它接入 Unity MCP 服务器的 unity-mcp-cli 命令。

你的 AI 智能体

在你的项目中运行以下命令,为 Unity 配置 Claude Code:

unity-mcp-cli setup-mcp claude-code ./MyUnityProject

配置后请重启你的智能体。新的 MCP 服务器只有在智能体完全重启后才会被加载——请彻底退出并重新打开(仅重载窗口不够)。

04

首次运行

打开窗口,完成授权,然后试试你的第一条提示词。

  1. 在 Unity 编辑器中打开项目,然后进入 Window → AI Game Developer。
  2. 在面板中选择 Cloud,点击 Authorize 完成设备码流程。
  3. 等待状态标签显示为 Ready(绿色),然后连接你的 AI 客户端。
  4. 在你的 AI 客户端里试试下面这样的提示词,看它在编辑器中如何执行。
示例提示词
创建一个新场景,包含一盏平行光和一个旋转的立方体,然后进入播放模式。

想要更多示例提示词和高效 AI 请求的写作范式?查看 Unity 最佳实践 →

Unity 插件为你的 AI 客户端提供 72 项能力(21 个 MCP 工具 + RQL)。

浏览 Unity 工具目录 →

想要更多工具?浏览 Unity 扩展 →