Connecteurs

Installez un connecteur pour permettre à votre agent de travailler dans une application. Certains connecteurs s'installent une fois par ordinateur, comme Blender. D'autres s'installent une fois par projet, comme Unity, Godot et Unreal Engine.

Vue d'ensemble

Installez des connecteurs depuis la page Connecteurs de la fenêtre Meshy DCC Core (meshy-dcc ui), ou demandez à votre agent d'en installer un. Meshy DCC Core vérifie chaque téléchargement par rapport à sa somme de contrôle SHA-256 avant d'installer quoi que ce soit.

Le tableau suivant indique où chaque connecteur s'installe et quelles versions de son application il prend en charge.

Chaque connecteur fonctionne sur macOS (Apple Silicon) et Windows x64, à l'exception de 3ds Max, qui fonctionne uniquement sur Windows.

Blender

Pour installer le connecteur Blender, suivez ces étapes :

1. Dans Connecteurs, cliquez sur Installer à côté de Blender.
2. Redémarrez Blender s'il est ouvert, ou démarrez-le normalement.

Meshy DCC Core trouve Blender à ses emplacements habituels : /Applications/Blender.app sur macOS et C:\Program Files\Blender Foundation sur Windows. Si Blender se trouve ailleurs, ou si vous en avez plusieurs copies, la fenêtre vous demande où il se trouve. Entrez le chemin complet de l'application que vous souhaitez utiliser, par exemple /Applications/Blender 4.5.app.

Le connecteur est une extension Blender nommée Meshy DCC. Elle démarre avec Blender, donc chaque Blender que vous ouvrez apparaît sous Connecté maintenant.

Pour l'installer depuis un terminal, exécutez :

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

Lorsque Blender ne se trouve pas à son emplacement habituel, ajoutez --dcc-path <chemin vers Blender>.

Unity

Pour installer le connecteur Unity dans un projet, suivez ces étapes :

1. Fermez le projet dans Unity.
2. Dans Connecteurs, cliquez sur Ajouter à un projet à côté de Unity, entrez le chemin complet du dossier du projet, puis cliquez sur Installer.
3. Ouvrez le projet dans Unity normalement.

Le connecteur ajoute le package Meshy DCC Unity et un dossier .meshy-dcc au projet. Il utilise la version de Unity Editor que nomme le fichier ProjectSettings/ProjectVersion.txt du projet, cette version doit donc être installée dans Unity Hub.

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

Godot

Pour installer le connecteur Godot dans un projet, suivez ces étapes :

1. Fermez le projet dans Godot.
2. Dans Connecteurs, cliquez sur Ajouter à un projet à côté de Godot, entrez le chemin complet du dossier du projet, puis cliquez sur Installer.
3. Ouvrez le projet dans Godot normalement.

Le connecteur ajoute l'extension addons/meshy_dcc_godot, l'active, et ajoute un dossier .meshy-dcc. Il trouve Godot dans votre PATH ou en tant que Godot.app dans /Applications. Pour un autre emplacement, et toujours sur Windows, définissez la variable d'environnement MESHY_DCC_GODOT_EXECUTABLE vers l'éditeur Godot.

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

Unreal Engine

Pour installer le connecteur Unreal Engine dans un projet, suivez ces étapes :

1. Fermez le projet dans Unreal Engine.
2. Dans Connecteurs, cliquez sur Ajouter à un projet à côté de Unreal Engine, entrez le dossier qui contient le fichier .uproject, puis cliquez sur Installer.
3. Ouvrez le projet normalement.

Le connecteur copie un plug-in dans le dossier Plugins/MeshyDccUnreal du projet et le compile avec votre moteur, ce qui prend de quelques secondes à quelques minutes. Pour le compiler, vous avez besoin de :

• macOS : Xcode, dans une version acceptée par votre moteur. Unreal Engine 5.7 accepte Xcode jusqu'à la version 26.
• Windows : Visual Studio 2022 avec la charge de travail Développement de jeux en C++.

Sous Windows, conservez le projet dans un dossier dont le chemin ne contient que des lettres anglaises, des chiffres et de la ponctuation. Unreal Engine ne peut pas compiler le plug-in avec d'autres caractères, donc l'installation s'arrête et revient en arrière.

