Konektor

Instal konektor agar agen Anda dapat bekerja di dalam satu aplikasi. Beberapa konektor diinstal sekali per komputer, seperti Blender. Yang lain diinstal sekali per proyek, seperti Unity, Godot, dan Unreal Engine.

Ringkasan

Instal konektor dari halaman Connectors pada jendela Meshy DCC Core (meshy-dcc ui), atau minta agen Anda untuk menginstalnya. Meshy DCC Core memeriksa setiap unduhan terhadap checksum SHA-256-nya sebelum menginstal apa pun.

Tabel berikut menunjukkan di mana setiap konektor diinstal dan versi aplikasi apa saja yang didukungnya.

Setiap konektor berjalan di macOS (Apple Silicon) dan Windows x64, kecuali 3ds Max, yang hanya berjalan di Windows.

Blender

Untuk menginstal konektor Blender, ikuti langkah-langkah berikut:

1. Di Connectors, klik Install di sebelah Blender.
2. Mulai ulang Blender jika sedang terbuka, atau jalankan seperti biasa.

Meshy DCC Core menemukan Blender di lokasi biasanya: /Applications/Blender.app di macOS dan C:\Program Files\Blender Foundation di Windows. Jika Blender berada di lokasi lain, atau Anda memiliki lebih dari satu salinan, jendela akan menanyakan di mana lokasinya. Masukkan path lengkap aplikasi yang ingin Anda gunakan, misalnya /Applications/Blender 4.5.app.

Konektor ini adalah ekstensi Blender bernama Meshy DCC. Konektor ini dimulai bersama Blender, sehingga setiap Blender yang Anda buka akan muncul di bawah Connected now.

Untuk menginstalnya dari terminal, jalankan:

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

Ketika Blender tidak berada di lokasi biasanya, tambahkan --dcc-path <path ke Blender>.

Unity

Untuk menginstal konektor Unity di sebuah proyek, ikuti langkah-langkah berikut:

1. Tutup proyek di Unity.
2. Di Connectors, klik Add to a project di sebelah Unity, masukkan path lengkap folder proyek, lalu klik Install.
3. Buka proyek di Unity seperti biasa.

Konektor ini menambahkan paket Meshy DCC Unity dan folder .meshy-dcc ke proyek. Konektor ini menggunakan versi Unity Editor yang tercantum dalam ProjectSettings/ProjectVersion.txt milik proyek, sehingga versi tersebut harus sudah terinstal di Unity Hub.

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

Godot

Untuk menginstal konektor Godot di sebuah proyek, ikuti langkah-langkah berikut:

1. Tutup proyek di Godot.
2. Di Connectors, klik Add to a project di sebelah Godot, masukkan path lengkap folder proyek, lalu klik Install.
3. Buka proyek di Godot seperti biasa.

Konektor ini menambahkan add-on addons/meshy_dcc_godot, mengaktifkannya, dan menambahkan folder .meshy-dcc. Konektor ini menemukan Godot pada PATH Anda atau sebagai Godot.app di /Applications. Untuk lokasi lain, dan selalu di Windows, atur variabel lingkungan MESHY_DCC_GODOT_EXECUTABLE ke editor Godot.

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

Unreal Engine

Untuk menginstal konektor Unreal Engine di sebuah proyek, ikuti langkah-langkah berikut:

1. Tutup proyek di Unreal Engine.
2. Di Connectors, klik Add to a project di sebelah Unreal Engine, masukkan folder yang berisi file .uproject, lalu klik Install.
3. Buka proyek seperti biasa.

Konektor ini menyalin plugin ke dalam folder Plugins/MeshyDccUnreal milik proyek dan membangunnya dengan engine Anda, yang membutuhkan waktu dari beberapa detik hingga beberapa menit. Untuk membangunnya, Anda memerlukan:

• macOS: Xcode, dalam versi yang diterima oleh engine Anda. Unreal Engine 5.7 menerima Xcode hingga versi 26.
• Windows: Visual Studio 2022 dengan workload Game development with C++.

Di Windows, simpan proyek dalam folder yang path-nya hanya berisi huruf, angka, dan tanda baca bahasa Inggris. Unreal Engine tidak dapat membangun plugin dengan karakter lain, sehingga instalasi akan berhenti dan dikembalikan ke kondisi semula.

