Łączniki

Zainstaluj łącznik, aby Twój agent mógł działać wewnątrz jednej aplikacji. Niektóre łączniki instaluje się raz na komputer, jak Blender. Inne instaluje się raz na projekt, jak Unity, Godot i Unreal Engine.

Przegląd

Instaluj łączniki ze strony Connectors w oknie Meshy DCC Core (meshy-dcc ui) lub poproś swojego agenta o instalację. Meshy DCC Core sprawdza każdy pobrany plik względem sumy kontrolnej SHA-256, zanim cokolwiek zainstaluje.

Poniższa tabela pokazuje, gdzie instaluje się każdy łącznik i które wersje danej aplikacji obsługuje.

Każdy łącznik działa na macOS (Apple Silicon) i Windows x64, z wyjątkiem 3ds Max, który działa tylko na Windows.

Blender

Aby zainstalować łącznik Blender, wykonaj następujące kroki:

1. Na stronie Connectors kliknij Install obok Blendera.
2. Uruchom ponownie Blender, jeśli jest otwarty, lub uruchom go jak zwykle.

Meshy DCC Core wyszukuje Blender w typowych lokalizacjach: /Applications/Blender.app na macOS i C:\Program Files\Blender Foundation na Windows. Jeśli Blender znajduje się gdzie indziej albo masz więcej niż jedną kopię, okno zapyta, gdzie się znajduje. Wpisz pełną ścieżkę do aplikacji, której chcesz użyć, na przykład /Applications/Blender 4.5.app.

Łącznik jest rozszerzeniem Blendera o nazwie Meshy DCC. Uruchamia się razem z Blenderem, więc każdy otwarty Blender pojawia się w sekcji Connected now.

Aby zainstalować go z terminala, uruchom:

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

Gdy Blender nie znajduje się w typowej lokalizacji, dodaj --dcc-path <ścieżka do Blendera>.

Unity

Aby zainstalować łącznik Unity w projekcie, wykonaj następujące kroki:

1. Zamknij projekt w Unity.
2. Na stronie Connectors kliknij Add to a project obok Unity, wpisz pełną ścieżkę do folderu projektu i kliknij Install.
3. Otwórz projekt w Unity jak zwykle.

Łącznik dodaje do projektu pakiet Meshy DCC Unity oraz folder .meshy-dcc. Korzysta z wersji Unity Editor wskazanej w pliku ProjectSettings/ProjectVersion.txt projektu, więc ta wersja musi być zainstalowana w Unity Hub.

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

Godot

Aby zainstalować łącznik Godot w projekcie, wykonaj następujące kroki:

1. Zamknij projekt w Godot.
2. Na stronie Connectors kliknij Add to a project obok Godot, wpisz pełną ścieżkę do folderu projektu i kliknij Install.
3. Otwórz projekt w Godot jak zwykle.

Łącznik dodaje dodatek addons/meshy_dcc_godot, włącza go i dodaje folder .meshy-dcc. Znajduje Godot na Twojej zmiennej PATH lub jako Godot.app w /Applications. Dla innej lokalizacji, a na Windows zawsze, ustaw zmienną środowiskową MESHY_DCC_GODOT_EXECUTABLE na edytor Godot.

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

Unreal Engine

Aby zainstalować łącznik Unreal Engine w projekcie, wykonaj następujące kroki:

1. Zamknij projekt w Unreal Engine.
2. Na stronie Connectors kliknij Add to a project obok Unreal Engine, wpisz folder zawierający plik .uproject i kliknij Install.
3. Otwórz projekt jak zwykle.

Łącznik kopiuje wtyczkę do folderu projektu Plugins/MeshyDccUnreal i buduje ją za pomocą Twojego silnika, co zajmuje od kilku sekund do kilku minut. Aby ją zbudować, potrzebujesz:

• macOS: Xcode, w wersji akceptowanej przez Twój silnik. Unreal Engine 5.7 akceptuje Xcode do wersji 26.
• Windows: Visual Studio 2022 z obciążeniem roboczym Game development with C++.

Na Windows trzymaj projekt w folderze, którego ścieżka zawiera wyłącznie angielskie litery, cyfry i znaki interpunkcyjne. Unreal Engine nie potrafi zbudować wtyczki przy innych znakach, więc instalacja zatrzymuje się i jest wycofywana.

