用于Maya的Verge3D：安装 - Soft8Soft
Description: 本章节介绍了Maya版Verge3D的安装过程。了解如何在Windows、macOS和Linux上安装和设置Verge3D for Maya。

# 安装 / Maya

- 先决条件
- 在Windows系统中安装Verge3D
- 在macOS系统中安装Verge3D
- 在Linux系统中安装Verge3D
- 手动配置插件路径

#

## 先决条件

### Maya

Verge3D可运行于Autodesk Maya 2023-2026之上，您需要预先安装Autodesk Maya。我们建议使用最新兼容版本的Maya以获得最佳效果和更长的可用期限。

### 操作系统

我们建议在Windows 10/11，或最新版本的macOS，或最新的RedHat/CentOS/Fedora Linux上使用Verge3D。请确保您安装了最新的显卡驱动。安装Verge3D时不需要管理员权限。

### 网络浏览器

Verge3D可以在任何浏览器中工作，如Chrome, Firefox, Opera或Edge。但我们建议使用Chrome浏览器进行开发，因为它速度快，并提供优秀的开发工具。可以将其设置为默认浏览器，以便于预览。

#

## 在Windows系统中安装Verge3D

下载Verge3D安装包，双击 .exe 文件以运行安装程序。

按照链接阅读最新版本的Verge3D许可协议。

选择您要安装的组件。

选择一个有足够读写权限的安装目录（建议使用默认路径）。

等待安装程序完成文件复制到目标目录。

安装完成后，您将看到以下界面。

现在可以打开Maya。如果Maya正在运行，请先关闭然后再次打开。现在进入 Plug-in Manager 设置...

...激活 verge3d.py 插件，并启用 Loaded 和 Auto load 复选框。

此外，如果您想通过菜单 File → Export All... 来导出Verge3D场景，请激活 gltfExport.py 插件。启用 gltfExport.py 会在 Export All 对话框中增加 Verge3D GLTF 文件类型选项。

现在您应该可以在主菜单栏中看到Verge3D菜单了。

现在，您也可以通过桌面或开始菜单中的Verge3D快捷方式图标来打开应用管理器，这种启动方式无需启动Maya。

#

## 在macOS系统中安装Verge3D

下载Verge3D安装包，双击 .pkg 文件以运行安装程序。

按照链接阅读最新版本的Verge3D许可协议。

然后点击 Agree 以接受协议。

您可以快速跳过下一个阶段，因为Verge3D在macOS上始终安装到用户主目录中。

等待安装程序完成文件复制。

安装完成后，您将看到以下界面。

点击 Close 并启动Maya。如果Maya正在运行，请先关闭然后再次打开。

现在进入 Plug-in Manager 设置

并勾选 Loaded 和 Auto load 复选框，激活 verge3d.py 插件。

此外，如果您想通过菜单 File → Export All... 来导出Verge3D场景，请激活 gltfExport.py 插件。启用 gltfExport.py 插件会在 Export All 对话框中增加 Verge3D GLTF 文件类型选项。

现在您应该可以在主菜单栏中看到 Verge3D 菜单了。

您也可以在不运行Maya的情况下启动应用管理器，方法是点击 Launchpad 图标：

或者您可以将该启动器直接拖放到 macOS Dock 上以便快速访问：

#

## 在Linux系统中安装Verge3D

下载Verge3D 的XZ压缩包，并将其解压到自定义目录中。请确保您有足够的权限在此文件夹中进行读/写操作。不建议在系统目录中安装。

现在打开Maya进入 Plug-in Manager 中设置...

点击 Browse 按钮

然后找到 Verge3D安装路径/maya_plugin/setup 目录并打开 install.py 脚本。

重启Maya，再次打开 Plug-in Manager，请勾选 Loaded 和 Auto load 复选框，激活 verge3d.py 插件。

此外，如果您想通过菜单 File → *Export All...* 来导出Verge3D场景，请激活 gltfExport.py 插件。 启用 gltfExport.py 插件会在 导出全部 对话框的文件类型中增加 Verge3D GLTF 选项。

现在您应该可以在主菜单栏中看到Verge3D菜单了。

#

## 手动配置插件路径

有时Verge3D菜单并不显示。这可能有多种原因造成：

- 您在安装过程中，禁用了Auto-Configure（自动配置）选项。
- 您安装运行了一个不被支持的Maya版本。
- 您更换了Windows用户。

在这种情况下，可以使用以下流程来手动配置插件路径。

找到名为Maya.env的文件，它通常位于如下文件夹中：

- Windows - \Users\user\Documents\maya\VERSION
- macOS - $HOME/Library/Preferences/Autodesk/maya/VERSION
- Linux - $HOME/maya/VERSION

编辑该文件以指定MAYA_PLUGIN_PATH环境变量，如下所示。

`MAYA_PLUG_IN_PATH=\Users\user\verge3d_maya\maya_plugin`

保存该文件并打开Maya。如果Maya正在运行，请先关闭然后再次打开。在插件管理器设置对话框中找到 Verge3D 插件。点击开启 Loaded 和 Auto load 复选框。现在您应该可以在主菜单栏中看到Verge3D菜单了。

## 向前一步

推荐您熟悉一下 入门指南 并开始探索！

## 遇到问题？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。