Connettori

Installa un connettore per permettere al tuo agente di lavorare all'interno di un'app. Alcuni connettori si installano una sola volta per computer, come Blender. Altri si installano una sola volta per progetto, come Unity, Godot e Unreal Engine.

Panoramica

Installa i connettori dalla pagina Connectors della finestra di Meshy DCC Core (meshy-dcc ui), oppure chiedi al tuo agente di installarne uno. Meshy DCC Core verifica ogni download rispetto al suo checksum SHA-256 prima di installare qualsiasi cosa.

La tabella seguente mostra dove si installa ciascun connettore e quali versioni della sua app supporta.

Ogni connettore funziona su macOS (Apple Silicon) e Windows x64, tranne 3ds Max, che funziona solo su Windows.

Blender

Per installare il connettore Blender, segui questi passaggi:

1. In Connectors, fai clic su Install accanto a Blender.
2. Riavvia Blender se è aperto, oppure avvialo come al solito.

Meshy DCC Core trova Blender nei suoi percorsi abituali: /Applications/Blender.app su macOS e C:\Program Files\Blender Foundation su Windows. Se Blender si trova altrove, o ne hai più di una copia, la finestra chiede dove si trova. Inserisci il percorso completo dell'app che vuoi usare, ad esempio /Applications/Blender 4.5.app.

Il connettore è un'estensione di Blender chiamata Meshy DCC. Si avvia con Blender, quindi ogni Blender che apri appare in Connected now.

Per installarlo da un terminale, esegui:

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

Quando Blender non si trova nel suo percorso abituale, aggiungi --dcc-path <path to Blender>.

Unity

Per installare il connettore Unity in un progetto, segui questi passaggi:

1. Chiudi il progetto in Unity.
2. In Connectors, fai clic su Add to a project accanto a Unity, inserisci il percorso completo della cartella del progetto e fai clic su Install.
3. Apri il progetto in Unity come al solito.

Il connettore aggiunge il pacchetto Meshy DCC Unity e una cartella .meshy-dcc al progetto. Utilizza la versione di Unity Editor indicata nel file ProjectSettings/ProjectVersion.txt del progetto, quindi quella versione deve essere installata in Unity Hub.

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

Godot

Per installare il connettore Godot in un progetto, segui questi passaggi:

1. Chiudi il progetto in Godot.
2. In Connectors, fai clic su Add to a project accanto a Godot, inserisci il percorso completo della cartella del progetto e fai clic su Install.
3. Apri il progetto in Godot come al solito.

Il connettore aggiunge l'add-on addons/meshy_dcc_godot, lo attiva e aggiunge una cartella .meshy-dcc. Trova Godot nel tuo PATH oppure come Godot.app in /Applications. Per un'altra posizione, e sempre su Windows, imposta la variabile d'ambiente MESHY_DCC_GODOT_EXECUTABLE sull'editor di Godot.

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

Unreal Engine

Per installare il connettore Unreal Engine in un progetto, segui questi passaggi:

1. Chiudi il progetto in Unreal Engine.
2. In Connectors, fai clic su Add to a project accanto a Unreal Engine, inserisci la cartella che contiene il file .uproject e fai clic su Install.
3. Apri il progetto come al solito.

Il connettore copia un plugin nella cartella Plugins/MeshyDccUnreal del progetto e lo compila con il tuo motore, operazione che richiede da pochi secondi a qualche minuto. Per compilarlo, hai bisogno di:

• macOS: Xcode, in una versione accettata dal tuo motore. Unreal Engine 5.7 accetta Xcode fino alla versione 26.
• Windows: Visual Studio 2022 con il carico di lavoro Game development with C++.

Su Windows, mantieni il progetto in una cartella il cui percorso contenga solo lettere inglesi, cifre e punteggiatura. Unreal Engine non può compilare il plugin con altri caratteri, quindi l'installazione si interrompe e viene annullata.

