# 常見問題 — Unreal Engine · AI Game Developer Wiki

Unreal MCP 常見問題解答：支援的引擎版本、AI 用戶端、純 Blueprint 專案、Fab、離線使用、費用與打包後的遊戲。

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

針對 Unreal MCP（Unreal Engine 的 AI Game Developer 外掛）最常被問到的問題，提供簡短解答。設定步驟請參閱[安裝](https://ai-game.dev/zh-hant/docs/wiki/unreal/installation)與[入門指南](https://ai-game.dev/zh-hant/docs/wiki/unreal/getting-started)。

## 一般

### 什麼是 Unreal MCP？

這是一款 Unreal Editor 的 C++ 外掛，會把編輯器操作揭露為 MCP 工具，讓 Claude Code、Cursor、Copilot、Codex 或 Gemini 等 AI 代理能檢視並修改你的專案。它屬於 AI Game Developer 的一部分，與 [Unity](https://ai-game.dev/zh-hant/docs/wiki/unity) 和 [Godot](https://ai-game.dev/zh-hant/docs/wiki/godot) 外掛並列。

### 它穩定嗎？

目前為 **beta**。此外掛、其橋接程式、`unreal-mcp-cli` 與編輯器視窗皆已發布並在 CI 中測試，目前版本為 0.26.2。

### 哪些 AI 用戶端可以使用？

任何 MCP 用戶端皆可。`unreal-mcp-cli setup-mcp` 與編輯器的 AI agent 區段會為 Claude Code、Claude Desktop、Cursor、VS Code 與 Visual Studio Copilot、Rider (Junie)、GitHub Copilot CLI、Gemini、Antigravity、Cline、Open Code、Codex 與 Kilo Code 寫入設定檔，另外還有一份通用的 `custom` 設定。參見[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/unreal/connecting-ai-clients#agents)。

### 它能搭配 Claude Code 使用嗎？

可以。執行 `unreal-mcp-cli setup-mcp claude-code --path ./YourProject`，在專案資料夾中啟動 Claude Code，然後向它詢問你的關卡。詳細說明請見[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/unreal/connecting-ai-clients#claude-code)。

## 需求

### 支援哪些 Unreal Engine 版本？

Unreal Engine 5.5 及以上版本。各發行版會在 5.5、5.6、5.7 與 5.8 上驗證。選用的擴充功能則需要 5.7 或更新版本。

### 支援哪些作業系統？

Windows（x64）、macOS（Apple silicon 與 Intel）以及 Linux（x64）。

### 我可以在純 Blueprint 專案中使用嗎？

此外掛會針對你的專案進行編譯，因此專案需要 C++ 支援。先在專案中加入任一個 C++ 類別（這會讓專案變成 C++ 專案），然後再安裝此外掛。你仍可繼續用 Blueprint 打造遊戲，而代理也能替你撰寫 Blueprint。

### 我需要 Node.js 或 .NET 嗎？

使用 AI Game Dev 應用程式時不需要。`unreal-mcp-cli` 需要 Node.js。只有在從原始碼建置橋接程式時才需要 .NET 9 SDK；打包安裝版已內含。

## 安裝

### 它有在 Fab 或 Epic Marketplace 上架嗎？

目前尚未上架。Fab 上架已在規劃中。目前請使用 [AI Game Dev 應用程式](https://ai-game.dev/zh-hant/docs/wiki/app/installation) 或 `unreal-mcp-cli` 安裝。

### 我要如何更新？

在應用程式中，出現 **Update Package** 時點擊它；或執行 `unreal-mcp-cli update ./YourProject`，這也會一併清除舊的建置快取。參見[安裝](https://ai-game.dev/zh-hant/docs/wiki/unreal/installation#update)。

### 此外掛會進入我發行的遊戲中嗎？

編輯器工具絕不會：它們僅限編輯器使用。若要讓整個外掛（包含其橋接程式）都不進入打包組建，請在 `.uproject` 的外掛項目中加入 `TargetDenyList`，做法見[安裝](https://ai-game.dev/zh-hant/docs/wiki/unreal/installation#editor-only)。

## 使用方式

### AI 在 Unreal Editor 中實際能做什麼？

使用 RQL 查詢與變更 actor、component、資產、關卡、DataTable、gameplay tag、Project Settings、Blueprint 圖表、widget 與 Level Sequence；撰寫並編譯 Blueprint；讀取、寫入與編譯 C++；執行編輯器 Python；執行主控台指令；以及擷取螢幕截圖。參見[工具](https://ai-game.dev/zh-hant/docs/wiki/unreal/tools)。

### 我可以還原代理所做的操作嗎？

透過 `rql-mutate` 所做的變更各為一個復原步驟，因此在編輯器中按 **Ctrl+Z** 即可還原。Project Settings 寫入、gameplay tag 編輯與檔案變更（C++ 原始碼、已儲存的資產）不在復原記錄中。這些請使用版本控制。

### 有 Python 逃生出口嗎？

有。`python-execute` 會以完整的 `unreal` API 執行 Python，而 `unreal-mcp-cli exec` 可從終端機執行 Python。

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

可以，從任何 C++ 外掛皆可，無需分支 Unreal MCP。參見[自訂工具](https://ai-game.dev/zh-hant/docs/wiki/unreal/custom-tools)。

### AI 能控制我正在執行中的遊戲嗎？

可以，只要你選擇啟用。執行階段連線可在 Play In Editor、Standalone 與打包的 Development 組建中運作，預設為關閉，除非你自行編譯進去，否則會拒絕 Shipping 組建，且只會暴露你的遊戲所註冊的工具。參見[遊戲內工具](https://ai-game.dev/zh-hant/docs/wiki/unreal/custom-tools#runtime)。

## 帳號、隱私與費用

### 我需要 ai-game.dev 帳號嗎？

Cloud 模式需要：每台機器使用裝置代碼流程登入一次。在 Custom 模式下，你可以對本機的 `gamedev-mcp-server` 執行所有操作。參見[驗證](https://ai-game.dev/docs/auth)。

### 我可以完全離線或在本機作業嗎？

使用本機伺服器搭配 Custom 模式。請注意，你的 AI 用戶端本身可能仍需要自己的網際網路連線才能連到其模型供應商。

### 我的權杖儲存在哪裡？

機器登入資訊位於 `~/.ai-game-dev/credentials.json`；各專案設定則位於 `Saved/Config/UnrealMcp/`，版本控制預設會忽略此路徑。切勿將專案的 `.env` 檔提交到版本控制。請參閱[設定](https://ai-game.dev/zh-hant/docs/wiki/unreal/configuration#credentials)。

### 此外掛需要付費嗎？

此外掛與 `unreal-mcp-cli` 皆以 Apache-2.0 授權開源。你的 AI 用戶端本身的訂閱與 AI Game Developer 是分開的。

## 更多協助

- [疑難排解](https://ai-game.dev/zh-hant/docs/wiki/unreal/troubleshooting) 針對特定錯誤的說明。
- 一般 [FAQ](https://ai-game.dev/docs/faq) 與[快速入門](https://ai-game.dev/zh-hant/docs/quickstart)。
- [Unreal Engine 頁面](https://ai-game.dev/zh-hant/engines/unreal) 提供單頁總覽。

---

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

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