Connectors

Installiere einen Connector, damit dein Agent innerhalb einer App arbeiten kann. Manche Connectors werden einmal pro Computer installiert, wie Blender. Andere werden einmal pro Projekt installiert, wie Unity, Godot und Unreal Engine.

Übersicht

Installiere Connectors über die Seite Connectors des Meshy DCC Core-Fensters (meshy-dcc ui), oder bitte deinen Agenten, einen zu installieren. Meshy DCC Core prüft jeden Download anhand seiner SHA-256-Prüfsumme, bevor etwas installiert wird.

Die folgende Tabelle zeigt, wohin jeder Connector installiert wird und welche Versionen der jeweiligen App er unterstützt.

Jeder Connector läuft auf macOS (Apple Silicon) und Windows x64, außer 3ds Max, das nur unter Windows läuft.

Blender

Um den Blender-Connector zu installieren, führe diese Schritte aus:

1. Klicke in Connectors auf Install neben Blender.
2. Starte Blender neu, falls es geöffnet ist, oder starte es wie gewohnt.

Meshy DCC Core findet Blender an seinen üblichen Orten: /Applications/Blender.app unter macOS und C:\Program Files\Blender Foundation unter Windows. Befindet sich Blender woanders, oder hast du mehr als eine Kopie, fragt das Fenster danach, wo es sich befindet. Gib den vollständigen Pfad der App ein, die du verwenden möchtest, zum Beispiel /Applications/Blender 4.5.app.

Der Connector ist eine Blender-Erweiterung namens Meshy DCC. Sie startet mit Blender, sodass jedes von dir geöffnete Blender unter Connected now erscheint.

Um sie über ein Terminal zu installieren, führe Folgendes aus:

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

Befindet sich Blender nicht an seinem üblichen Ort, füge --dcc-path <Pfad zu Blender> hinzu.

Unity

Um den Unity-Connector in einem Projekt zu installieren, führe diese Schritte aus:

1. Schließe das Projekt in Unity.
2. Klicke in Connectors auf Add to a project neben Unity, gib den vollständigen Pfad des Projektordners ein und klicke auf Install.
3. Öffne das Projekt wie gewohnt in Unity.

Der Connector fügt das Paket Meshy DCC Unity sowie einen Ordner .meshy-dcc zum Projekt hinzu. Er verwendet die Unity-Editor-Version, die in der Datei ProjectSettings/ProjectVersion.txt des Projekts angegeben ist. Diese Version muss daher in Unity Hub installiert sein.

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

Godot

Um den Godot-Connector in einem Projekt zu installieren, führe diese Schritte aus:

1. Schließe das Projekt in Godot.
2. Klicke in Connectors auf Add to a project neben Godot, gib den vollständigen Pfad des Projektordners ein und klicke auf Install.
3. Öffne das Projekt wie gewohnt in Godot.

Der Connector fügt das Add-on addons/meshy_dcc_godot hinzu, aktiviert es und legt einen Ordner .meshy-dcc an. Er findet Godot über deinen PATH oder als Godot.app in /Applications. Für einen anderen Speicherort, und unter Windows immer, setze die Umgebungsvariable MESHY_DCC_GODOT_EXECUTABLE auf den Godot-Editor.

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

Unreal Engine

Um den Unreal-Engine-Connector in einem Projekt zu installieren, führe diese Schritte aus:

1. Schließe das Projekt in Unreal Engine.
2. Klicke in Connectors auf Add to a project neben Unreal Engine, gib den Ordner ein, der die Datei .uproject enthält, und klicke auf Install.
3. Öffne das Projekt wie gewohnt.

Der Connector kopiert ein Plugin in den Ordner Plugins/MeshyDccUnreal des Projekts und erstellt es mit deiner Engine, was von wenigen Sekunden bis zu einigen Minuten dauern kann. Zum Erstellen benötigst du:

• macOS: Xcode, in einer Version, die deine Engine akzeptiert. Unreal Engine 5.7 akzeptiert Xcode bis Version 26.
• Windows: Visual Studio 2022 mit dem Workload Game development with C++.

Achte unter Windows darauf, dass das Projekt in einem Ordner liegt, dessen Pfad nur englische Buchstaben, Ziffern und Satzzeichen enthält. Unreal Engine kann das Plugin bei anderen Zeichen nicht erstellen, sodass die Installation stoppt und rückgängig gemacht wird.

