# Unreal Engine — AI Game Developer

為 Unreal Engine（5.5+）安裝 AI Game Developer 外掛。兩種安裝方式 — Fab 與 unreal-mcp-cli — 以及如何連接你的 AI 用戶端並執行第一個提示詞。

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

引擎 · Unreal Engine

把 Unreal-MCP 外掛安裝到你的 C++ 專案，用 AI 操控編輯器。

Unreal Engine 5.5+ 已於 5.7 測試 C++ 專案

01

## 安裝外掛

有兩種方式可將外掛加入你的專案 — 挑選最適合你工作流程的一種。

推薦

### CLI

透過 npm 上的 unreal-mcp-cli 工具安裝。目前可用於任何 UE 5.5+ 的 C++ 專案。

1 安裝 CLI

從 npm 全域安裝 unreal-mcp-cli。

`npm install -g unreal-mcp-cli`

2 安裝外掛

把 Unreal-MCP 外掛安裝到你的專案。

`unreal-mcp-cli install-plugin ./YourProject`

3 授權

登入後，外掛即可透過 ai-game.dev 連線。

`unreal-mcp-cli login ./YourProject`

4 開啟專案

在 Unreal Editor 中開啟專案。

`unreal-mcp-cli open ./YourProject`

即將推出

### Fab / Epic 商城

透過 Epic Games Launcher 從 Fab 安裝 Unreal-MCP——預先編譯，完全不需建置。目前尚未在 Fab 上架；上架前請改用 CLI 方式，現在就能用。

1 從 Fab 安裝

透過 Epic Games Launcher 從 Fab 安裝 Unreal-MCP。

2 啟用外掛程式

在編輯器中開啟 **Edit → Plugins**，找到 **Unreal-MCP** 並啟用它。

3 開啟專案

重新開啟你的專案——外掛程式已預先編譯，無需建置。

02

## 連接

透過託管的雲端端點執行，或指向你自己的伺服器。

### 雲端

預設

使用裝置碼 OAuth 流程透過 **ai-game.dev** 連接 — 不必手動複製權杖。在 AI Game Developer 視窗中選擇 **Cloud**，點擊 **Authorize**，並在瀏覽器中核准裝置碼。可穿越防火牆運作，並提供使用情形分析。這是預設方式，也是我們對大多數使用者的建議。

### 自訂

想全部在本機執行？將外掛指向你自己的 `gamedev-mcp-server` 執行個體，而非託管端點。你的 AI 用戶端便會直接與你的機器通訊。各用戶端的設定片段請見 [MCP 端點頁面](https://ai-game.dev/mcp-endpoint-info)。

需要用戶端設定片段（Claude、Cursor、Copilot、Gemini 等）？[參閱 MCP 端點頁面 →](https://ai-game.dev/mcp-endpoint-info)

03

## 設定你的 AI 代理

選擇你使用的 AI 代理，並複製可將其連接至 Unreal Engine MCP 伺服器的 `unreal-mcp-cli` 指令。

你的 AI 代理

**Claude Code**

在專案中執行以下指令，為 Unreal Engine 設定 **Claude Code**：

`unreal-mcp-cli setup-mcp claude-code --path ./YourProject`

**Claude Desktop**

在專案中執行以下指令，為 Unreal Engine 設定 **Claude Desktop**：

`unreal-mcp-cli setup-mcp claude-desktop --path ./YourProject`

**Cursor**

在專案中執行以下指令，為 Unreal Engine 設定 **Cursor**：

`unreal-mcp-cli setup-mcp cursor --path ./YourProject`

**VS Code (Copilot)**

在專案中執行以下指令，為 Unreal Engine 設定 **VS Code (Copilot)**：

`unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject`

**Visual Studio (Copilot)**

在專案中執行以下指令，為 Unreal Engine 設定 **Visual Studio (Copilot)**：

`unreal-mcp-cli setup-mcp vs-copilot --path ./YourProject`

**Rider (Junie)**

在專案中執行以下指令，為 Unreal Engine 設定 **Rider (Junie)**：

`unreal-mcp-cli setup-mcp rider-junie --path ./YourProject`

**GitHub Copilot CLI**

在專案中執行以下指令，為 Unreal Engine 設定 **GitHub Copilot CLI**：

`unreal-mcp-cli setup-mcp github-copilot-cli --path ./YourProject`

**Gemini**

在專案中執行以下指令，為 Unreal Engine 設定 **Gemini**：

`unreal-mcp-cli setup-mcp gemini --path ./YourProject`

**Antigravity**

在專案中執行以下指令，為 Unreal Engine 設定 **Antigravity**：

`unreal-mcp-cli setup-mcp antigravity --path ./YourProject`

**Cline**

在專案中執行以下指令，為 Unreal Engine 設定 **Cline**：

`unreal-mcp-cli setup-mcp cline --path ./YourProject`

**Open Code**

在專案中執行以下指令，為 Unreal Engine 設定 **Open Code**：

`unreal-mcp-cli setup-mcp open-code --path ./YourProject`

**Codex**

在專案中執行以下指令，為 Unreal Engine 設定 **Codex**：

`unreal-mcp-cli setup-mcp codex --path ./YourProject`

**Kilo Code**

在專案中執行以下指令，為 Unreal Engine 設定 **Kilo Code**：

`unreal-mcp-cli setup-mcp kilo-code --path ./YourProject`

**設定完成後請重新啟動你的代理。**新的 MCP 伺服器只有在代理完全重新啟動後才會被載入 — 請完全結束再重新開啟（不只是重新載入視窗）。

04

## 首次執行

開啟視窗、完成授權，然後試試你的第一個提示詞。

1. 從編輯器的 **Tools** 選單開啟 AI Game Developer 視窗。
2. 選擇 **Cloud** 並點擊 **Authorize** 以完成裝置碼流程。
3. 等到連線狀態變成綠色，再連接你的 AI 用戶端。
4. 試試下方這類提示詞，看看它在編輯器裡如何運作。

範例提示詞

```text
建立一個包含靜態網格立方體的新 Actor 藍圖，並在關卡中放置三個。
```

想要更多範例提示詞，以及有效 AI 請求的模式嗎？[查看 Unreal Engine 最佳實務 →](https://ai-game.dev/docs/best-practices/unreal)

[Unreal Engine 外掛會為你的 AI 用戶端提供 **90 個 MCP 工具**。](https://ai-game.dev/docs/tools/unreal)

瀏覽 Unreal Engine 工具目錄 →

想要更多工具嗎？[瀏覽 Unreal Engine 擴充功能 →](https://ai-game.dev/docs/extensions/unreal)

---

Source (HTML): https://ai-game.dev/zh-hant/engines/unreal

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