Konektory

Nainstalujte konektor, aby váš agent mohl pracovat uvnitř jedné aplikace. Některé konektory se instalují jednou na počítač, například Blender. Jiné se instalují jednou na projekt, například Unity, Godot a Unreal Engine.

Přehled

Konektory instalujte na stránce Connectors v okně Meshy DCC Core (meshy-dcc ui), nebo požádejte svého agenta, aby konektor nainstaloval. Meshy DCC Core před instalací každého stahování ověří jeho kontrolní součet SHA-256.

Následující tabulka ukazuje, kam se jednotlivé konektory instalují a jaké verze dané aplikace podporují.

Každý konektor běží na macOS (Apple Silicon) a Windows x64, kromě 3ds Max, který běží pouze na Windows.

Blender

Konektor pro Blender nainstalujete podle následujících kroků:

1. V sekci Connectors klikněte na Install vedle Blenderu.
2. Pokud je Blender spuštěný, restartujte ho, nebo ho spusťte jako obvykle.

Meshy DCC Core hledá Blender na jeho obvyklých místech: /Applications/Blender.app na macOS a C:\Program Files\Blender Foundation na Windows. Pokud je Blender jinde, nebo máte více než jednu kopii, okno se zeptá, kde se nachází. Zadejte úplnou cestu k aplikaci, kterou chcete použít, například /Applications/Blender 4.5.app.

Konektor je rozšíření Blenderu s názvem Meshy DCC. Spouští se s Blenderem, takže se každý otevřený Blender zobrazí pod Connected now.

Pro instalaci z terminálu spusťte:

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

Pokud Blender není na svém obvyklém místě, přidejte --dcc-path <cesta k Blenderu>.

Unity

Konektor pro Unity nainstalujete do projektu podle následujících kroků:

1. Zavřete projekt v Unity.
2. V sekci Connectors klikněte na Add to a project vedle Unity, zadejte úplnou cestu ke složce projektu a klikněte na Install.
3. Otevřete projekt v Unity jako obvykle.

Konektor přidá do projektu balíček Meshy DCC Unity a složku .meshy-dcc. Používá verzi Unity Editoru, kterou uvádí soubor projektu ProjectSettings/ProjectVersion.txt, takže tato verze musí být nainstalovaná v Unity Hub.

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

Godot

Konektor pro Godot nainstalujete do projektu podle následujících kroků:

1. Zavřete projekt v Godotu.
2. V sekci Connectors klikněte na Add to a project vedle Godotu, zadejte úplnou cestu ke složce projektu a klikněte na Install.
3. Otevřete projekt v Godotu jako obvykle.

Konektor přidá doplněk addons/meshy_dcc_godot, zapne ho a přidá složku .meshy-dcc. Godot najde ve vaší proměnné PATH nebo jako Godot.app ve složce /Applications. Pro jiné umístění, a vždy na Windows, nastavte proměnnou prostředí MESHY_DCC_GODOT_EXECUTABLE na editor Godot.

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

Unreal Engine

Konektor pro Unreal Engine nainstalujete do projektu podle následujících kroků:

1. Zavřete projekt v Unreal Engine.
2. V sekci Connectors klikněte na Add to a project vedle Unreal Engine, zadejte složku obsahující soubor .uproject a klikněte na Install.
3. Otevřete projekt jako obvykle.

Konektor zkopíruje plugin do složky projektu Plugins/MeshyDccUnreal a sestaví ho pomocí vašeho enginu, což může trvat od několika sekund po několik minut. Pro sestavení potřebujete:

• macOS: Xcode ve verzi, kterou váš engine akceptuje. Unreal Engine 5.7 akceptuje Xcode až do verze 26.
• Windows: Visual Studio 2022 s pracovní zátěží Game development with C++.

Na Windows udržujte projekt ve složce, jejíž cesta obsahuje pouze anglická písmena, číslice a interpunkci. Unreal Engine neumí sestavit plugin pod jinými znaky, takže instalace se zastaví a vrátí zpět.

