本頁面由英文機器翻譯而成。閱讀英文原文。

引擎 · 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 用戶端試試下方這樣的提示詞,看看它在編輯器中如何動作。
範例提示詞
建立一個包含方向光與旋轉立方體的新場景,然後進入 Play 模式。

想要更多範例提示詞,以及有效 AI 請求的模式嗎?查看 Unity 最佳實務 →

Unity 外掛會為你的 AI 用戶端提供 72 項功能(21 個 MCP 工具 + RQL)。

瀏覽 Unity 工具目錄 →

想要更多工具嗎?瀏覽 Unity 擴充功能 →