# 常見問題 — Unity · AI Game Developer Wiki

Unity MCP 常見問題解答：支援的 Unity 版本與 AI 用戶端、Cloud 與本機模式、費用、隱私、組建、CI 與 RQL。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/docs/wiki/unity/faq)。

針對 Unity MCP（Unity 的 AI Game Developer 外掛）最常被問到的問題提供簡短解答。每個解答都附有詳細說明頁面的連結。

## 一般

### Unity MCP 是什麼？

這是一款 Unity Editor 外掛，讓 AI 代理透過 Model Context Protocol 在你的專案中工作。代理可以讀取與修改場景、GameObject、元件、預製件與資源，撰寫並執行 C#、執行測試以及擷取畫面。請參閱[概觀](https://ai-game.dev/zh-hant/docs/wiki/unity)。

### 外掛是否免費且開源？

外掛以 Apache-2.0 授權開源，位於 [Unity-MCP 儲存庫](https://github.com/IvanMurzak/Unity-MCP)。Custom 模式會執行本機伺服器，不需要帳號。Cloud 模式則使用你的 ai-game.dev 帳號；方案請見[價格頁面](https://ai-game.dev/pricing)。

### 支援哪些 Unity 版本？

Unity 2022.3 及更新版本，包含 Unity 6。

### 支援哪些 AI 用戶端？

AI Game Developer 視窗內建 Claude Code、Claude Desktop、Cursor、Visual Studio Code（Copilot）、Visual Studio（Copilot）、Rider（Junie）、GitHub Copilot CLI、Gemini、Antigravity、Cline、Open Code、Codex、Kilo Code、Zoo Code 與 Unity AI 的設定工具，另外還有可自訂的項目，可支援任何其他 MCP 用戶端。請參閱[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/unity/connecting-ai-clients)。

### 我需要自備 AI 用戶端嗎？

不需要。[AI Game Dev 桌面應用程式](https://ai-game.dev/docs/app)內含代理，會安裝外掛並完成連線。如果你已經在使用 Claude Code、Cursor 或其他 MCP 用戶端，也可以自備用戶端。

## 設定

### 最簡單的安裝方式是什麼？

使用桌面應用程式。若不使用，可執行 `unity-mcp-cli install-plugin`，或改用 OpenUPM 或 `.unitypackage` 安裝程式。請參閱[安裝](https://ai-game.dev/zh-hant/docs/wiki/unity/installation)。

### 外掛視窗在哪裡？

**Window > AI Game Developer — MCP**，快速鍵 Ctrl+Alt+A（macOS 為 Cmd+Option+A），或 Scene View 工具列上的 **AI** 按鈕。

### Cloud 與 Custom 模式有什麼差別？

在預設的 Cloud 模式下，Editor 與你的 AI 用戶端會連線到 `https://ai-game.dev/mcp`，你只需登入一次。在 Custom 模式下，外掛會依專案路徑衍生的連接埠啟動本機 MCP 伺服器，所有資料都留在你的電腦上。請參閱[設定](https://ai-game.dev/zh-hant/docs/wiki/unity/configuration#connection-modes)。

### 我需要自己選擇連接埠嗎？

不需要。連接埠由專案路徑衍生（範圍 20000 到 29999），因此每個專案的連接埠固定不變，且不同專案互不相同。你可以在 **Server URL** 中覆寫。

### 設定儲存在哪裡？

儲存在專案內的 `UserSettings/AI-Game-Developer-Config.json`。ai-game.dev 的登入資訊則依每台電腦儲存於 `~/.ai-game-dev/credentials.json`。

### 我可以同時使用多個 Unity 專案嗎？

可以。每個專案都有各自的連接埠，而固定網址（`https://ai-game.dev/mcp/p/<pin>`）會將每個代理導向正確的 Editor。

## 使用方式

### 像 gameobject-create 這類工具跑到哪裡去了？

\\1.0.0 版以 RQL 取代了過去一個動作一個工具的做法：`rql-query`、`rql-mutate` 與 `rql-schema` 涵蓋場景、GameObject、元件、資源、Console 與 Editor 狀態。請參閱[工具與 RQL](https://ai-game.dev/zh-hant/docs/wiki/unity/tools-and-rql#old-names)。

### AI 可以復原它的變更嗎？

每次 `rql-mutate` 呼叫都會記錄為一個復原步驟，因此按 Ctrl+Z（Cmd+Z）即可還原。較大範圍的變更請使用版本控制。

### 為什麼代理只看得到少數幾個工具？

為了節省上下文。預設會顯示七個工具；其餘工具雖已安裝但會隱藏，只要以名稱呼叫仍可執行。可在視窗的 **Tools > Open** 下顯示更多。

### 我可以加入自己的工具嗎？

可以。在類別上標註 `[AiToolType]`，並在方法上標註 `[AiTool]`。請參閱[自訂工具](https://ai-game.dev/zh-hant/docs/wiki/unity/custom-tools)。

### 如何新增對 Cinemachine、ProBuilder 或 Tilemaps 的支援？

從視窗的 **Extensions** 區段安裝對應的擴充功能，或使用 `unity-mcp-cli install-extension`。請參閱[擴充功能](https://ai-game.dev/zh-hant/docs/wiki/unity/extensions)。

### 在 Play 模式下也能運作嗎？

可以。代理可以透過 RQL（例如 `isPlaying` 等 `editor` 成員）進入與離開 Play 模式。網域重新載入後連線會自動重新建立。

## 組建、CI 與隱私

### 外掛會被打包進我的遊戲組建嗎？

執行階段部分會編譯進玩家組建中，但組建本身絕不會自行連線。你必須在程式碼中透過 `UnityMcpPluginRuntime.Initialize(...)` 主動啟用，才能在遊戲中提供 AI 工具。若要完全排除此外掛，請加入 `UNITY_MCP_EXCLUDE_FROM_COMPILATION` 指令碼定義。請參閱[設定](https://ai-game.dev/zh-hant/docs/wiki/unity/configuration#runtime)。

### 如何讓它不參與 CI 測試執行？

在 Unity 程序的環境中設定 `UNITY_MCP_DISABLE=1`，或使用 `UNITY_MCP_EXCLUDE_FROM_COMPILATION` 定義。請參閱[設定](https://ai-game.dev/zh-hant/docs/wiki/unity/configuration#ci)。

### 我可以在沒有 AI 用戶端的情況下用腳本操作嗎？

可以。`unity-mcp-cli run-tool` 可從終端機呼叫任何工具，而 `unity-mcp-cli exec` 則會在編輯器中執行 C#。請參閱 [CLI 參考文件](https://ai-game.dev/zh-hant/docs/wiki/unity/cli)。

### 哪些資料會離開我的機器？

在 Custom 模式下使用 `none` 或 `token` 授權時，不會有任何資料經過 ai-game.dev：代理程式與 Unity 是透過本機伺服器溝通。你的 AI 用戶端仍會將對話傳送給它自己的模型供應商。在 Cloud 模式下，工具呼叫與結果會在代理程式與編輯器之間傳遞時經過 ai-game.dev 伺服器。

### 我要如何為團隊關閉更新彈出視窗？

在 **Edit > Project Settings > AI Game Developer** 中啟用 **Disable update notifications for the entire team**，並提交 `ProjectSettings/AI-Game-Developer-UpdateSettings.asset`。

## 更多協助

- 發生錯誤時，請參閱[疑難排解](https://ai-game.dev/zh-hant/docs/wiki/unity/troubleshooting)。
- 全站[常見問題](https://ai-game.dev/docs/faq)與 [Unity 最佳實務](https://ai-game.dev/docs/best-practices/unity)。

---

Source (HTML): https://ai-game.dev/zh-hant/docs/wiki/unity/faq

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/docs/wiki/unity/faq