Conectores

Instale um conector para permitir que o seu agente trabalhe dentro de uma aplicação. Alguns conectores instalam-se uma vez por computador, como o Blender. Outros instalam-se uma vez por projeto, como o Unity, o Godot e o Unreal Engine.

Descriçã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 transferência com o seu checksum SHA-256 antes de instalar seja o que for.

A tabela seguinte mostra onde cada conector se instala e quais as versões da sua aplicação que suporta.

Todos os conectores funcionam em macOS (Apple Silicon) e Windows x64, exceto o 3ds Max, que funciona apenas em Windows.

Blender

Para instalar o conector Blender, siga estes passos:

1. Em Connectors, clique em Install junto a Blender.
2. Reinicie o Blender se estiver aberto, ou inicie-o normalmente.

O Meshy DCC Core encontra o Blender nos seus locais habituais: /Applications/Blender.app no macOS e C:\Program Files\Blender Foundation no Windows. Se o Blender estiver noutro local, ou se tiver mais do que uma cópia, a janela pergunta onde se encontra. Introduza o caminho completo da aplicação que pretende utilizar, por exemplo /Applications/Blender 4.5.app.

O conector é uma extensão do Blender chamada Meshy DCC. Inicia-se com o Blender, pelo que cada Blender que abrir aparece em Connected now.

Para o instalar a partir de um terminal, execute:

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

Quando o Blender não se encontra no seu local habitual, adicione --dcc-path <caminho para o Blender>.

Unity

Para instalar o conector Unity num projeto, siga estes passos:

1. Feche o projeto no Unity.
2. Em Connectors, clique em Add to a project junto a Unity, introduza 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. Utiliza a versão do Unity Editor indicada no ProjectSettings/ProjectVersion.txt do projeto, pelo que essa versão tem de estar instalada no Unity Hub.

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

Godot

Para instalar o conector Godot num projeto, siga estes passos:

1. Feche o projeto no Godot.
2. Em Connectors, clique em Add to a project junto a Godot, introduza 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, ativa-o e adiciona uma pasta .meshy-dcc. Encontra o Godot no 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 Godot.

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

Unreal Engine

Para instalar o conector Unreal Engine num projeto, siga estes passos:

1. Feche o projeto no Unreal Engine.
2. Em Connectors, clique em Add to a project junto a Unreal Engine, introduza a pasta que contém o ficheiro .uproject e clique em Install.
3. Abra o projeto normalmente.

O conector copia um plugin para a pasta Plugins/MeshyDccUnreal do projeto e constrói-o com o seu motor, o que demora entre alguns segundos e alguns minutos. Para o construir, precisa de:

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

No Windows, mantenha o projeto numa pasta cujo caminho contenha apenas letras, dígitos e pontuação em inglês. O Unreal Engine não consegue construir o plugin com outros caracteres, pelo que a instalação é interrompida e revertida.

O conector utiliza o motor que corresponde à versão do motor 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 motor. O Unreal Engine 4 não é suportado.

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

Mais aplicações

Estes conectores instalam-se da mesma forma: a partir de Connectors, ou com meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: o conector funciona sobre os ficheiros .scad numa pasta de projeto e executa o OpenSCAD para cada exportação e pré-visualização, pelo que não abre nenhuma janela do OpenSCAD. Consegue colocar um modelo Meshy sobre uma base de impressão e exportar para STL ou 3MF. No Apple Silicon, precisa de um snapshot de desenvolvimento do OpenSCAD.
• Material Maker: o conector constrói e edita grafos de materiais numa pasta e exporta conjuntos de texturas PBR para Blender, Godot, Unity ou Unreal Engine. Cada exportação traz brevemente o Material Maker para primeiro plano. O conector funciona sobre os ficheiros de grafo, não sobre uma janela aberta do Material Maker. Feche um grafo no Material Maker antes de o agente o alterar, e peça ao agente para abrir o resultado quando terminar.
• FreeCAD: o conector funciona sobre os documentos numa pasta de projeto e executa o FreeCAD em segundo plano para cada passo. Importa modelos Meshy em GLB como malhas, juntamente com STEP, IGES, STL e OBJ.
• Roblox Studio: escolha uma pasta que contenha um ficheiro de lugar (.rbxl ou .rbxlx). O conector adiciona um plugin do Studio e abre o lugar. Os modelos do Meshy duram apenas para a sessão do Studio, porque o Roblox não os guarda com um lugar. A execução de Luau permanece desativada até clicar em Allow Luau na barra de ferramentas Meshy DCC.

Aplicações profissionais

• Houdini: instala-se uma vez por versão do Houdini, como um pacote Houdini nas suas preferências do Houdini. Quando a sua variável HOME está definida, o Houdini escolhe a pasta de preferências a partir dela.
• Maya: instala-se uma vez por computador, como um módulo Maya. Os modelos Meshy em FBX chegam com um material Standard Surface e os respetivos mapas de textura.
• 3ds Max (Windows): instala-se uma vez por versão do 3ds Max, como um script de arranque. Os modelos Meshy em FBX chegam com um material Physical.
• Substance 3D Painter: instala-se uma vez por computador, como um plugin de arranque. O agente pode iniciar um projeto a partir de um modelo Meshy, adicionar camadas PBR e exportar texturas.
• ZBrush: escolha uma pasta de projeto. O agente trabalha num ZBrush que o Meshy DCC Core inicia para essa pasta, não num que tenha aberto você próprio. Se o primeiro arranque exceder o tempo limite, inicie-o novamente.

Trabalhar em várias aplicações ao mesmo tempo

Cada aplicação aberta, e cada cópia aberta de uma aplicação, é a sua própria instância, com o seu próprio ID. O agente dá um nome à instância em que trabalha. Quando mais do que uma instância corresponde ao seu pedido, o agente pergunta a qual se refere. Quando reinicia uma aplicação, esta recebe um novo ID, e o agente volta a encontrá-la.

Desinstalar um conector

A forma mais simples é pedir ao seu agente. Para desinstalar um conector você próprio, 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, elimine a pasta .meshy-dcc do projeto.
• Godot: elimine addons/meshy_dcc_godot e .meshy-dcc do projeto.
• Unreal Engine: elimine Plugins/MeshyDccUnreal e .meshy-dcc do projeto.
• Outras aplicações: pergunte ao seu agente. Ele sabe quais os ficheiros que cada conector adicionou, e lista-os antes de eliminar o que quer que seja.