Il connettore utilizza il motore che corrisponde alla versione del motore del progetto in Epic Games Launcher. Per una build sorgente o un'altra posizione, imposta MESHY_DCC_UNREAL_ENGINE sulla cartella del motore. Unreal Engine 4 non è supportato.

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

Altre app

Questi connettori si installano nello stesso modo: da Connectors, oppure con meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: il connettore lavora sui file .scad in una cartella di progetto ed esegue OpenSCAD per ogni esportazione e anteprima, quindi non si apre alcuna finestra di OpenSCAD. Può posizionare un modello Meshy su una base di stampa ed esportare STL o 3MF. Su Apple Silicon, richiede uno snapshot di sviluppo di OpenSCAD.
• Material Maker: il connettore costruisce e modifica grafi di materiali in una cartella ed esporta set di texture PBR per Blender, Godot, Unity o Unreal Engine. Ogni esportazione porta brevemente Material Maker in primo piano. Il connettore lavora sui file del grafo, non su una finestra di Material Maker aperta. Chiudi un grafo in Material Maker prima che l'agente lo modifichi, e chiedi all'agente di aprire il risultato per te quando ha finito.
• FreeCAD: il connettore lavora sui documenti in una cartella di progetto ed esegue FreeCAD in background per ogni passaggio. Importa i modelli Meshy GLB come mesh, insieme a STEP, IGES, STL e OBJ.
• Roblox Studio: scegli una cartella che contenga un file di ambientazione (.rbxl o .rbxlx). Il connettore aggiunge un plugin per Studio e apre l'ambientazione. I modelli provenienti da Meshy durano solo per la sessione di Studio, perché Roblox non li salva insieme all'ambientazione. L'esecuzione di Luau resta disattivata finché non fai clic su Allow Luau nella barra degli strumenti Meshy DCC.

App professionali

• Houdini: si installa una volta per versione di Houdini, come pacchetto Houdini nelle tue preferenze di Houdini. Quando la tua variabile HOME è impostata, Houdini sceglie la cartella delle preferenze da essa.
• Maya: si installa una volta per computer, come modulo Maya. I modelli Meshy FBX arrivano con un materiale Standard Surface e le relative texture.
• 3ds Max (Windows): si installa una volta per versione di 3ds Max, come script di avvio. I modelli Meshy FBX arrivano con un materiale Physical.
• Substance 3D Painter: si installa una volta per computer, come plugin di avvio. L'agente può avviare un progetto a partire da un modello Meshy, aggiungere livelli PBR ed esportare texture.
• ZBrush: scegli una cartella di progetto. L'agente lavora in uno ZBrush avviato da Meshy DCC Core per quella cartella, non in uno che hai aperto tu stesso. Se il primo avvio va in timeout, avvialo di nuovo.

Lavorare in più app contemporaneamente

Ogni app aperta, e ogni copia aperta di un'app, è una propria istanza con il proprio ID. L'agente indica il nome dell'istanza in cui lavora. Quando più istanze corrispondono alla tua richiesta, l'agente chiede quale intendi. Quando riavvii un'app, questa ottiene un nuovo ID, e l'agente la ritrova.

Disinstallare un connettore

Il modo più semplice è chiederlo al tuo agente. Per disinstallare un connettore tu stesso, esegui una delle seguenti operazioni:

• Blender: in Edit > Preferences > Get Extensions, trova Meshy DCC e disinstallalo.
• Unity: rimuovi il pacchetto Meshy DCC Unity nel Package Manager, quindi elimina la cartella .meshy-dcc del progetto.
• Godot: elimina addons/meshy_dcc_godot e .meshy-dcc dal progetto.
• Unreal Engine: elimina Plugins/MeshyDccUnreal e .meshy-dcc dal progetto.
• Altre app: chiedi al tuo agente. Sa quali file ha aggiunto ciascun connettore, e li elenca prima di eliminare qualsiasi cosa.