커넥터

커넥터를 설치하면 에이전트가 하나의 앱 안에서 작동할 수 있습니다. 일부 커넥터는 Blender처럼 컴퓨터당 한 번 설치됩니다. 다른 커넥터는 Unity, Godot, Unreal Engine처럼 프로젝트당 한 번 설치됩니다.

개요

Meshy DCC Core 창(meshy-dcc ui)의 Connectors 페이지에서 커넥터를 설치하거나, 에이전트에게 설치를 요청하세요. Meshy DCC Core는 무언가를 설치하기 전에 모든 다운로드를 SHA-256 체크섬으로 검증합니다.

Blender가 설치되어 있고, Godot는 한 프로젝트에 설치되어 있으며, 다른 앱에는 설치 또는 프로젝트에 추가 버튼이 표시된 Meshy DCC Core 창의 Connectors 페이지

다음 표는 각 커넥터가 설치되는 위치와 지원하는 앱 버전을 보여줍니다.

앱	설치 위치	버전
Blender	Blender, 컴퓨터당 한 번	4.5 ~ 5.2
Unity	각 프로젝트	2018.4 ~ 6000.5
Godot	각 프로젝트	4.4 ~ 4.7
Unreal Engine	각 프로젝트	5.0 ~ 5.8
Maya	Maya, 컴퓨터당 한 번	2023 ~ 2027
3ds Max	3ds Max, 버전당 한 번	2023 ~ 2027
Houdini	Houdini, 버전당 한 번	20.5 ~ 22.0
Substance 3D Painter	Painter, 컴퓨터당 한 번	10.0 ~ 12.1
ZBrush	각 프로젝트 폴더	2026.1 ~ 2026.2
Roblox Studio	각 place	현재 릴리스
FreeCAD	각 프로젝트 폴더	1.0 ~ 1.1
OpenSCAD	각 프로젝트 폴더	2021.01, 그리고 2026.09 ~ 2026.10 스냅샷
Material Maker	각 머티리얼 폴더	1.7

3ds Max는 Windows에서만 실행되는 것을 제외하면, 모든 커넥터는 macOS(Apple Silicon)와 Windows x64에서 실행됩니다.

Blender

Blender 커넥터를 설치하려면 다음 단계를 따르세요.

Connectors에서 Blender 옆의 Install을 클릭합니다.
Blender가 열려 있다면 다시 시작하거나, 평소처럼 실행합니다.

Meshy DCC Core는 Blender를 일반적인 위치에서 찾습니다. macOS에서는 /Applications/Blender.app, Windows에서는 C:\Program Files\Blender Foundation입니다. Blender가 다른 위치에 있거나 여러 복사본이 있는 경우, 창에서 위치를 물어봅니다. 사용할 앱의 전체 경로를 입력하세요. 예: /Applications/Blender 4.5.app.

이 커넥터는 Meshy DCC라는 이름의 Blender 확장 기능입니다. Blender와 함께 시작되므로, 여는 모든 Blender가 Connected now에 표시됩니다.

터미널에서 설치하려면 다음을 실행하세요.

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

Blender가 일반적인 위치에 없다면 --dcc-path <Blender 경로>를 추가하세요.

Unity

프로젝트에 Unity 커넥터를 설치하려면 다음 단계를 따르세요.

Unity에서 프로젝트를 닫습니다.
Connectors에서 Unity 옆의 Add to a project를 클릭하고, 프로젝트 폴더의 전체 경로를 입력한 다음 Install을 클릭합니다.
평소처럼 Unity에서 프로젝트를 엽니다.

이 커넥터는 Meshy DCC Unity 패키지와 .meshy-dcc 폴더를 프로젝트에 추가합니다. 프로젝트의 ProjectSettings/ProjectVersion.txt에 명시된 Unity 에디터 버전을 사용하므로, 해당 버전이 Unity Hub에 설치되어 있어야 합니다.

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

Godot

프로젝트에 Godot 커넥터를 설치하려면 다음 단계를 따르세요.

Godot에서 프로젝트를 닫습니다.
Connectors에서 Godot 옆의 Add to a project를 클릭하고, 프로젝트 폴더의 전체 경로를 입력한 다음 Install을 클릭합니다.
평소처럼 Godot에서 프로젝트를 엽니다.

이 커넥터는 addons/meshy_dcc_godot 애드온을 추가하고 이를 활성화한 다음 .meshy-dcc 폴더를 추가합니다. PATH에 있는 Godot 또는 /Applications의 Godot.app을 찾습니다. 다른 위치에 있는 경우, 그리고 Windows에서는 항상, MESHY_DCC_GODOT_EXECUTABLE 환경 변수를 Godot 에디터로 설정하세요.

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

Unreal Engine

프로젝트에 Unreal Engine 커넥터를 설치하려면 다음 단계를 따르세요.

Unreal Engine에서 프로젝트를 닫습니다.
Connectors에서 Unreal Engine 옆의 Add to a project를 클릭하고, .uproject 파일이 있는 폴더를 입력한 다음 Install을 클릭합니다.
평소처럼 프로젝트를 엽니다.

이 커넥터는 플러그인을 프로젝트의 Plugins/MeshyDccUnreal 폴더로 복사하고, 사용 중인 엔진으로 빌드합니다. 이 과정은 몇 초에서 몇 분 정도 걸릴 수 있습니다. 빌드하려면 다음이 필요합니다.