Konektor používá engine, který odpovídá verzi enginu projektu v Epic Games Launcher. Pro sestavení ze zdrojového kódu nebo jiné umístění nastavte MESHY_DCC_UNREAL_ENGINE na složku enginu. Unreal Engine 4 není podporován.

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

Další aplikace

Tyto konektory se instalují stejným způsobem: ze sekce Connectors, nebo pomocí meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: konektor pracuje se soubory .scad ve složce projektu a pro každý export a náhled spouští OpenSCAD, takže se neotevírá žádné okno OpenSCADu. Umí umístit model z Meshy na tiskovou podložku a exportovat STL nebo 3MF. Na Apple Silicon potřebuje vývojový snapshot OpenSCADu.
• Material Maker: konektor vytváří a upravuje materiálové grafy ve složce a exportuje sady PBR textur pro Blender, Godot, Unity nebo Unreal Engine. Při každém exportu se Material Maker krátce dostane do popředí. Konektor pracuje se soubory grafů, nikoli s otevřeným oknem Material Makeru. Před tím, než agent graf v Material Makeru změní, ho zavřete, a až bude hotovo, požádejte agenta, aby vám výsledek otevřel.
• FreeCAD: konektor pracuje s dokumenty ve složce projektu a pro každý krok spouští FreeCAD na pozadí. Modely GLB z Meshy importuje jako sítě (mesh), spolu s formáty STEP, IGES, STL a OBJ.
• Roblox Studio: vyberte složku obsahující jeden soubor místa (.rbxl nebo .rbxlx). Konektor přidá plugin do Studia a otevře dané místo. Modely z Meshy vydrží pouze po dobu relace Studia, protože Roblox je s místem (place) neukládá. Spouštění Luau zůstává vypnuté, dokud v panelu nástrojů Meshy DCC nekliknete na Allow Luau.

Profesionální aplikace

• Houdini: instaluje se jednou na verzi Houdini, jako balíček Houdini ve vašich předvolbách Houdini. Pokud máte nastavenou proměnnou HOME, Houdini z ní zjistí složku s předvolbami.
• Maya: instaluje se jednou na počítač, jako modul Maya. Modely FBX z Meshy přicházejí s materiálem Standard Surface a svými texturami.
• 3ds Max (Windows): instaluje se jednou na verzi 3ds Max, jako spouštěcí skript. Modely FBX z Meshy přicházejí s materiálem Physical.
• Substance 3D Painter: instaluje se jednou na počítač, jako spouštěcí plugin. Agent může z modelu z Meshy spustit projekt, přidat PBR vrstvy a exportovat textury.
• ZBrush: vyberte složku projektu. Agent pracuje v ZBrushi, který pro danou složku spustí Meshy DCC Core, nikoli v tom, který jste otevřeli sami. Pokud první spuštění vyprší časovým limitem, spusťte ho znovu.

Práce v několika aplikacích najednou

Každá otevřená aplikace a každá otevřená kopie aplikace je samostatná instance s vlastním ID. Agent instanci, ve které pracuje, pojmenuje. Pokud vašemu požadavku odpovídá víc než jedna instance, agent se zeptá, kterou máte na mysli. Když aplikaci restartujete, získá nové ID a agent ji znovu najde.

Odinstalování konektoru

Nejjednodušší je požádat svého agenta. Pokud chcete konektor odinstalovat sami, udělejte jedno z následujícího:

• Blender: v Edit > Preferences > Get Extensions najděte Meshy DCC a odinstalujte ho.
• Unity: v Package Manageru odeberte balíček Meshy DCC Unity a poté smažte složku projektu .meshy-dcc.
• Godot: z projektu smažte addons/meshy_dcc_godot a .meshy-dcc.
• Unreal Engine: z projektu smažte Plugins/MeshyDccUnreal a .meshy-dcc.
• Ostatní aplikace: zeptejte se svého agenta. Ví, které soubory jednotlivé konektory přidaly, a před tím, než cokoli smaže, je vypíše.