Connector

Cài đặt một connector để cho phép tác nhân của bạn hoạt động bên trong một ứng dụng. Một số connector được cài đặt một lần cho mỗi máy tính, như Blender. Những connector khác được cài đặt một lần cho mỗi dự án, như Unity, Godot và Unreal Engine.

Tổng quan

Cài đặt các connector từ trang Connectors trong cửa sổ Meshy DCC Core (meshy-dcc ui), hoặc yêu cầu tác nhân của bạn cài đặt một connector. Meshy DCC Core kiểm tra mỗi lượt tải xuống theo checksum SHA-256 trước khi cài đặt bất cứ thứ gì.

Bảng sau đây cho thấy mỗi connector được cài đặt ở đâu và hỗ trợ những phiên bản nào của ứng dụng của nó.

Mọi connector đều chạy trên macOS (Apple Silicon) và Windows x64, ngoại trừ 3ds Max, chỉ chạy trên Windows.

Blender

Để cài đặt connector Blender, hãy làm theo các bước sau:

1. Trong Connectors, nhấp Install bên cạnh Blender.
2. Khởi động lại Blender nếu nó đang mở, hoặc khởi động như bình thường.

Meshy DCC Core tìm Blender ở những vị trí thông thường của nó: /Applications/Blender.app trên macOS và C:\Program Files\Blender Foundation trên Windows. Nếu Blender ở nơi khác, hoặc bạn có nhiều hơn một bản sao, cửa sổ sẽ hỏi nó ở đâu. Nhập đường dẫn đầy đủ của ứng dụng bạn muốn sử dụng, ví dụ /Applications/Blender 4.5.app.

Connector này là một tiện ích mở rộng Blender có tên Meshy DCC. Nó khởi động cùng Blender, vì vậy mỗi Blender bạn mở sẽ xuất hiện dưới Connected now.

Để cài đặt nó từ một terminal, chạy:

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

Khi Blender không ở vị trí thông thường, hãy thêm --dcc-path <path to Blender>.

Unity

Để cài đặt connector Unity trong một dự án, hãy làm theo các bước sau:

1. Đóng dự án trong Unity.
2. Trong Connectors, nhấp Add to a project bên cạnh Unity, nhập đường dẫn đầy đủ của thư mục dự án, và nhấp Install.
3. Mở dự án trong Unity như bình thường.

Connector thêm gói Meshy DCC Unity và một thư mục .meshy-dcc vào dự án. Nó sử dụng phiên bản Unity Editor mà tệp ProjectSettings/ProjectVersion.txt của dự án chỉ định, vì vậy phiên bản đó phải được cài đặt trong Unity Hub.

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

Godot

Để cài đặt connector Godot trong một dự án, hãy làm theo các bước sau:

1. Đóng dự án trong Godot.
2. Trong Connectors, nhấp Add to a project bên cạnh Godot, nhập đường dẫn đầy đủ của thư mục dự án, và nhấp Install.
3. Mở dự án trong Godot như bình thường.

Connector thêm add-on addons/meshy_dcc_godot, bật nó lên, và thêm một thư mục .meshy-dcc. Nó tìm Godot trên PATH của bạn hoặc dưới dạng Godot.app trong /Applications. Đối với vị trí khác, và luôn luôn trên Windows, hãy đặt biến môi trường MESHY_DCC_GODOT_EXECUTABLE trỏ đến trình chỉnh sửa Godot.

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

Unreal Engine

Để cài đặt connector Unreal Engine trong một dự án, hãy làm theo các bước sau:

1. Đóng dự án trong Unreal Engine.
2. Trong Connectors, nhấp Add to a project bên cạnh Unreal Engine, nhập thư mục chứa tệp .uproject, và nhấp Install.
3. Mở dự án như bình thường.

Connector sao chép một plugin vào thư mục Plugins/MeshyDccUnreal của dự án và biên dịch nó bằng engine của bạn, việc này mất từ vài giây đến vài phút. Để biên dịch nó, bạn cần:

• macOS: Xcode, ở một phiên bản mà engine của bạn chấp nhận. Unreal Engine 5.7 chấp nhận Xcode đến phiên bản 26.
• Windows: Visual Studio 2022 với workload Game development with C++.

Trên Windows, hãy giữ dự án trong một thư mục có đường dẫn chỉ chứa chữ cái tiếng Anh, chữ số và dấu câu. Unreal Engine không thể biên dịch plugin với các ký tự khác, vì vậy việc cài đặt sẽ dừng lại và khôi phục về trạng thái trước.

Connector sử dụng engine khớp với phiên bản engine của dự án trong Epic Games Launcher. Đối với bản build từ mã nguồn hoặc một vị trí khác, hãy đặt MESHY_DCC_UNREAL_ENGINE trỏ đến thư mục engine. Unreal Engine 4 không được hỗ trợ.

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

