Tài liệu

Mọi thứ bạn cần để làm việc hiệu quả với Numivo, từ cài đặt cho đến các quy tắc species nâng cao. Cho Unreal Engine 5 và Unity.

Tổng quan

Numivo là một bộ công cụ trong editor dành cho thiết kế màn chơi. Nó gồm ba phần: dịch vụ desktop (quản lý thư viện và preset của bạn), plugin cho engine (Unreal hoặc Unity) và lõi dùng chung kết nối cả hai.

Nguyên tắc quan trọng nhất: Numivo vô hình ở runtime. Mọi thứ bạn đặt đều được bake thành asset gốc của engine: instanced mesh, foliage, material tiêu chuẩn. Bản build của bạn không hề phụ thuộc vào Numivo.

Cài đặt

Tải trình cài đặt cho hệ điều hành của bạn từ trang cài đặt. Nó thiết lập dịch vụ desktop và có thể tự động cài plugin cho engine.

Cài Unity thủ công qua Package Manager bằng một URL Git:

// Unity → Window → Package Manager → “+” → Add package from git URL
https://github.com/numivo/com.numivo.leveldesign.git#v1.4.0

Với Unreal, bạn cũng có thể chép plugin vào thư mục plugin của engine theo cách thủ công rồi bật nó trong Edit → Plugins.

Khởi động nhanh: scene đầu tiên của bạn trong 5 phút

Sau khi cài xong, hãy mở bảng Numivo (Window → Numivo). Con đường nhanh nhất tới một scene đã phủ cây cối:

Kéo 3–5 asset cây từ content browser vào một species mới tên “Trees”.
Đặt mật độ khoảng 60 % và giới hạn độ dốc trong khoảng 0–35°.
Chọn kích thước cọ bằng con lăn chuột rồi vẽ lên địa hình của bạn.
Tạo species thứ hai tên “Rocks” và đặt cho nó quy tắc Avoid: Trees (bán kính 2 m).
Nhấn B để vào chế độ blend và hòa những tảng đá vào địa hình.

Mẹo: mọi ô nhập số đều chấp nhận cả dấu chấm lẫn dấu phẩy làm dấu thập phân, kể cả khi nhập từ bàn phím số.

Surface Scatter

Scatter đặt asset lên bề mặt theo cách hợp lý về mặt vật lý. Mỗi species (nhóm asset) có quy tắc riêng: mật độ, mask độ dốc và độ cao, phân cụm và quan hệ với các species khác.

Các tham số chính:

Tham số	Tác dụng
`Mật độ`	Số instance mục tiêu trên mỗi mét vuông, được điều biến theo lực cọ.
`Mask độ dốc`	Khoảng độ dốc cho phép, tính bằng độ. Không có gì được đặt ngoài khoảng này.
`Phân cụm`	0 = phân bố đều, 1 = gom nhóm tự nhiên rất mạnh.
`Căn theo pháp tuyến`	Instance nghiêng theo bề mặt thay vì đứng thẳng.

Vẽ: chuột trái rải asset, Shift + kéo để xóa, con lăn chuột đổi kích thước cọ. Mọi nét vẽ là một bước undo duy nhất.

Mesh Blending

Blending khiến mesh hòa vào địa hình về mặt thị giác. Nó không thay đổi hình học: phần chuyển tiếp được tính trong material từ độ cao và texture của địa hình, rồi được ghi vào material tiêu chuẩn khi bake.

Chọn một mesh, nhấn B và kéo thanh trượt Blend Distance. Đường cong falloff quyết định phần chuyển tiếp mờ đi mềm mại đến đâu. “Preview Seams” phủ lên một heatmap của vùng chuyển tiếp.

Blending cần quyền đọc texture của địa hình. Với các level dùng World Partition trong UE, các cell liên quan phải được load.

Grids

Công cụ grids phân bố asset theo các mẫu đều đặn: hình chữ nhật, hình tròn, đa giác (số cạnh điều chỉnh được, 6 cạnh cho ra hình lục giác) và các ô spline tự do.

Mỗi ô có thể xoay theo bước (“spin”), lệch ngẫu nhiên và chiếu lên bề mặt. Mask cắt các ô gọn gàng, lý tưởng cho quảng trường, nghĩa trang, trang trại điện mặt trời hay vườn cây ăn quả.

Measure

Công cụ đo (M) đo từ điểm tới điểm, đo theo chuỗi, hoặc đo khoảng cách nhỏ nhất giữa hai đối tượng. Snapping bám vào vertex, cạnh và lưới.

Các phép đo được lưu kèm tên trong danh sách đo và có thể xuất ra CSV. Khi bạn rời công cụ, mọi đường dẫn hướng biến mất: không còn gì sót lại trong scene.

Content Browser

Trình duyệt lập chỉ mục thư viện asset của bạn ngay trên máy (SQLite) và vẫn mượt khi vượt quá một triệu mục: kết quả được ảo hóa, thumbnail được tạo trong một pipeline chạy nền.

Tìm kiếm hiểu được tên, đường dẫn và (khi bật gắn thẻ bằng AI) cả những mô tả tự do như “vách đá phủ rêu”. Gắn thẻ AI là tùy chọn tự bật; nếu không bật, không asset nào rời khỏi máy của bạn.

Species & preset

Species gói asset lại cùng với quy tắc. Quan hệ giữa các species điều khiển việc chung sống: Avoid giữ khoảng cách, Attract tìm đến gần nhau. Nhờ vậy nấm mọc ở gốc cây trong khi lối đi vẫn thông thoáng.

Một thiết lập hoàn chỉnh có thể được lưu lại và chia sẻ dưới dạng preset, một tệp JSON chuyển qua lại được giữa Unreal và Unity:

{
  "species": [{
    "name": "Pine",
    "density": 0.6,
    "slope": [0, 35],
    "clustering": 0.7,
    "relations": [{ "type": "avoid", "target": "Rocks", "radius": 2.0 }]
  }]
}

Phím tắt

Phím tắt	Hành động
`S`	Cọ scatter
`B`	Chế độ blend
`M`	Công cụ đo
`G`	Công cụ grids
`Mouse wheel`	Đổi kích thước cọ
`Shift` + Drag	Xóa
`Ctrl` / `Shift` + Slider	Bước trượt tinh / thô
`Ctrl` + `Z`	Hoàn tác nét vẽ cuối

Xử lý sự cố

Bảng điều khiển không tìm thấy dịch vụ desktop.

Dịch vụ lắng nghe cục bộ ở cổng 47615. Hãy kiểm tra xem tường lửa có chặn kết nối cục bộ không, rồi khởi động lại dịch vụ từ biểu tượng khay hệ thống.

Plugin biến mất sau khi cập nhật engine.

Bản cập nhật engine được cài vào một thư mục mới. Hãy chạy lại trình cài đặt Numivo: nó nhận diện phiên bản mới và chép plugin vào đó.

Thumbnail cứ xám mãi.

Pipeline thumbnail chạy ở mức ưu tiên thấp. Với thư viện rất lớn, lượt quét đầu tiên có thể mất một lúc; tiến độ hiển thị ở dưới cùng của trình duyệt.

Scatter trong bản build trông khác với trong editor.

Hãy chắc chắn bạn đã bake trước khi build (Bake to Native). Các instance xem trước chưa bake chỉ tồn tại trong editor.