Le connecteur utilise le moteur qui correspond à la version du moteur du projet dans l'Epic Games Launcher. Pour une compilation source ou un autre emplacement, définissez MESHY_DCC_UNREAL_ENGINE vers le dossier du moteur. Unreal Engine 4 n'est pas pris en charge.

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

Plus d'applications

Ces connecteurs s'installent de la même manière : depuis Connecteurs, ou avec meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD : le connecteur travaille sur les fichiers .scad d'un dossier de projet et exécute OpenSCAD pour chaque export et aperçu, de sorte qu'aucune fenêtre OpenSCAD ne s'ouvre. Il peut poser un modèle Meshy sur un plateau d'impression et exporter en STL ou 3MF. Sur Apple Silicon, il nécessite un instantané de développement d'OpenSCAD.
• Material Maker : le connecteur construit et modifie des graphes de matériaux dans un dossier et exporte des ensembles de textures PBR pour Blender, Godot, Unity ou Unreal Engine. Chaque export ramène brièvement Material Maker au premier plan. Le connecteur travaille sur les fichiers de graphe, pas sur une fenêtre Material Maker ouverte. Fermez un graphe dans Material Maker avant que l'agent ne le modifie, et demandez à l'agent d'ouvrir le résultat pour vous une fois terminé.
• FreeCAD : le connecteur travaille sur les documents d'un dossier de projet et exécute FreeCAD en arrière-plan pour chaque étape. Il importe les modèles GLB de Meshy en tant que maillages, aux côtés de STEP, IGES, STL et OBJ.
• Roblox Studio : choisissez un dossier qui contient un fichier de lieu (.rbxl ou .rbxlx). Le connecteur ajoute un plug-in Studio et ouvre le lieu. Les modèles de Meshy ne persistent que pour la session Studio, car Roblox ne les enregistre pas avec un lieu. L'exécution de Luau reste désactivée jusqu'à ce que vous cliquiez sur Autoriser Luau dans la barre d'outils Meshy DCC.

Applications professionnelles

• Houdini : s'installe une fois par version de Houdini, en tant que package Houdini dans vos préférences Houdini. Lorsque votre variable HOME est définie, Houdini y récupère le dossier des préférences.
• Maya : s'installe une fois par ordinateur, en tant que module Maya. Les modèles FBX de Meshy arrivent avec un matériau Standard Surface et leurs textures.
• 3ds Max (Windows) : s'installe une fois par version de 3ds Max, en tant que script de démarrage. Les modèles FBX de Meshy arrivent avec un matériau Physical.
• Substance 3D Painter : s'installe une fois par ordinateur, en tant que plug-in de démarrage. L'agent peut démarrer un projet à partir d'un modèle Meshy, ajouter des calques PBR et exporter des textures.
• ZBrush : choisissez un dossier de projet. L'agent travaille dans un ZBrush que Meshy DCC Core démarre pour ce dossier, pas dans celui que vous avez ouvert vous-même. Si le premier démarrage expire, redémarrez-le.

Travailler dans plusieurs applications à la fois

Chaque application ouverte, et chaque copie ouverte d'une application, est sa propre instance avec son propre ID. L'agent nomme l'instance dans laquelle il travaille. Lorsque plusieurs instances correspondent à votre demande, l'agent vous demande laquelle vous voulez dire. Lorsque vous redémarrez une application, elle obtient un nouvel ID, et l'agent la retrouve.

Désinstaller un connecteur

Le moyen le plus simple est de demander à votre agent. Pour désinstaller un connecteur vous-même, procédez de l'une des manières suivantes :

• Blender : dans Edit > Preferences > Get Extensions, trouvez Meshy DCC et désinstallez-le.
• Unity : supprimez le package Meshy DCC Unity dans le Package Manager, puis supprimez le dossier .meshy-dcc du projet.
• Godot : supprimez addons/meshy_dcc_godot et .meshy-dcc du projet.
• Unreal Engine : supprimez Plugins/MeshyDccUnreal et .meshy-dcc du projet.
• Autres applications : demandez à votre agent. Il sait quels fichiers chaque connecteur a ajoutés, et il les liste avant de supprimer quoi que ce soit.