Conectores

Instale um conector para permitir que seu agente trabalhe dentro de um aplicativo. Alguns conectores são instalados uma vez por computador, como o Blender. Outros são instalados uma vez por projeto, como Unity, Godot e Unreal Engine.

Visão geral

Instale conectores a partir da página Connectors da janela do Meshy DCC Core (meshy-dcc ui), ou peça ao seu agente para instalar um. O Meshy DCC Core verifica cada download em relação ao seu checksum SHA-256 antes de instalar qualquer coisa.

A tabela a seguir mostra onde cada conector é instalado e quais versões de seu aplicativo ele suporta.

Todo conector é executado no macOS (Apple Silicon) e Windows x64, exceto o 3ds Max, que é executado apenas no Windows.

Blender

Para instalar o conector do Blender, siga estes passos:

1. Em Connectors, clique em Install ao lado de Blender.
2. Reinicie o Blender se ele estiver aberto, ou inicie-o normalmente.

O Meshy DCC Core encontra o Blender em seus locais habituais: /Applications/Blender.app no macOS e C:\Program Files\Blender Foundation no Windows. Se o Blender estiver em outro lugar, ou se você tiver mais de uma cópia, a janela pergunta onde ele está. Digite o caminho completo do aplicativo que deseja usar, por exemplo /Applications/Blender 4.5.app.

O conector é uma extensão do Blender chamada Meshy DCC. Ele inicia junto com o Blender, então cada Blender que você abrir aparece em Connected now.

Para instalá-lo a partir de um terminal, execute:

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

Quando o Blender não estiver em seu local habitual, adicione --dcc-path <caminho para o Blender>.

Unity

Para instalar o conector do Unity em um projeto, siga estes passos:

1. Feche o projeto no Unity.
2. Em Connectors, clique em Add to a project ao lado de Unity, digite o caminho completo da pasta do projeto e clique em Install.
3. Abra o projeto no Unity normalmente.

O conector adiciona o pacote Meshy DCC Unity e uma pasta .meshy-dcc ao projeto. Ele usa a versão do Unity Editor indicada pelo arquivo ProjectSettings/ProjectVersion.txt do projeto, portanto essa versão precisa estar instalada no Unity Hub.

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

Godot

Para instalar o conector do Godot em um projeto, siga estes passos:

1. Feche o projeto no Godot.
2. Em Connectors, clique em Add to a project ao lado de Godot, digite o caminho completo da pasta do projeto e clique em Install.
3. Abra o projeto no Godot normalmente.

O conector adiciona o add-on addons/meshy_dcc_godot, o ativa e adiciona uma pasta .meshy-dcc. Ele encontra o Godot em seu PATH ou como Godot.app em /Applications. Para outro local, e sempre no Windows, defina a variável de ambiente MESHY_DCC_GODOT_EXECUTABLE para o editor do Godot.

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

Unreal Engine

Para instalar o conector do Unreal Engine em um projeto, siga estes passos:

1. Feche o projeto no Unreal Engine.
2. Em Connectors, clique em Add to a project ao lado de Unreal Engine, digite a pasta que contém o arquivo .uproject e clique em Install.
3. Abra o projeto normalmente.

O conector copia um plugin para a pasta Plugins/MeshyDccUnreal do projeto e o compila com seu engine, o que leva de alguns segundos a alguns minutos. Para compilá-lo, você precisa de:

• macOS: Xcode, em uma versão aceita pelo seu engine. O Unreal Engine 5.7 aceita Xcode até a versão 26.
• Windows: Visual Studio 2022 com a carga de trabalho Game development with C++.

No Windows, mantenha o projeto em uma pasta cujo caminho contenha apenas letras do alfabeto inglês, dígitos e pontuação. O Unreal Engine não consegue compilar o plugin sob outros caracteres, então a instalação para e é revertida.

O conector usa o engine que corresponde à versão de engine do projeto no Epic Games Launcher. Para uma compilação a partir do código-fonte ou outro local, defina MESHY_DCC_UNREAL_ENGINE para a pasta do engine. O Unreal Engine 4 não é suportado.

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

Mais aplicativos

Esses conectores são instalados da mesma forma: a partir de Connectors, ou com meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: o conector trabalha nos arquivos .scad de uma pasta de projeto e executa o OpenSCAD para cada exportação e pré-visualização, então nenhuma janela do OpenSCAD é aberta. Ele pode colocar um modelo do Meshy sobre uma base de impressão e exportar STL ou 3MF. No Apple Silicon, ele precisa de um snapshot de desenvolvimento do OpenSCAD.
• Material Maker: o conector cria e edita grafos de material em uma pasta e exporta conjuntos de texturas PBR para Blender, Godot, Unity ou Unreal Engine. Cada exportação traz brevemente o Material Maker para a frente. O conector trabalha nos arquivos de grafo, não em uma janela aberta do Material Maker. Feche um grafo no Material Maker antes que o agente o altere, e peça ao agente para abrir o resultado para você quando terminar.
• FreeCAD: o conector trabalha nos documentos de uma pasta de projeto e executa o FreeCAD em segundo plano para cada etapa. Ele importa modelos GLB do Meshy como malhas, junto com STEP, IGES, STL e OBJ.
• Roblox Studio: escolha uma pasta que contenha um arquivo de place (.rbxl ou .rbxlx). O conector adiciona um plugin do Studio e abre o place. Os modelos do Meshy duram apenas durante a sessão do Studio, pois o Roblox não os salva com um place. A execução de Luau permanece desativada até que você clique em Allow Luau na barra de ferramentas Meshy DCC.

Aplicativos profissionais

• Houdini: instala uma vez por versão do Houdini, como um pacote do Houdini em suas preferências do Houdini. Quando sua variável HOME está definida, o Houdini obtém a pasta de preferências a partir dela.
• Maya: instala uma vez por computador, como um módulo do Maya. Os modelos FBX do Meshy chegam com um material Standard Surface e seus mapas de textura.
• 3ds Max (Windows): instala uma vez por versão do 3ds Max, como um script de inicialização. Os modelos FBX do Meshy chegam com um material Physical.
• Substance 3D Painter: instala uma vez por computador, como um plugin de inicialização. O agente pode iniciar um projeto a partir de um modelo do Meshy, adicionar camadas PBR e exportar texturas.
• ZBrush: escolha uma pasta de projeto. O agente trabalha em um ZBrush que o Meshy DCC Core inicia para aquela pasta, não em um que você mesmo abriu. Se a primeira inicialização expirar, inicie-o novamente.

Trabalhe em vários aplicativos ao mesmo tempo

Cada aplicativo aberto, e cada cópia aberta de um aplicativo, é sua própria instância com seu próprio ID. O agente nomeia a instância em que está trabalhando. Quando mais de uma instância se encaixa no seu pedido, o agente pergunta a qual delas você se refere. Quando você reinicia um aplicativo, ele recebe um novo ID, e o agente o encontra novamente.

Desinstalar um conector

A forma mais simples é pedir ao seu agente. Para desinstalar um conector você mesmo, faça um dos seguintes:

• Blender: em Edit > Preferences > Get Extensions, encontre Meshy DCC e desinstale-o.
• Unity: remova o pacote Meshy DCC Unity no Package Manager e, em seguida, exclua a pasta .meshy-dcc do projeto.
• Godot: exclua addons/meshy_dcc_godot e .meshy-dcc do projeto.
• Unreal Engine: exclua Plugins/MeshyDccUnreal e .meshy-dcc do projeto.
• Outros aplicativos: pergunte ao seu agente. Ele sabe quais arquivos cada conector adicionou, e os lista antes de excluir qualquer coisa.