# 專案與引擎 — AI Game Dev 應用程式與 CLI · AI Game Developer Wiki

在 AI Game Dev 應用程式中開啟或建立 Unity、Unreal 或 Godot 專案、安裝引擎外掛，並讓代理在需要時開啟編輯器。

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

AI Game Dev 應用程式裡的一切都在專案中進行：專案就是你電腦上的一個資料夾。當這個資料夾是 Unity、Unreal Engine 或 Godot 專案時，應用程式會偵測引擎、設定對應的 MCP 外掛，並把編輯器的工具連接到你的對話中。本頁說明如何在桌面應用程式與 CLI 中開啟及建立專案、外掛的安裝與更新，以及代理如何與編輯器協同運作。

## 支援的引擎

| 引擎 | 外掛 | 應用程式如何辨識專案 | 支援的版本 |
| --- | --- | --- | --- |
| Unity | [Unity MCP](https://ai-game.dev/zh-hant/docs/wiki/unity) | `ProjectSettings/ProjectVersion.txt`，或含有 `Packages/manifest.json` 的 `Assets/` 資料夾 | Unity 2022.3 LTS 或更新版本 |
| Unreal Engine | [Unreal MCP](https://ai-game.dev/zh-hant/docs/wiki/unreal) | 資料夾中含有 `*.uproject` 檔案 | Unreal Engine 5.5 或更新版本，C++ 專案 |
| Godot | [Godot MCP](https://ai-game.dev/zh-hant/docs/wiki/godot) | 資料夾中含有 `project.godot` 檔案 | Godot 4.3 至 4.5（.NET） |

你也可以開啟任何其他資料夾，例如只有 Blender 素材的專案、設計文件資料夾或工具儲存庫。此時代理仍可處理檔案、套件與工具，只是沒有引擎工具可用。

## 在桌面應用程式中開啟專案

空白視窗就是啟動器，提供：

- **Open folder…** 用來選擇專案資料夾。
- **Create new project** 用來建立新的 Unity、Unreal 或 Godot 專案。
- 你最近的專案。

每個專案都有自己的視窗。在最近的專案上按 Ctrl 點擊（Windows、Linux）或 Cmd 點擊（macOS），即可在新視窗中開啟，而不會取代目前的視窗。當你重新啟動應用程式時，每個先前開啟的專案視窗都會以原本的大小、位置與版面配置恢復。

## 安裝或更新引擎外掛

開啟引擎專案後，側邊欄會顯示該專案的引擎及其操作：

- 專案中還沒有引擎外掛時顯示 **Install Package**；有較新的外掛版本時顯示 **Update Package**。
- **Open Editor** 用來為此專案啟動引擎編輯器。

點擊 **Install Package** 即可加入外掛。應用程式絕不會自行變更既有的專案：點擊即代表你的同意，因為安裝會寫入你的專案（例如在 Unity 中會把套件加入 `Packages/manifest.json`）。若是從應用程式建立的專案，外掛會在建立過程中自動安裝。

外掛安裝程式隨應用程式一起提供：你的電腦不需要安裝 Node.js、npm、`unity-mcp-cli`、`unreal-mcp-cli` 或 `godot-cli`。

在 CLI 中，相同的操作以斜線指令執行：

```text
/install-plugin            install the MCP plugin into the current project
/install-plugin C:/Games/MyGame
/open                      open the editor for the current project
```

## 引擎擴充功能

引擎擴充功能會為外掛加入更多工具，例如 Unity 的粒子系統或動畫專用工具。你可以在桌面應用程式的側邊欄擴充功能操作中瀏覽並安裝，或在 CLI 中使用 `/install-extension`。[擴充功能頁面](https://ai-game.dev/docs/extensions)列出每個引擎可用的項目。

## 建立新專案

在桌面應用程式中，選擇 **Create new project**：

1. 選擇引擎。
2. 輸入專案名稱。專案會建立在你所選父資料夾之下、以該名稱為名的子資料夾中；缺少的資料夾會自動建立。
3. 選擇編輯器：會預先選取已安裝的最新版本，你也可以手動選擇已安裝的編輯器。若該引擎沒有任何已安裝的編輯器，應用程式會提示；請先安裝引擎再繼續。
4. 應用程式會建立專案、安裝外掛並開啟專案。

在 CLI 中：

```text
/create-project unity SkywardKeep
/create-project godot SkywardKeep D:/Games
```

語法為 `/create-project <unity|godot|unreal> <name> [parentDir]`。

## 代理如何與編輯器協同運作

你可以在編輯器執行之前就開始對話。一般討論絕不會啟動任何東西。當代理某項任務需要編輯器時，它會請應用程式開啟該專案的編輯器，等到編輯器的工具可用後，再繼續同一項任務。若編輯器在 session 進行中才上線（例如你自己開啟了它），它會連上正在進行的對話，而不會另開新對話。

以下幾項規則讓這個流程可預期：

- 每個專案只會啟動一個編輯器，即使同時有多個 session 需要它。
- 中斷連線後，已經送出的引擎呼叫絕不會自動重播；代理會先確認結果，再嘗試下一次寫入。
- **Stop** 會取消等待編輯器。已經啟動的編輯器會保持開啟。
- 啟動大型專案可能需要一段時間。啟動最多給予 15 分鐘，之後再給予最多 2 分鐘等待工具出現。

**提示**

在開始漫長的 session 之前先開啟編輯器，可以省下第一個引擎步驟的啟動等待時間。

## 在編輯器內部

每個外掛在編輯器中都有自己的視窗（Unity 是 **AI Game Developer** 視窗），會顯示連線狀態。當應用程式開啟編輯器時，會傳遞你已登入的工作階段，因此外掛會透過 ai-game.dev 連線，不需要手動輸入權杖。如果編輯器顯示「Disconnected」，請開啟該視窗、選擇 **Cloud** 並點擊 **Authorize**，然後等待顯示 **Ready**。

各引擎的外掛專屬設定、手動安裝以及連接其他 AI 用戶端，分別收錄在各引擎的 wiki 中：

- Unity：[安裝](https://ai-game.dev/zh-hant/docs/wiki/unity/installation)、[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/unity/connecting-ai-clients)、[`unity-mcp-cli`](https://ai-game.dev/zh-hant/docs/wiki/unity/cli)。
- Unreal：[安裝](https://ai-game.dev/zh-hant/docs/wiki/unreal/installation)、[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/unreal/connecting-ai-clients)、[`unreal-mcp-cli`](https://ai-game.dev/zh-hant/docs/wiki/unreal/cli)。
- Godot：[安裝](https://ai-game.dev/zh-hant/docs/wiki/godot/installation)、[連接 AI 用戶端](https://ai-game.dev/zh-hant/docs/wiki/godot/connecting-ai-clients)、[`godot-cli`](https://ai-game.dev/zh-hant/docs/wiki/godot/cli)。

## 在 CLI 中開啟專案

CLI 會作用於目前所在的目錄，或你指定的資料夾：

```bash
cd /path/to/your/game
gamedev

# or
gamedev /path/to/your/game
gamedev --project /path/to/your/game
```

啟動時，CLI 會說明它偵測到什麼，例如「偵測到 Unity 專案」，或是該資料夾中沒有 Unity、Godot 或 Unreal 專案。

## 代理能在你的專案中做什麼

連接引擎後，就能用自然語言提出請求，例如：

- 「列出作用中場景中的所有項目。」
- 「在原点建立一個立方體，並給它一個物理剛體。」
- 「對目前檢視畫面截圖。」

[工具目錄](https://ai-game.dev/docs/tools) 列出了所有引擎工具，[最佳實務](https://ai-game.dev/docs/best-practices) 則說明如何撰寫有效的請求。各引擎頁面 [Unity](https://ai-game.dev/zh-hant/engines/unity)、[Unreal](https://ai-game.dev/zh-hant/engines/unreal) 與 [Godot](https://ai-game.dev/zh-hant/engines/godot) 分別概述了各項整合。

---

Source (HTML): https://ai-game.dev/zh-hant/docs/wiki/app/projects-and-engines

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/docs/wiki/app/projects-and-engines