连接器

安装连接器后，智能体就能在对应的软件中工作。有些连接器每台电脑装一次，例如 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。
• 其他软件：让智能体帮你卸载。它知道每个连接器添加了哪些文件，并会在删除之前先列出来。