Коннекторы

Установите коннектор, чтобы ваш агент мог работать внутри одного приложения. Некоторые коннекторы устанавливаются один раз на компьютер, например Blender. Другие устанавливаются один раз на проект, например Unity, Godot и Unreal Engine.

Обзор

Устанавливайте коннекторы со страницы Connectors окна Meshy DCC Core (meshy-dcc ui), либо попросите своего агента установить нужный. Meshy DCC Core проверяет каждую загрузку по её контрольной сумме SHA-256, прежде чем что-либо устанавливать.

В следующей таблице показано, куда устанавливается каждый коннектор и какие версии приложения он поддерживает.

Каждый коннектор работает на macOS (Apple Silicon) и Windows x64, кроме 3ds Max, который работает только на Windows.

Blender

Чтобы установить коннектор Blender, выполните следующие шаги:

1. На странице Connectors нажмите Install рядом с Blender.
2. Перезапустите Blender, если он открыт, либо запустите его как обычно.

Meshy DCC Core находит Blender в его обычных местах: /Applications/Blender.app на macOS и C:\Program Files\Blender Foundation на Windows. Если Blender находится в другом месте или у вас установлено несколько его копий, окно спросит, где он находится. Введите полный путь к приложению, которое хотите использовать, например /Applications/Blender 4.5.app.

Коннектор представляет собой расширение Blender с именем Meshy DCC. Оно запускается вместе с Blender, поэтому каждый открытый Blender появляется в разделе Connected now.

Чтобы установить его из терминала, выполните:

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

Если Blender находится не в обычном месте, добавьте --dcc-path <путь к Blender>.

Unity

Чтобы установить коннектор Unity в проект, выполните следующие шаги:

1. Закройте проект в Unity.
2. На странице Connectors нажмите Add to a project рядом с Unity, введите полный путь к папке проекта и нажмите Install.
3. Откройте проект в Unity как обычно.

Коннектор добавляет в проект пакет Meshy DCC Unity и папку .meshy-dcc. Он использует ту версию Unity Editor, которая указана в файле ProjectSettings/ProjectVersion.txt проекта, поэтому эта версия должна быть установлена в Unity Hub.

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

Godot

Чтобы установить коннектор Godot в проект, выполните следующие шаги:

1. Закройте проект в Godot.
2. На странице Connectors нажмите Add to a project рядом с Godot, введите полный путь к папке проекта и нажмите Install.
3. Откройте проект в Godot как обычно.

Коннектор добавляет аддон addons/meshy_dcc_godot, включает его и добавляет папку .meshy-dcc. Он находит Godot по вашей переменной PATH или как Godot.app в /Applications. Для другого расположения, а на 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. На странице Connectors нажмите Add to a project рядом с Unreal Engine, введите папку, содержащую файл .uproject, и нажмите Install.
3. Откройте проект как обычно.

Коннектор копирует плагин в папку Plugins/MeshyDccUnreal проекта и собирает его с помощью вашего движка, что занимает от нескольких секунд до нескольких минут. Для сборки вам потребуется:

• macOS: Xcode версии, которую принимает ваш движок. Unreal Engine 5.7 принимает Xcode вплоть до версии 26.
• Windows: Visual Studio 2022 с рабочей нагрузкой Game development with C++.

На Windows держите проект в папке, путь к которой содержит только английские буквы, цифры и знаки пунктуации. Unreal Engine не может собрать плагин при других символах, поэтому установка останавливается и откатывается.

Коннектор использует движок, версия которого соответствует версии движка проекта в Epic Games Launcher. Для сборки из исходников или для другого расположения задайте MESHY_DCC_UNREAL_ENGINE, указав папку движка. Unreal Engine 4 не поддерживается.

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

Другие приложения

Эти коннекторы устанавливаются так же: со страницы Connectors или командой meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: коннектор работает с файлами .scad в папке проекта и запускает OpenSCAD для каждого экспорта и предпросмотра, поэтому окно OpenSCAD не открывается. Он может разместить модель Meshy на печатном основании и экспортировать STL или 3MF. На Apple Silicon требуется снапшот разработческой версии OpenSCAD.
• Material Maker: коннектор создаёт и редактирует графы материалов в папке и экспортирует наборы PBR-текстур для Blender, Godot, Unity или Unreal Engine. Каждый экспорт ненадолго выводит Material Maker на передний план. Коннектор работает с файлами графов, а не с открытым окном Material Maker. Закройте граф в Material Maker перед тем, как агент будет его изменять, и попросите агента открыть результат, когда он будет готов.
• FreeCAD: коннектор работает с документами в папке проекта и запускает FreeCAD в фоновом режиме для каждого шага. Он импортирует модели Meshy в формате GLB как меши, наряду со STEP, IGES, STL и OBJ.
• Roblox Studio: выберите папку, содержащую один файл места (place) (.rbxl или .rbxlx). Коннектор добавляет плагин Studio и открывает это место. Модели от Meshy сохраняются только на время сессии Studio, так как Roblox не сохраняет их вместе с местом. Выполнение Luau остаётся отключённым, пока вы не нажмёте Allow Luau на панели инструментов Meshy DCC.

Профессиональные приложения

• 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: выберите папку проекта. Агент работает в экземпляре ZBrush, который Meshy DCC Core запускает для этой папки, а не в том, который вы открыли сами. Если первый запуск завершился по тайм-ауту, запустите его снова.

Работа в нескольких приложениях одновременно

Каждое открытое приложение и каждая открытая копия приложения — это отдельный экземпляр со своим ID. Агент называет экземпляр, в котором работает. Когда под ваш запрос подходит больше одного экземпляра, агент спрашивает, какой именно вы имеете в виду. Когда вы перезапускаете приложение, оно получает новый ID, и агент находит его снова.

Удаление коннектора

Проще всего попросить об этом своего агента. Чтобы удалить коннектор самостоятельно, выполните одно из следующих действий:

• Blender: в разделе Edit > Preferences > Get Extensions найдите Meshy DCC и удалите его.
• Unity: удалите пакет Meshy DCC Unity в Package Manager, затем удалите папку .meshy-dcc проекта.
• Godot: удалите addons/meshy_dcc_godot и .meshy-dcc из проекта.
• Unreal Engine: удалите Plugins/MeshyDccUnreal и .meshy-dcc из проекта.
• Другие приложения: спросите своего агента. Он знает, какие файлы добавил каждый коннектор, и перечислит их перед тем, как что-либо удалить.