Dokumentasi

Semua yang Anda butuhkan untuk mulai produktif dengan Numivo, dari instalasi hingga aturan species tingkat lanjut. Untuk Unreal Engine 5 dan Unity.

Ikhtisar

Numivo adalah toolkit editor untuk level design. Terdiri atas tiga bagian: layanan desktop (mengelola pustaka dan preset Anda), plugin engine (Unreal atau Unity), dan core bersama yang menghubungkan keduanya.

Prinsip terpentingnya: Numivo tidak terlihat saat runtime. Semua yang Anda tempatkan dibake menjadi aset engine native: instanced mesh, foliage, material standar. Build Anda tidak punya ketergantungan pada Numivo.

Instalasi

Unduh installer untuk sistem operasi Anda dari halaman instalasi. Installer menyiapkan layanan desktop dan dapat memasang plugin engine secara otomatis.

Instalasi manual di Unity lewat Package Manager menggunakan Git URL:

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

Untuk Unreal, Anda juga bisa menyalin plugin ke folder plugin engine secara manual lalu mengaktifkannya di Edit → Plugins.

Panduan cepat: scene pertama Anda dalam 5 menit

Setelah instalasi, buka panel Numivo (Window → Numivo). Rute tercepat menuju scene yang sudah tertanam:

Seret 3–5 aset pohon dari content browser ke species baru bernama “Trees”.
Atur density ke sekitar 60 % dan batasi kemiringan ke 0–35°.
Pilih ukuran brush dengan roda mouse lalu sapukan ke seluruh terrain Anda.
Buat species kedua bernama “Rocks” dan beri aturan Avoid: Trees (radius 2 m).
Tekan B untuk mode blend dan lelehkan batuannya ke dalam terrain.

Tips: setiap kolom angka menerima titik maupun koma sebagai pemisah desimal, termasuk dari numpad.

Surface Scatter

Scatter menempatkan aset pada permukaan secara wajar secara fisik. Setiap species (kelompok aset) punya aturannya sendiri: density, mask kemiringan dan ketinggian, clustering, serta relasi dengan species lain.

Parameter utamanya:

Parameter	Efek
`Density`	Target instance per meter persegi, dimodulasi oleh kekuatan brush.
`Slope Mask`	Rentang kemiringan yang diizinkan dalam derajat. Di luar itu tidak ada yang ditempatkan.
`Clustering`	0 = distribusi merata, 1 = pengelompokan alami yang kuat.
`Align to Normal`	Instance memiringkan diri mengikuti permukaan alih-alih berdiri tegak.

Melukis: klik kiri menyebarkan aset, Shift + seret menghapus, roda mouse mengubah ukuran brush. Seluruh sapuan dihitung sebagai satu langkah undo.

Mesh Blending

Blending membuat mesh menyatu secara visual dengan terrain. Geometri sama sekali tidak berubah: transisinya dihitung di material dari ketinggian dan tekstur terrain, lalu ditulis ke material standar saat proses bake.

Pilih sebuah mesh, tekan B, lalu geser slider Blend Distance. Kurva falloff mengatur seberapa lembut transisinya memudar. “Preview Seams” menampilkan heatmap zona transisi.

Blending membutuhkan akses baca ke tekstur terrain. Untuk level World Partition di UE, cell yang terpengaruh harus dalam keadaan dimuat.

Grid

Tool grid mendistribusikan aset dalam pola beraturan: persegi panjang, lingkaran, poligon (jumlah sisi dapat diatur, misalnya 6 sisi menghasilkan heksagon), dan cell spline bebas.

Setiap cell dapat diputar bertahap (“spin”), digeser acak, dan diproyeksikan ke permukaan. Mask memotong cell dengan rapi: ideal untuk plaza, pemakaman, ladang panel surya, atau kebun buah.

Measure

Tool measure (M) mengukur titik ke titik, secara berantai, atau sebagai jarak minimum antara dua objek. Snapping mengunci ke vertex, edge, dan grid.

Pengukuran disimpan dengan nama di daftar pengukuran dan dapat diekspor sebagai CSV. Saat Anda keluar dari tool, semua garis bantu hilang: tidak ada sisa apa pun di scene.

Content Browser

Browser mengindeks pustaka aset Anda secara lokal (SQLite) dan tetap mulus di atas satu juta entri: hasil pencarian divirtualisasi, thumbnail dibuat lewat pipeline latar belakang.

Pencarian memahami nama, path, dan (bila AI tagging diaktifkan) deskripsi bebas seperti “mossy cliff”. AI tagging bersifat opt-in; tanpa itu, tidak ada aset yang pernah meninggalkan komputer Anda.

Species & Preset

Species menggabungkan aset dengan aturan. Relasi antar-species mengatur koeksistensi: Avoid menjaga jarak, Attract mencari kedekatan. Begitulah jamur tumbuh di pangkal batang sementara jalan setapak tetap bersih.

Satu setup lengkap dapat disimpan dan dibagikan sebagai preset, sebuah file JSON yang bisa dipindahkan antara Unreal dan Unity:

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

Shortcut

Shortcut	Aksi
`S`	Brush scatter
`B`	Mode blend
`M`	Tool measure
`G`	Tool grid
`Mouse wheel`	Ubah ukuran brush
`Shift` + Drag	Hapus
`Ctrl` / `Shift` + Slider	Langkah slider halus / kasar
`Ctrl` + `Z`	Batalkan sapuan terakhir

Troubleshooting

Panel tidak menemukan layanan desktop.

Layanan ini mendengarkan secara lokal di port 47615. Periksa apakah firewall memblokir koneksi lokal, lalu mulai ulang layanan dari ikon tray.

Plugin hilang setelah update engine.

Update engine terpasang ke folder baru. Jalankan kembali installer Numivo: installer akan mendeteksi versi baru dan menyalin plugin ke dalamnya.

Thumbnail tetap abu-abu.

Pipeline thumbnail berjalan dengan prioritas rendah. Pada pustaka yang sangat besar, pemrosesan pertama bisa memakan waktu; progresnya ditampilkan di bagian bawah browser.

Scatter terlihat berbeda di build dibanding di editor.

Pastikan Anda sudah melakukan bake sebelum build (Bake to Native). Instance pratinjau yang belum dibake hanya ada di editor.