Konektor ini menggunakan engine yang cocok dengan versi engine proyek di Epic Games Launcher. Untuk build sumber atau lokasi lain, atur MESHY_DCC_UNREAL_ENGINE ke folder engine. Unreal Engine 4 tidak didukung.

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

Aplikasi lainnya

Konektor ini diinstal dengan cara yang sama: dari Connectors, atau dengan meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: konektor ini bekerja pada file .scad di dalam folder proyek dan menjalankan OpenSCAD untuk setiap ekspor dan pratinjau, sehingga tidak ada jendela OpenSCAD yang terbuka. Konektor ini dapat menempatkan model Meshy di atas print base dan mengekspor STL atau 3MF. Di Apple Silicon, konektor ini memerlukan snapshot pengembangan OpenSCAD.
• Material Maker: konektor ini membangun dan mengedit graf material di dalam folder dan mengekspor set tekstur PBR untuk Blender, Godot, Unity, atau Unreal Engine. Setiap ekspor sejenak membawa Material Maker ke depan. Konektor ini bekerja pada file graf, bukan pada jendela Material Maker yang sedang terbuka. Tutup graf di Material Maker sebelum agen mengubahnya, dan minta agen untuk membuka hasilnya untuk Anda setelah selesai.
• FreeCAD: konektor ini bekerja pada dokumen di dalam folder proyek dan menjalankan FreeCAD di latar belakang untuk setiap langkah. Konektor ini mengimpor model GLB Meshy sebagai mesh, bersama dengan STEP, IGES, STL, dan OBJ.
• Roblox Studio: pilih folder yang berisi satu file place (.rbxl atau .rbxlx). Konektor ini menambahkan plugin Studio dan membuka place tersebut. Model dari Meshy hanya bertahan selama sesi Studio, karena Roblox tidak menyimpannya bersama place. Eksekusi Luau tetap nonaktif hingga Anda mengklik Allow Luau pada toolbar Meshy DCC.

Aplikasi profesional

• Houdini: diinstal sekali per versi Houdini, sebagai paket Houdini di preferensi Houdini Anda. Ketika variabel HOME Anda sudah diatur, Houdini mengambil folder preferensi dari sana.
• Maya: diinstal sekali per komputer, sebagai modul Maya. Model FBX Meshy masuk dengan material Standard Surface beserta peta teksturnya.
• 3ds Max (Windows): diinstal sekali per versi 3ds Max, sebagai skrip startup. Model FBX Meshy masuk dengan material Physical.
• Substance 3D Painter: diinstal sekali per komputer, sebagai plugin startup. Agen dapat memulai proyek dari model Meshy, menambahkan lapisan PBR, dan mengekspor tekstur.
• ZBrush: pilih folder proyek. Agen bekerja di ZBrush yang dijalankan oleh Meshy DCC Core untuk folder tersebut, bukan di salinan yang Anda buka sendiri. Jika proses start pertama mengalami timeout, jalankan lagi.

Bekerja di beberapa aplikasi sekaligus

Setiap aplikasi yang terbuka, dan setiap salinan aplikasi yang terbuka, merupakan instance tersendiri dengan ID-nya masing-masing. Agen menyebutkan nama instance tempatnya bekerja. Ketika lebih dari satu instance cocok dengan permintaan Anda, agen akan menanyakan instance mana yang Anda maksud. Saat Anda memulai ulang sebuah aplikasi, aplikasi tersebut mendapatkan ID baru, dan agen akan menemukannya kembali.

Uninstall konektor

Cara paling sederhana adalah dengan meminta agen Anda. Untuk meng-uninstall konektor sendiri, lakukan salah satu hal berikut:

• Blender: di Edit > Preferences > Get Extensions, temukan Meshy DCC dan uninstall.
• Unity: hapus paket Meshy DCC Unity di Package Manager, lalu hapus folder .meshy-dcc milik proyek.
• Godot: hapus addons/meshy_dcc_godot dan .meshy-dcc dari proyek.
• Unreal Engine: hapus Plugins/MeshyDccUnreal dan .meshy-dcc dari proyek.
• Aplikasi lainnya: minta agen Anda. Agen tahu file mana saja yang ditambahkan oleh setiap konektor, dan ia akan mencantumkannya sebelum menghapus apa pun.