常見問題

針對 Unreal MCP（Unreal Engine 的 AI Game Developer 外掛）最常被問到的問題，提供簡短解答。設定步驟請參閱安裝與入門指南。

一般#

什麼是 Unreal MCP？#

這是一款 Unreal Editor 的 C++ 外掛，會把編輯器操作揭露為 MCP 工具，讓 Claude Code、Cursor、Copilot、Codex 或 Gemini 等 AI 代理能檢視並修改你的專案。它屬於 AI Game Developer 的一部分，與 Unity 和 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 用戶端。

它能搭配 Claude Code 使用嗎？#

可以。執行 unreal-mcp-cli setup-mcp claude-code --path ./YourProject，在專案資料夾中啟動 Claude Code，然後向它詢問你的關卡。詳細說明請見連接 AI 用戶端。

需求#

支援哪些 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 應用程式 或 unreal-mcp-cli 安裝。

我要如何更新？#

在應用程式中，出現 Update Package 時點擊它；或執行 unreal-mcp-cli update ./YourProject，這也會一併清除舊的建置快取。參見安裝。

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

編輯器工具絕不會：它們僅限編輯器使用。若要讓整個外掛（包含其橋接程式）都不進入打包組建，請在 .uproject 的外掛項目中加入 TargetDenyList，做法見安裝。

使用方式#

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

使用 RQL 查詢與變更 actor、component、資產、關卡、DataTable、gameplay tag、Project Settings、Blueprint 圖表、widget 與 Level Sequence；撰寫並編譯 Blueprint；讀取、寫入與編譯 C++；執行編輯器 Python；執行主控台指令；以及擷取螢幕截圖。參見工具。

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

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

有 Python 逃生出口嗎？#

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

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

可以，從任何 C++ 外掛皆可，無需分支 Unreal MCP。參見自訂工具。

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

可以，只要你選擇啟用。執行階段連線可在 Play In Editor、Standalone 與打包的 Development 組建中運作，預設為關閉，除非你自行編譯進去，否則會拒絕 Shipping 組建，且只會暴露你的遊戲所註冊的工具。參見遊戲內工具。

帳號、隱私與費用#

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

Cloud 模式需要：每台機器使用裝置代碼流程登入一次。在 Custom 模式下，你可以對本機的 gamedev-mcp-server 執行所有操作。參見驗證。

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

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

我的權杖儲存在哪裡？#

機器登入資訊位於 ~/.ai-game-dev/credentials.json；各專案設定則位於 Saved/Config/UnrealMcp/，版本控制預設會忽略此路徑。切勿將專案的 .env 檔提交到版本控制。請參閱設定。

此外掛需要付費嗎？#

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

更多協助#

• 疑難排解 針對特定錯誤的說明。
• 一般 FAQ 與快速入門。
• Unreal Engine 頁面 提供單頁總覽。