Conectores

Instala un conector para que tu agente trabaje dentro de una aplicación. Algunos conectores se instalan una vez por computadora, como Blender. Otros se instalan una vez por proyecto, como Unity, Godot y Unreal Engine.

Resumen

Instala conectores desde la página Connectors de la ventana de Meshy DCC Core (meshy-dcc ui), o pídele a tu agente que instale uno. Meshy DCC Core verifica cada descarga con su suma de comprobación SHA-256 antes de instalar nada.

La siguiente tabla muestra dónde se instala cada conector y qué versiones de su aplicación admite.

Todos los conectores funcionan en macOS (Apple Silicon) y Windows x64, excepto 3ds Max, que solo funciona en Windows.

Blender

Para instalar el conector de Blender, sigue estos pasos:

1. En Connectors, haz clic en Install junto a Blender.
2. Reinicia Blender si está abierto, o ábrelo como de costumbre.

Meshy DCC Core encuentra Blender en sus ubicaciones habituales: /Applications/Blender.app en macOS y C:\Program Files\Blender Foundation en Windows. Si Blender está en otro lugar, o tienes más de una copia, la ventana te pedirá su ubicación. Ingresa la ruta completa de la aplicación que deseas usar, por ejemplo /Applications/Blender 4.5.app.

El conector es una extensión de Blender llamada Meshy DCC. Se inicia con Blender, así que cada Blender que abras aparecerá en Connected now.

Para instalarlo desde una terminal, ejecuta:

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

Cuando Blender no esté en su ubicación habitual, añade --dcc-path <ruta a Blender>.

Unity

Para instalar el conector de Unity en un proyecto, sigue estos pasos:

1. Cierra el proyecto en Unity.
2. En Connectors, haz clic en Add to a project junto a Unity, ingresa la ruta completa de la carpeta del proyecto y haz clic en Install.
3. Abre el proyecto en Unity como de costumbre.

El conector añade el paquete Meshy DCC Unity y una carpeta .meshy-dcc al proyecto. Usa la versión del Editor de Unity que indica el archivo ProjectSettings/ProjectVersion.txt del proyecto, por lo que esa versión debe estar instalada en Unity Hub.

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

Godot

Para instalar el conector de Godot en un proyecto, sigue estos pasos:

1. Cierra el proyecto en Godot.
2. En Connectors, haz clic en Add to a project junto a Godot, ingresa la ruta completa de la carpeta del proyecto y haz clic en Install.
3. Abre el proyecto en Godot como de costumbre.

El conector añade el complemento addons/meshy_dcc_godot, lo activa y agrega una carpeta .meshy-dcc. Encuentra Godot en tu PATH o como Godot.app en /Applications. Para otra ubicación, y siempre en Windows, configura la variable de entorno MESHY_DCC_GODOT_EXECUTABLE con el editor de Godot.

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

Unreal Engine

Para instalar el conector de Unreal Engine en un proyecto, sigue estos pasos:

1. Cierra el proyecto en Unreal Engine.
2. En Connectors, haz clic en Add to a project junto a Unreal Engine, ingresa la carpeta que contiene el archivo .uproject y haz clic en Install.
3. Abre el proyecto como de costumbre.

El conector copia un complemento en la carpeta Plugins/MeshyDccUnreal del proyecto y lo compila con tu motor, lo cual toma desde unos segundos hasta unos minutos. Para compilarlo, necesitas:

• macOS: Xcode, en una versión que tu motor acepte. Unreal Engine 5.7 acepta hasta Xcode 26.
• Windows: Visual Studio 2022 con la carga de trabajo Game development with C++.

En Windows, conserva el proyecto en una carpeta cuya ruta contenga solo letras, dígitos y signos de puntuación en inglés. Unreal Engine no puede compilar el complemento con otros caracteres, por lo que la instalación se detiene y se revierte.

El conector usa el motor que coincide con la versión del motor del proyecto en Epic Games Launcher. Para una compilación desde el código fuente u otra ubicación, configura MESHY_DCC_UNREAL_ENGINE con la carpeta del motor. Unreal Engine 4 no es compatible.

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

Más aplicaciones

Estos conectores se instalan de la misma manera: desde Connectors, o con meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: el conector trabaja con los archivos .scad de una carpeta de proyecto y ejecuta OpenSCAD para cada exportación y vista previa, por lo que no se abre ninguna ventana de OpenSCAD. Puede colocar un modelo de Meshy sobre una base de impresión y exportarlo como STL o 3MF. En Apple Silicon, necesita una instantánea de desarrollo de OpenSCAD.
• Material Maker: el conector construye y edita grafos de material en una carpeta y exporta conjuntos de texturas PBR para Blender, Godot, Unity o Unreal Engine. Cada exportación trae brevemente a Material Maker al frente. El conector trabaja con los archivos de grafo, no con una ventana abierta de Material Maker. Cierra un grafo en Material Maker antes de que el agente lo modifique, y pídele al agente que te abra el resultado cuando termine.
• FreeCAD: el conector trabaja con los documentos de una carpeta de proyecto y ejecuta FreeCAD en segundo plano para cada paso. Importa modelos GLB de Meshy como mallas, junto con STEP, IGES, STL y OBJ.
• Roblox Studio: elige una carpeta que contenga un archivo de place (.rbxl o .rbxlx). El conector añade un complemento de Studio y abre el place. Los modelos de Meshy duran solo mientras dure la sesión de Studio, porque Roblox no los guarda con un place. La ejecución de Luau permanece desactivada hasta que hagas clic en Allow Luau en la barra de herramientas Meshy DCC.

Aplicaciones profesionales

• Houdini: se instala una vez por versión de Houdini, como un paquete de Houdini en tus preferencias de Houdini. Cuando tu variable HOME está configurada, Houdini toma la carpeta de preferencias de ahí.
• Maya: se instala una vez por computadora, como un módulo de Maya. Los modelos FBX de Meshy llegan con un material Standard Surface y sus mapas de textura.
• 3ds Max (Windows): se instala una vez por versión de 3ds Max, como un script de inicio. Los modelos FBX de Meshy llegan con un material Physical.
• Substance 3D Painter: se instala una vez por computadora, como un complemento de inicio. El agente puede iniciar un proyecto a partir de un modelo de Meshy, añadir capas PBR y exportar texturas.
• ZBrush: elige una carpeta de proyecto. El agente trabaja en un ZBrush que Meshy DCC Core inicia para esa carpeta, no en uno que hayas abierto tú mismo. Si el primer inicio agota el tiempo de espera, inícialo de nuevo.

Trabajar en varias aplicaciones a la vez

Cada aplicación abierta, y cada copia abierta de una aplicación, es su propia instancia con su propio ID. El agente nombra la instancia en la que trabaja. Cuando más de una instancia coincide con tu solicitud, el agente pregunta a cuál te refieres. Cuando reinicias una aplicación, esta obtiene un nuevo ID, y el agente la vuelve a encontrar.

Desinstalar un conector

La forma más sencilla es pedírselo a tu agente. Para desinstalar un conector tú mismo, haz una de las siguientes acciones:

• Blender: en Edit > Preferences > Get Extensions, busca Meshy DCC y desinstálalo.
• Unity: elimina el paquete Meshy DCC Unity en el Package Manager, luego borra la carpeta .meshy-dcc del proyecto.
• Godot: elimina addons/meshy_dcc_godot y .meshy-dcc del proyecto.
• Unreal Engine: elimina Plugins/MeshyDccUnreal y .meshy-dcc del proyecto.
• Otras aplicaciones: pídeselo a tu agente. Sabe qué archivos añadió cada conector, y los enumera antes de eliminar nada.