Unity 外掛設定，一步步完成

從空的 Unity 專案到讓 AI 代理在編輯器中工作，你需要的一切都在這裡：安裝外掛、登入、連接 AI 用戶端，並新增你需要的擴充功能。Unity 安裝頁面有簡短版本。

開始之前

Unity 2022.3 或更新版本、ai-game.dev 帳號，以及 AI 用戶端。

Unity 2022.3 或更新版本 — 支援 Unity 6。
ai-game.dev 帳號，用於預設的雲端連線 — 若你沒有帳號，請建立一個。
AI 用戶端 — AI Game Dev 應用程式、Claude Code、Cursor、Copilot、Gemini、Codex，或14 個支援的 MCP 用戶端中的任何一個。
第一次開啟時需要網際網路連線 — 外掛會從 NuGet 下載其 .NET 套件。

安裝外掛

可透過應用程式、CLI、OpenUPM 或安裝程式套件 — 擇一即可。

四種新增外掛的方式，從最簡單的開始：

在AI Game Dev 應用程式中開啟你的 Unity 專案，然後按一下安裝套件。應用程式會從 OpenUPM 安裝最新的外掛、讓外掛完成登入，並設定你的代理。

從 npm 安裝 CLI，然後將外掛新增到你的專案（它會替你編輯 Packages/manifest.json）：

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

使用 OpenUPM CLI 時，在專案資料夾中執行下列指令：

openupm add com.ivanmurzak.unity.mcp

沒有 OpenUPM CLI？將作用域登錄新增到 Packages/manifest.json，然後在視窗 → 套件管理員中新增套件：

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

開啟視窗並登入

開啟 AI Game Developer 視窗，並用你的帳號登入一次。

在 Unity 中選擇Window → AI Game Developer — MCP（Ctrl+Alt+A，或在 macOS 上使用 Cmd+Option+A）。
將連線開關保持在雲端，然後按一下授權。
瀏覽器會開啟 ai-game.dev 登入頁面並顯示一組短代碼。確認代碼相符後核准。
Unity 狀態會變成已連線。

登入狀態會儲存在整台電腦上：如果你已使用應用程式或 unity-mcp-cli login 登入，編輯器會沿用，你可以跳過此步驟。

連接你的 AI 用戶端

一個指令，或在視窗中按一下，就能寫入用戶端設定。

在視窗中，按一下 AI 代理旁的設定，或從終端機執行 setup-mcp。兩者都會將專案固定的 URL 與專案金鑰寫入用戶端設定，讓它立即連線：

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

設定變更後，請重新啟動 AI 用戶端。其他用戶端與手動設定，請參閱連接 AI 用戶端與MCP 端點頁面。

新增擴充功能（選用）

動畫、Cinemachine、地形、時間軸等 — 只安裝你需要的項目。

每個擴充功能都是獨立的 Unity 套件。安裝後，它會透過 RQL 讓 AI 代理學會 Unity 的某個領域。以下是幾個熱門的：

AI Animation3 項功能

openupm add com.ivanmurzak.unity.mcp.animation

AI Cinemachine4 項功能

openupm add com.ivanmurzak.unity.mcp.cinemachine

AI Terrain4 項功能

openupm add com.ivanmurzak.unity.mcp.terrain

AI Timeline5 項功能

openupm add com.ivanmurzak.unity.mcp.timeline

所有 10 個 Unity 擴充功能 →

疑難排解

最常遇到問題的修正方式。更多內容請見 Unity 疑難排解指南。

下一步

Unity 維基 →設定、工具與 RQL、自訂工具、CLI 參考，以及更多內容。Unity 工具 →AI 代理在 Unity 中能做的一切，並附範例。最佳實務 →如何向 AI 代理提出它擅長處理的工作。