unity-mcp-orchestrator

unity-mcp-orchestrator 技能利用模型上下文協定 (MCP) 為大型語言模型 (LLM) AI 助手與 Unity 編輯器之間提供完整的橋接。它專為希望將 AI 代理整合至遊戲開發流程的 Unity 開發者與工程師設計，能夠在 Claude、Cursor 或 VS Code 等 AI 環境中無縫控制編輯器操作。此技能透過將自然語言意圖轉化為結構化的 Unity Editor API 呼叫，簡化了場景構成、快速原型製作與工作流程自動化等複雜任務。

• 與 MCP 完全整合，建立 AI 助手與 Unity Editor API 之間的溝通橋樑。

• 進階遊戲物件 (GameObject) 管理：支援建立、修改與層級調整。

• 全面腳本支援：建立、修改、應用並驗證 C# 腳本，具備自動編譯追蹤功能。

• 強大的場景管理：執行多場景編輯、載入/卸載場景以及利用場景模板。

• 視覺驗證工具：從多個角度拍攝截圖、擷取場景檢視視角或進行以物件為中心的視覺審計。

• 批次處理能力：利用 batch_execute 功能平行處理多達 100 個操作，顯著提升效能。

• 診斷與偵錯支援：即時監控主控台日誌、編譯錯誤偵測以及透過 manage_profiler 進行效能分析。

• 廣泛支援 Unity 子系統，包括物理 (2D/3D)、圖形 (URP/後處理) 與 Cinemachine 攝影機。

• 務必遵循「資源優先」工作流程：在觸發修改工具前，先查閱編輯器狀態與場景資源。

• 修改腳本後，請在執行後續操作前，等待 AssetDatabase 自動完成編譯。

• 使用 manage_camera 工具並設定 include_image=True，為 AI 代理提供場景調整所需的視覺上下文。

• 針對高頻率或重複性任務優先使用 batch_execute，以減少延遲並提升 AI 代理互動效率。

• 請注意，模板與產生的腳本可能需要針對專案特定的套件版本（如 UGUI、TMP、Input System）進行驗證。

• 密切監控 editor_state，以便有效地處理如域重載 (domain reloads) 或編譯循環等阻塞操作。