Connectors

Installeer een connector zodat je agent in één app kan werken. Sommige connectors installeer je één keer per computer, zoals Blender. Andere installeer je één keer per project, zoals Unity, Godot en Unreal Engine.

Overzicht

Installeer connectors vanaf de pagina Connectors van het Meshy DCC Core-venster (meshy-dcc ui), of vraag je agent om er een te installeren. Meshy DCC Core controleert elke download aan de hand van de SHA-256-checksum voordat er iets wordt geïnstalleerd.

De volgende tabel toont waar elke connector wordt geïnstalleerd en welke versies van de app worden ondersteund.

Elke connector draait op macOS (Apple Silicon) en Windows x64, behalve 3ds Max, dat alleen op Windows draait.

Blender

Volg deze stappen om de Blender-connector te installeren:

1. Klik in Connectors op Install naast Blender.
2. Herstart Blender als het geopend is, of start het zoals gewoonlijk.

Meshy DCC Core zoekt Blender op de gebruikelijke plekken: /Applications/Blender.app op macOS en C:\Program Files\Blender Foundation op Windows. Als Blender zich ergens anders bevindt, of als je meer dan één exemplaar hebt, vraagt het venster waar het staat. Voer het volledige pad van de app in die je wilt gebruiken, bijvoorbeeld /Applications/Blender 4.5.app.

De connector is een Blender-extensie met de naam Meshy DCC. Deze start samen met Blender, dus elke Blender die je opent verschijnt onder Connected now.

Voer het volgende uit om de connector vanuit een terminal te installeren:

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

Wanneer Blender zich niet op de gebruikelijke plek bevindt, voeg je --dcc-path <pad naar Blender> toe.

Unity

Volg deze stappen om de Unity-connector in een project te installeren:

1. Sluit het project in Unity.
2. Klik in Connectors op Add to a project naast Unity, voer het volledige pad van de projectmap in en klik op Install.
3. Open het project zoals gewoonlijk in Unity.

De connector voegt het pakket Meshy DCC Unity en een map .meshy-dcc toe aan het project. Hij gebruikt de Unity Editor-versie die in het bestand ProjectSettings/ProjectVersion.txt van het project staat, dus die versie moet geïnstalleerd zijn in Unity Hub.

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

Godot

Volg deze stappen om de Godot-connector in een project te installeren:

1. Sluit het project in Godot.
2. Klik in Connectors op Add to a project naast Godot, voer het volledige pad van de projectmap in en klik op Install.
3. Open het project zoals gewoonlijk in Godot.

De connector voegt de add-on addons/meshy_dcc_godot toe, schakelt deze in en voegt een map .meshy-dcc toe. Hij vindt Godot via je PATH of als Godot.app in /Applications. Voor een andere locatie, en altijd op Windows, stel je de omgevingsvariabele MESHY_DCC_GODOT_EXECUTABLE in op de Godot-editor.

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

Unreal Engine

Volg deze stappen om de Unreal Engine-connector in een project te installeren:

1. Sluit het project in Unreal Engine.
2. Klik in Connectors op Add to a project naast Unreal Engine, voer de map in die het .uproject-bestand bevat, en klik op Install.
3. Open het project zoals gewoonlijk.

De connector kopieert een plug-in naar de map Plugins/MeshyDccUnreal van het project en bouwt deze met je engine, wat van een paar seconden tot een paar minuten kan duren. Om te bouwen heb je het volgende nodig:

• macOS: Xcode, in een versie die je engine accepteert. Unreal Engine 5.7 accepteert Xcode tot en met 26.
• Windows: Visual Studio 2022 met de workload Game development with C++.

Houd het project op Windows in een map waarvan het pad alleen Engelse letters, cijfers en leestekens bevat. Unreal Engine kan de plug-in niet bouwen bij andere tekens, waardoor de installatie stopt en wordt teruggedraaid.

