專案與引擎

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

支援的引擎#

你也可以開啟任何其他資料夾，例如只有 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 中，相同的操作以斜線指令執行：

/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。擴充功能頁面列出每個引擎可用的項目。

建立新專案#

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

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

在 CLI 中：

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

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

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

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

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

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

在編輯器內部#

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

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

• Unity：安裝、連接 AI 用戶端、unity-mcp-cli。
• Unreal：安裝、連接 AI 用戶端、unreal-mcp-cli。
• Godot：安裝、連接 AI 用戶端、godot-cli。

在 CLI 中開啟專案#

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

cd /path/to/your/game
gamedev

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

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

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

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

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

工具目錄 列出了所有引擎工具，最佳實務 則說明如何撰寫有效的請求。各引擎頁面 Unity、Unreal 與 Godot 分別概述了各項整合。