Łącznik używa silnika, który odpowiada wersji silnika projektu w Epic Games Launcher. W przypadku kompilacji ze źródeł lub innej lokalizacji ustaw MESHY_DCC_UNREAL_ENGINE na folder silnika. Unreal Engine 4 nie jest obsługiwany.

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

Więcej aplikacji

Te łączniki instaluje się w ten sam sposób: ze strony Connectors albo za pomocą meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: łącznik działa na plikach .scad w folderze projektu i uruchamia OpenSCAD przy każdym eksporcie oraz podglądzie, więc żadne okno OpenSCAD się nie otwiera. Może umieścić model Meshy na podstawie druku i wyeksportować STL lub 3MF. Na Apple Silicon wymaga deweloperskiej migawki OpenSCAD.
• Material Maker: łącznik buduje i edytuje grafy materiałów w folderze oraz eksportuje zestawy tekstur PBR dla Blendera, Godota, Unity lub Unreal Engine. Każdy eksport na chwilę przenosi Material Maker na pierwszy plan. Łącznik działa na plikach grafów, a nie na otwartym oknie Material Maker. Zamknij graf w Material Maker, zanim agent go zmieni, i poproś agenta, aby otworzył dla Ciebie wynik, gdy skończy.
• FreeCAD: łącznik działa na dokumentach w folderze projektu i uruchamia FreeCAD w tle przy każdym kroku. Importuje modele GLB z Meshy jako siatki, obok STEP, IGES, STL i OBJ.
• Roblox Studio: wybierz folder zawierający jeden plik miejsca (.rbxl lub .rbxlx). Łącznik dodaje wtyczkę Studio i otwiera miejsce. Modele z Meshy trwają tylko przez czas sesji Studio, ponieważ Roblox nie zapisuje ich razem z miejscem. Uruchamianie Luau pozostaje wyłączone, dopóki nie klikniesz Allow Luau na pasku narzędzi Meshy DCC.

Aplikacje profesjonalne

• Houdini: instaluje się raz na wersję Houdini, jako pakiet Houdini w Twoich preferencjach Houdini. Gdy ustawiona jest zmienna HOME, Houdini pobiera z niej folder preferencji.
• Maya: instaluje się raz na komputer, jako moduł Maya. Modele FBX z Meshy są importowane z materiałem Standard Surface i swoimi mapami tekstur.
• 3ds Max (Windows): instaluje się raz na wersję 3ds Max, jako skrypt startowy. Modele FBX z Meshy są importowane z materiałem Physical.
• Substance 3D Painter: instaluje się raz na komputer, jako wtyczka startowa. Agent może rozpocząć projekt od modelu Meshy, dodać warstwy PBR i wyeksportować tekstury.
• ZBrush: wybierz folder projektu. Agent działa w ZBrushu, który Meshy DCC Core uruchamia dla tego folderu, a nie w tym, który sam otworzyłeś. Jeśli pierwsze uruchomienie przekroczy limit czasu, uruchom je ponownie.

Praca w kilku aplikacjach jednocześnie

Każda otwarta aplikacja i każda otwarta kopia aplikacji jest osobną instancją z własnym identyfikatorem. Agent nazywa instancję, w której działa. Gdy do Twojej prośby pasuje więcej niż jedna instancja, agent pyta, o którą Ci chodzi. Gdy ponownie uruchomisz aplikację, otrzymuje ona nowy identyfikator, a agent odnajduje ją ponownie.

Odinstalowywanie łącznika

Najprościej jest poprosić o to agenta. Aby samodzielnie odinstalować łącznik, wykonaj jedną z poniższych czynności:

• Blender: w Edit > Preferences > Get Extensions znajdź Meshy DCC i odinstaluj je.
• Unity: usuń pakiet Meshy DCC Unity w Package Manager, a następnie usuń folder .meshy-dcc projektu.
• Godot: usuń addons/meshy_dcc_godot i .meshy-dcc z projektu.
• Unreal Engine: usuń Plugins/MeshyDccUnreal i .meshy-dcc z projektu.
• Inne aplikacje: zapytaj agenta. Wie on, jakie pliki dodał każdy łącznik, i wypisuje je, zanim cokolwiek usunie.