De connector gebruikt de engine die overeenkomt met de engineversie van het project in de Epic Games Launcher. Stel voor een source-build of een andere locatie MESHY_DCC_UNREAL_ENGINE in op de enginemap. Unreal Engine 4 wordt niet ondersteund.

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

Meer apps

Deze connectors installeer je op dezelfde manier: vanuit Connectors, of met meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: de connector werkt met de .scad-bestanden in een projectmap en voert OpenSCAD uit voor elke export en preview, zodat er geen OpenSCAD-venster opent. Hij kan een Meshy-model op een printbasis plaatsen en exporteren als STL of 3MF. Op Apple Silicon is hiervoor een ontwikkelsnapshot van OpenSCAD nodig.
• Material Maker: de connector bouwt en bewerkt materiaalgraphs in een map en exporteert PBR-texturesets voor Blender, Godot, Unity of Unreal Engine. Elke export brengt Material Maker kort naar de voorgrond. De connector werkt met de graphbestanden, niet met een geopend Material Maker-venster. Sluit een graph in Material Maker voordat de agent deze wijzigt, en vraag de agent om het resultaat voor je te openen wanneer hij klaar is.
• FreeCAD: de connector werkt met de documenten in een projectmap en voert FreeCAD voor elke stap op de achtergrond uit. Hij importeert Meshy GLB-modellen als meshes, naast STEP, IGES, STL en OBJ.
• Roblox Studio: kies een map die één place-bestand bevat (.rbxl of .rbxlx). De connector voegt een Studio-plug-in toe en opent de place. Modellen van Meshy blijven alleen tijdens de Studio-sessie behouden, omdat Roblox ze niet samen met een place opslaat. Het uitvoeren van Luau blijft uitgeschakeld totdat je op Allow Luau klikt in de werkbalk Meshy DCC.

Professionele apps

• Houdini: wordt één keer per Houdini-versie geïnstalleerd, als een Houdini-pakket in je Houdini-voorkeuren. Wanneer je variabele HOME is ingesteld, haalt Houdini de voorkeurenmap daaruit.
• Maya: wordt één keer per computer geïnstalleerd, als een Maya-module. Meshy FBX-modellen komen binnen met een Standard Surface-materiaal en hun texturemaps.
• 3ds Max (Windows): wordt één keer per 3ds Max-versie geïnstalleerd, als een opstartscript. Meshy FBX-modellen komen binnen met een Physical-materiaal.
• Substance 3D Painter: wordt één keer per computer geïnstalleerd, als een opstartplug-in. De agent kan een project starten vanuit een Meshy-model, PBR-lagen toevoegen en textures exporteren.
• ZBrush: kies een projectmap. De agent werkt in een ZBrush dat Meshy DCC Core voor die map start, niet in een instantie die je zelf hebt geopend. Als de eerste start een time-out krijgt, start je deze opnieuw.

Werken in meerdere apps tegelijk

Elke geopende app, en elk geopend exemplaar van een app, is een eigen instantie met een eigen ID. De agent noemt de instantie waarin hij werkt. Wanneer meer dan één instantie bij je verzoek past, vraagt de agent welke je bedoelt. Wanneer je een app opnieuw start, krijgt deze een nieuwe ID, en de agent vindt hem opnieuw.

Een connector verwijderen

De eenvoudigste manier is het je agent te vragen. Om een connector zelf te verwijderen, doe je een van de volgende dingen:

• Blender: zoek in Edit > Preferences > Get Extensions naar Meshy DCC en verwijder het.
• Unity: verwijder het pakket Meshy DCC Unity in de Package Manager en verwijder vervolgens de map .meshy-dcc van het project.
• Godot: verwijder addons/meshy_dcc_godot en .meshy-dcc uit het project.
• Unreal Engine: verwijder Plugins/MeshyDccUnreal en .meshy-dcc uit het project.
• Andere apps: vraag je agent. Hij weet welke bestanden elke connector heeft toegevoegd en vermeldt ze voordat hij iets verwijdert.