Thêm ứng dụng

Các connector này được cài đặt theo cùng một cách: từ Connectors, hoặc bằng meshy-dcc install --dcc-type <app> --project <folder> --execute.

• OpenSCAD: connector hoạt động trên các tệp .scad trong một thư mục dự án và chạy OpenSCAD cho mỗi lần xuất và xem trước, vì vậy không có cửa sổ OpenSCAD nào mở ra. Nó có thể đặt một mô hình Meshy lên đế in và xuất STL hoặc 3MF. Trên Apple Silicon, nó cần một bản snapshot phát triển của OpenSCAD.
• Material Maker: connector xây dựng và chỉnh sửa các đồ thị vật liệu trong một thư mục và xuất các bộ texture PBR cho Blender, Godot, Unity, hoặc Unreal Engine. Mỗi lần xuất sẽ tạm thời đưa Material Maker lên trên cùng. Connector hoạt động trên các tệp đồ thị, không phải trên một cửa sổ Material Maker đang mở. Hãy đóng một đồ thị trong Material Maker trước khi tác nhân thay đổi nó, và yêu cầu tác nhân mở kết quả cho bạn khi hoàn tất.
• FreeCAD: connector hoạt động trên các tài liệu trong một thư mục dự án và chạy FreeCAD ở chế độ nền cho mỗi bước. Nó nhập các mô hình GLB của Meshy dưới dạng mesh, cùng với STEP, IGES, STL và OBJ.
• Roblox Studio: chọn một thư mục chứa một tệp place (.rbxl hoặc .rbxlx). Connector thêm một plugin Studio và mở place đó. Các mô hình từ Meshy chỉ tồn tại trong phiên Studio, vì Roblox không lưu chúng cùng với một place. Việc chạy Luau vẫn tắt cho đến khi bạn nhấp Allow Luau trong thanh công cụ Meshy DCC.

Ứng dụng chuyên nghiệp

• Houdini: cài đặt một lần cho mỗi phiên bản Houdini, dưới dạng một gói Houdini trong tùy chọn (preferences) Houdini của bạn. Khi biến HOME của bạn được đặt, Houdini sẽ lấy thư mục preferences từ đó.
• Maya: cài đặt một lần cho mỗi máy tính, dưới dạng một mô-đun Maya. Các mô hình FBX của Meshy đi kèm với một vật liệu Standard Surface và các bản đồ texture của chúng.
• 3ds Max (Windows): cài đặt một lần cho mỗi phiên bản 3ds Max, dưới dạng một script khởi động. Các mô hình FBX của Meshy đi kèm với một vật liệu Physical.
• Substance 3D Painter: cài đặt một lần cho mỗi máy tính, dưới dạng một plugin khởi động. Tác nhân có thể bắt đầu một dự án từ một mô hình Meshy, thêm các lớp PBR, và xuất texture.
• ZBrush: chọn một thư mục dự án. Tác nhân làm việc trong một ZBrush mà Meshy DCC Core khởi động cho thư mục đó, không phải trong một ZBrush mà bạn tự mở. Nếu lần khởi động đầu tiên hết thời gian chờ, hãy khởi động lại.

Làm việc trong nhiều ứng dụng cùng lúc

Mỗi ứng dụng đang mở, và mỗi bản sao đang mở của một ứng dụng, là một thực thể (instance) riêng với ID riêng. Tác nhân đặt tên cho thực thể mà nó đang làm việc trong đó. Khi có nhiều hơn một thực thể phù hợp với yêu cầu của bạn, tác nhân sẽ hỏi bạn muốn nói đến thực thể nào. Khi bạn khởi động lại một ứng dụng, nó sẽ nhận một ID mới, và tác nhân sẽ tìm lại nó.

Gỡ cài đặt một connector

Cách đơn giản nhất là hỏi tác nhân của bạn. Để tự gỡ cài đặt một connector, hãy thực hiện một trong những cách sau:

• Blender: trong Edit > Preferences > Get Extensions, tìm Meshy DCC và gỡ cài đặt nó.
• Unity: xóa gói Meshy DCC Unity trong Package Manager, sau đó xóa thư mục .meshy-dcc của dự án.
• Godot: xóa addons/meshy_dcc_godot và .meshy-dcc khỏi dự án.
• Unreal Engine: xóa Plugins/MeshyDccUnreal và .meshy-dcc khỏi dự án.
• Các ứng dụng khác: hãy hỏi tác nhân của bạn. Nó biết các tệp mà mỗi connector đã thêm, và nó sẽ liệt kê chúng trước khi xóa bất cứ thứ gì.