Конектори

Встановіть конектор, щоб ваш агент міг працювати всередині одного застосунку. Деякі конектори встановлюються один раз на комп'ютер, наприклад 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 (development snapshot).
• Material Maker: конектор створює та редагує графи матеріалів у папці й експортує набори текстур PBR для Blender, Godot, Unity або Unreal Engine. Кожен експорт ненадовго виводить Material Maker на передній план. Конектор працює з файлами графів, а не з відкритим вікном Material Maker. Закрийте граф у Material Maker, перш ніж агент його змінить, і попросіть агента відкрити результат, коли він завершить роботу.
• FreeCAD: конектор працює з документами в папці проєкту та запускає FreeCAD у фоновому режимі для кожного кроку. Він імпортує моделі GLB від Meshy як меші, поряд із STEP, IGES, STL та OBJ.
• Roblox Studio: оберіть папку, що містить один файл місця (.rbxl або .rbxlx). Конектор додає плагін Studio та відкриває місце (place). Моделі з Meshy зберігаються лише на час сесії Studio, оскільки Roblox не зберігає їх разом із місцем. Виконання Luau залишається вимкненим, доки ви не натиснете Allow Luau на панелі інструментів Meshy DCC.

Професійні застосунки

• Houdini: встановлюється один раз на версію Houdini, як пакет Houdini у ваших налаштуваннях Houdini. Коли встановлена ваша змінна HOME, Houdini бере папку налаштувань із неї.
• Maya: встановлюється один раз на комп'ютер, як модуль Maya. Моделі FBX від Meshy надходять із матеріалом Standard Surface та своїми текстурними картами.
• 3ds Max (Windows): встановлюється один раз на версію 3ds Max, як стартовий скрипт. Моделі FBX від Meshy надходять із матеріалом 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 із проєкту.
• Інші застосунки: запитайте свого агента. Він знає, які файли додав кожен конектор, і перелічує їх, перш ніж щось видалити.