連接器

安裝連接器後，智能體就能在對應的軟體中工作。有些連接器每台電腦裝一次，例如 Blender；有些連接器每個專案裝一次，例如 Unity、Godot 和 Unreal Engine。

概述

在 Meshy DCC Core 視窗（meshy-dcc ui）的 連接器 頁面中安裝連接器，也可以讓智能體幫你安裝。安裝之前，Meshy DCC Core 會用 SHA-256 校驗碼逐一驗證下載的檔案。

下表列出了各連接器的安裝位置，以及支援的軟體版本。

除 3ds Max 只支援 Windows 外，所有連接器都支援 macOS（Apple 晶片）和 Windows x64。

Blender

按以下步驟安裝 Blender 連接器：

1. 在 連接器 頁面中，點擊 Blender 旁邊的 安裝。
2. 如果 Blender 已經打開，請重新啟動它；否則像平常一樣啟動即可。

Meshy DCC Core 會在常見位置尋找 Blender：macOS 上是 /Applications/Blender.app，Windows 上是 C:\Program Files\Blender Foundation。如果 Blender 裝在其他位置，或者你裝了多個版本，視窗會詢問它在哪裡。輸入你要使用的那個 Blender 的完整路徑，例如 /Applications/Blender 4.5.app。

這個連接器是一個名為 Meshy DCC 的 Blender 擴充功能。它隨 Blender 一起啟動，所以你打開的每個 Blender 都會出現在 當前已連接 下。

也可以在終端機中執行以下命令安裝：

meshy-dcc install --dcc-type blender --execute

如果 Blender 不在常見位置，請加上 --dcc-path <Blender 的路徑>。

Unity

按以下步驟在專案中安裝 Unity 連接器：

1. 在 Unity 中關閉這個專案。
2. 在 連接器 頁面中，點擊 Unity 旁邊的 裝入專案，輸入專案資料夾的完整路徑，然後點擊 安裝。
3. 像平常一樣在 Unity 中打開專案。

連接器會在專案中新增 Meshy DCC Unity 套件和一個 .meshy-dcc 資料夾。它使用專案的 ProjectSettings/ProjectVersion.txt 中指定的 Unity Editor 版本，所以這個版本必須已經在 Unity Hub 中安裝。

meshy-dcc install --dcc-type unity --project /path/to/project --execute

Godot

按以下步驟在專案中安裝 Godot 連接器：

1. 在 Godot 中關閉這個專案。
2. 在 連接器 頁面中，點擊 Godot 旁邊的 裝入專案，輸入專案資料夾的完整路徑，然後點擊 安裝。
3. 像平常一樣在 Godot 中打開專案。

連接器會新增並啟用 addons/meshy_dcc_godot 外掛，並新增一個 .meshy-dcc 資料夾。它會在你的 PATH 中，或在 /Applications 中以 Godot.app 的名稱尋找 Godot。如果 Godot 在其他位置，以及在 Windows 上，請把 MESHY_DCC_GODOT_EXECUTABLE 環境變數設定為 Godot 編輯器的路徑。

meshy-dcc install --dcc-type godot --project /path/to/project --execute

Unreal Engine

按以下步驟在專案中安裝 Unreal Engine 連接器：

1. 在 Unreal Engine 中關閉這個專案。
2. 在 連接器 頁面中，點擊 Unreal Engine 旁邊的 裝入專案，輸入包含 .uproject 檔案的資料夾，然後點擊 安裝。
3. 像平常一樣打開專案。

連接器會把一個外掛複製到專案的 Plugins/MeshyDccUnreal 資料夾，並用你的引擎編譯它，耗時從幾秒到幾分鐘不等。編譯需要：

• macOS：你的引擎支援的 Xcode 版本。Unreal Engine 5.7 支援到 Xcode 26。
• Windows：安裝了 使用 C++ 的遊戲開發（Game development with C++）工作負載的 Visual Studio 2022。

在 Windows 上，專案所在資料夾的路徑只能包含英文字母、數字和標點。路徑中有其他字元（包括中文）時，Unreal Engine 無法編譯外掛，安裝會停止並回滾。