Der Connector verwendet die Engine, die der Engine-Version des Projekts im Epic Games Launcher entspricht. Für einen Quellcode-Build oder einen anderen Speicherort setze MESHY_DCC_UNREAL_ENGINE auf den Engine-Ordner. Unreal Engine 4 wird nicht unterstützt.

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

Weitere Apps

Diese Connectors werden auf dieselbe Weise installiert: über Connectors, oder mit meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: Der Connector arbeitet mit den .scad-Dateien in einem Projektordner und führt OpenSCAD für jeden Export und jede Vorschau aus, sodass sich kein OpenSCAD-Fenster öffnet. Er kann ein Meshy-Modell auf einen Druck-Sockel setzen und als STL oder 3MF exportieren. Auf Apple Silicon benötigt er einen Entwicklungs-Snapshot von OpenSCAD.
• Material Maker: Der Connector erstellt und bearbeitet Material-Graphen in einem Ordner und exportiert PBR-Textursätze für Blender, Godot, Unity oder Unreal Engine. Bei jedem Export wird Material Maker kurz in den Vordergrund geholt. Der Connector arbeitet mit den Graph-Dateien, nicht mit einem geöffneten Material-Maker-Fenster. Schließe einen Graphen in Material Maker, bevor der Agent ihn ändert, und bitte den Agenten, dir das Ergebnis zu öffnen, wenn er fertig ist.
• FreeCAD: Der Connector arbeitet mit den Dokumenten in einem Projektordner und führt FreeCAD für jeden Schritt im Hintergrund aus. Er importiert Meshy-GLB-Modelle als Meshes, zusammen mit STEP, IGES, STL und OBJ.
• Roblox Studio: Wähle einen Ordner, der eine Place-Datei (.rbxl oder .rbxlx) enthält. Der Connector fügt ein Studio-Plugin hinzu und öffnet den Place. Modelle von Meshy bleiben nur für die Studio-Sitzung erhalten, da Roblox sie nicht zusammen mit einem Place speichert. Die Ausführung von Luau bleibt ausgeschaltet, bis du in der Symbolleiste Meshy DCC auf Allow Luau klickst.

Professionelle Apps

• Houdini: Wird einmal pro Houdini-Version als Houdini-Paket in deinen Houdini-Einstellungen installiert. Wenn deine Variable HOME gesetzt ist, übernimmt Houdini den Einstellungsordner daraus.
• Maya: Wird einmal pro Computer als Maya-Modul installiert. Meshy-FBX-Modelle kommen mit einem Standard-Surface-Material und ihren Textur-Maps an.
• 3ds Max (Windows): Wird einmal pro 3ds Max-Version als Startskript installiert. Meshy-FBX-Modelle kommen mit einem Physical-Material an.
• Substance 3D Painter: Wird einmal pro Computer als Start-Plugin installiert. Der Agent kann ein Projekt aus einem Meshy-Modell starten, PBR-Ebenen hinzufügen und Texturen exportieren.
• ZBrush: Wähle einen Projektordner. Der Agent arbeitet in einem ZBrush, das Meshy DCC Core für diesen Ordner startet, nicht in einem, das du selbst geöffnet hast. Falls der erste Start eine Zeitüberschreitung verursacht, starte ihn erneut.

In mehreren Apps gleichzeitig arbeiten

Jede geöffnete App und jede geöffnete Kopie einer App ist eine eigene Instanz mit einer eigenen ID. Der Agent benennt die Instanz, in der er arbeitet. Wenn mehr als eine Instanz zu deiner Anfrage passt, fragt der Agent, welche du meinst. Wenn du eine App neu startest, erhält sie eine neue ID, und der Agent findet sie wieder.

Einen Connector deinstallieren

Am einfachsten ist es, deinen Agenten zu bitten. Um einen Connector selbst zu deinstallieren, gehe wie folgt vor:

• Blender: Finde unter Edit > Preferences > Get Extensions den Eintrag Meshy DCC und deinstalliere ihn.
• Unity: Entferne das Paket Meshy DCC Unity im Package Manager und lösche anschließend den Ordner .meshy-dcc des Projekts.
• Godot: Lösche addons/meshy_dcc_godot und .meshy-dcc aus dem Projekt.
• Unreal Engine: Lösche Plugins/MeshyDccUnreal und .meshy-dcc aus dem Projekt.
• Andere Apps: Frag deinen Agenten. Er weiß, welche Dateien jeder Connector hinzugefügt hat, und listet sie auf, bevor er etwas löscht.