macOS: 사용 중인 엔진이 허용하는 버전의 Xcode. Unreal Engine 5.7은 Xcode 26까지 허용합니다.
Windows: Game development with C++ 워크로드가 포함된 Visual Studio 2022.

Windows에서는 경로에 영문자, 숫자, 구두점만 포함된 폴더에 프로젝트를 두세요. Unreal Engine은 다른 문자가 포함된 경로에서는 플러그인을 빌드할 수 없으므로, 설치가 중단되고 롤백됩니다.

이 커넥터는 Epic Games Launcher에서 프로젝트의 엔진 버전과 일치하는 엔진을 사용합니다. 소스 빌드나 다른 위치를 사용하려면 MESHY_DCC_UNREAL_ENGINE을 엔진 폴더로 설정하세요. Unreal Engine 4는 지원되지 않습니다.

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

추가 앱

이 커넥터들은 동일한 방식으로 설치됩니다. Connectors에서 설치하거나, meshy-dcc install --dcc-type <app> --project <folder> --execute 명령으로 설치할 수 있습니다.

OpenSCAD: 이 커넥터는 프로젝트 폴더 안의 .scad 파일을 대상으로 작동하며, 내보내기와 미리보기마다 OpenSCAD를 실행하므로 OpenSCAD 창이 열리지 않습니다. Meshy 모델을 프린트 베이스 위에 세우고 STL 또는 3MF로 내보낼 수 있습니다. Apple Silicon에서는 OpenSCAD 개발 스냅샷이 필요합니다.
Material Maker: 이 커넥터는 폴더 안의 머티리얼 그래프를 빌드하고 편집하며, Blender, Godot, Unity, Unreal Engine용 PBR 텍스처 세트를 내보냅니다. 내보낼 때마다 Material Maker가 잠시 화면 앞으로 나타납니다. 이 커넥터는 열려 있는 Material Maker 창이 아니라 그래프 파일을 대상으로 작동합니다. 에이전트가 그래프를 변경하기 전에 Material Maker에서 그래프를 닫고, 작업이 끝나면 결과물을 열어달라고 에이전트에게 요청하세요.
FreeCAD: 이 커넥터는 프로젝트 폴더 안의 문서를 대상으로 작동하며, 각 단계마다 백그라운드에서 FreeCAD를 실행합니다. Meshy GLB 모델을 메시로 가져오며, STEP, IGES, STL, OBJ도 함께 가져옵니다.
Roblox Studio: place 파일(.rbxl 또는 .rbxlx) 하나가 있는 폴더를 선택하세요. 이 커넥터는 Studio 플러그인을 추가하고 place를 엽니다. Meshy에서 가져온 모델은 Roblox가 place와 함께 저장하지 않으므로 해당 Studio 세션 동안만 유지됩니다. Meshy DCC 툴바에서 Allow Luau를 클릭하기 전까지는 Luau 실행이 꺼져 있습니다.

전문가용 앱

Houdini: Houdini 환경 설정에 Houdini 패키지로서 Houdini 버전당 한 번 설치됩니다. HOME 변수가 설정되어 있으면, Houdini는 그 위치에서 환경 설정 폴더를 찾습니다.
Maya: Maya 모듈로서 컴퓨터당 한 번 설치됩니다. Meshy FBX 모델은 Standard Surface 머티리얼과 텍스처 맵을 포함한 상태로 가져와집니다.
3ds Max (Windows): 시작 스크립트로서 3ds Max 버전당 한 번 설치됩니다. Meshy FBX 모델은 Physical 머티리얼을 포함한 상태로 가져와집니다.
Substance 3D Painter: 시작 플러그인으로서 컴퓨터당 한 번 설치됩니다. 에이전트는 Meshy 모델로 프로젝트를 시작하고, PBR 레이어를 추가하고, 텍스처를 내보낼 수 있습니다.
ZBrush: 프로젝트 폴더를 선택하세요. 에이전트는 사용자가 직접 연 ZBrush가 아니라, Meshy DCC Core가 해당 폴더를 위해 시작한 ZBrush에서 작업합니다. 처음 시작이 시간 초과되면 다시 시작하세요.

여러 앱에서 동시에 작업하기

열려 있는 모든 앱, 그리고 열려 있는 모든 앱의 사본은 각각 고유한 ID를 가진 독립된 인스턴스입니다. 에이전트는 자신이 작업하는 인스턴스의 이름을 알려줍니다. 요청에 맞는 인스턴스가 두 개 이상인 경우, 에이전트는 어떤 것을 의미하는지 물어봅니다. 앱을 다시 시작하면 새 ID를 받게 되며, 에이전트는 이를 다시 찾아냅니다.

커넥터 제거하기

가장 간단한 방법은 에이전트에게 요청하는 것입니다. 직접 커넥터를 제거하려면 다음 중 하나를 수행하세요.

Blender: Edit > Preferences > Get Extensions에서 Meshy DCC를 찾아 제거하세요.
Unity: Package Manager에서 Meshy DCC Unity 패키지를 제거한 다음, 프로젝트의 .meshy-dcc 폴더를 삭제하세요.
Godot: 프로젝트에서 addons/meshy_dcc_godot와 .meshy-dcc를 삭제하세요.
Unreal Engine: 프로젝트에서 Plugins/MeshyDccUnreal과 .meshy-dcc를 삭제하세요.
다른 앱: 에이전트에게 요청하세요. 에이전트는 각 커넥터가 추가한 파일을 알고 있으며, 무언가를 삭제하기 전에 그 목록을 보여줍니다.