連接器使用 Epic Games 啟動器中與專案引擎版本相符的引擎。如果你用的是原始碼編譯的引擎，或者引擎在其他位置，請把 MESHY_DCC_UNREAL_ENGINE 設定為引擎資料夾。不支援 Unreal Engine 4。

meshy-dcc install --dcc-type unreal --project /path/to/project --execute

更多軟體

以下連接器的安裝方式相同：在 連接器 頁面中安裝，或執行 meshy-dcc install --dcc-type <軟體> --project <資料夾> --execute。

• OpenSCAD：連接器處理專案資料夾中的 .scad 檔案，每次匯出和預覽時在背景執行 OpenSCAD，不會打開 OpenSCAD 視窗。它可以把 Meshy 模型立在列印底座上，並匯出 STL 或 3MF。在 Apple 晶片的 Mac 上，需要使用 OpenSCAD 開發快照版。
• Material Maker：連接器在一個資料夾中建立和編輯材質節點圖，並為 Blender、Godot、Unity 或 Unreal Engine 匯出 PBR 貼圖集。每次匯出時，Material Maker 會短暫切換到前景。連接器處理的是節點圖檔案，而不是已打開的 Material Maker 視窗。在智能體修改某個節點圖之前，請先在 Material Maker 中關閉它；完成後，可以讓智能體幫你打開結果。
• FreeCAD：連接器處理專案資料夾中的文件，每一步都在背景執行 FreeCAD。它可以把 Meshy 的 GLB 模型作為網格匯入，也支援 STEP、IGES、STL 和 OBJ。
• Roblox Studio：選擇一個只包含一個 place 檔案（.rbxl 或 .rbxlx）的資料夾。連接器會新增一個 Studio 外掛並打開這個 place。來自 Meshy 的模型只在本次 Studio 工作階段中保留，因為 Roblox 不會把它們儲存到 place 中。在你點擊 Meshy DCC 工具列中的 Allow Luau 之前，執行 Luau 的功能保持關閉。

專業軟體

• Houdini：每個 Houdini 版本安裝一次，以 Houdini 套件的形式裝在你的 Houdini 偏好設定中。如果設定了 HOME 變數，Houdini 會根據它決定偏好設定資料夾。
• Maya：每台電腦安裝一次，以 Maya 模組的形式安裝。Meshy 的 FBX 模型匯入後會帶上 Standard Surface 材質和各張貼圖。
• 3ds Max（Windows）：每個 3ds Max 版本安裝一次，以啟動腳本的形式安裝。Meshy 的 FBX 模型匯入後會帶上 Physical 材質。
• Substance 3D Painter：每台電腦安裝一次，以啟動外掛的形式安裝。智能體可以用 Meshy 模型新建專案、新增 PBR 圖層並匯出貼圖。
• ZBrush：選擇一個專案資料夾。智能體在 Meshy DCC Core 為這個資料夾啟動的 ZBrush 中工作，而不是你自己打開的 ZBrush。如果第一次啟動逾時，再啟動一次即可。

同時使用多個軟體

每個已打開的軟體，以及同一軟體的每個已打開副本，都是一個獨立的實例，有自己的 ID。智能體會指明它在哪個實例中工作。如果有多個實例都符合你的請求，智能體會問你指的是哪一個。軟體重新啟動後會得到新的 ID，智能體會重新找到它。

解除安裝連接器

最簡單的方法是讓智能體幫你解除安裝。如果想自己解除安裝，可以按軟體分別操作：

• Blender：在 Edit > Preferences > Get Extensions 中找到 Meshy DCC 並解除安裝。
• Unity：在 Package Manager 中移除 Meshy DCC Unity 套件，然後刪除專案中的 .meshy-dcc 資料夾。
• Godot：從專案中刪除 addons/meshy_dcc_godot 和 .meshy-dcc。
• Unreal Engine：從專案中刪除 Plugins/MeshyDccUnreal 和 .meshy-dcc。
• 其他軟體：讓智能體幫你解除安裝。它知道每個連接器新增了哪些檔案，並會在刪除之前先列出來。