Pre-generasi world
Buat chunk di sekitar spawn sebelum server ramai dengan /nusa pregen, pahami radius dalam chunk, dan atur agar TPS tetap aman.
Pre-generasi berarti membuat chunk (potongan map) lebih dulu, sebelum pemain menjelajah. Hasilnya, saat pemain berjalan jauh, server cukup membaca chunk yang sudah ada dari disk, bukan membuat terrain baru di tengah permainan. Ini sangat membantu menjelang pembukaan server atau season baru.
Radius dihitung dalam chunk
Radius pada /nusa pregen dihitung dalam chunk, bukan blok. Satu chunk = 16 × 16 blok.
| Radius (chunk) | Kira-kira area dari spawn | Lebar total area |
|---|---|---|
| 32 | ±512 blok | ±1.040 blok |
| 64 | ±1.024 blok | ±2.064 blok |
| 128 | ±2.048 blok | ±4.112 blok |
| 256 (batas default) | ±4.096 blok | ±8.208 blok |
Area yang dibuat berbentuk persegi di sekitar chunk spawn world, berisi (2 × radius + 1)² chunk. Contohnya, radius 22 berarti 2.025 chunk.
Batas radius diatur oleh pre-generation.max-radius-chunks. Default-nya 256 chunk dan bisa diatur dari 1 sampai 2048. Radius besar butuh waktu lama dan ruang disk yang besar.
Cara memakai
nusa pregen 64 world
nusa pregen status
nusa pregen pause
nusa pregen resume
nusa pregen cancel| Perintah | Fungsi |
|---|---|
/nusa pregen <radius-dalam-chunk> <world> | Memulai pre-generasi di sekitar spawn world tersebut |
/nusa pregen status | Progres: chunk dibuat, sudah ada, dilewati karena pemain, dan gagal |
/nusa pregen pause | Menjeda tanpa kehilangan posisi |
/nusa pregen resume | Melanjutkan dari posisi terakhir |
/nusa pregen cancel | Menghentikan pekerjaan |
/nusa pregen help | Ringkasan perintah |
Langkah aman menjelang pembukaan:
- Nyalakan server tanpa pemain (atau saat sepi).
- Jalankan
nusa pregen 64 worlddi console. - Pantau dengan
nusa pregen statussampai statusnyaFINISHED. - Ulangi untuk world lain jika perlu, misalnya
nusa pregen 32 world_nether.
Hanya satu pekerjaan pre-generasi yang bisa berjalan dalam satu waktu, dan hanya world yang sedang dimuat yang bisa dipilih. Izin yang dibutuhkan: nusaspigot.command.pregen (default OP).
Menjaga TPS tetap aman
Pre-generasi otomatis mengalah ketika server sibuk. Pekerjaan baru berhenti dimulai saat TPS turun di bawah minimum-tps atau rata-rata MSPT melewati max-average-mspt, lalu lanjut lagi setelah server pulih. Chunk di sekitar pemain yang sedang online juga dilewati sementara, supaya pemain tidak terganggu.
pre-generation:
minimum-tps: 18.0
resume-tps: 19.0
max-average-mspt: 40.0
max-in-flight: 2
requests-per-tick: 1
max-radius-chunks: 256
player-buffer-chunks: 2| Key | Default | Arti |
|---|---|---|
minimum-tps | 18.0 | Jeda saat TPS turun di bawah angka ini |
resume-tps | 19.0 | Lanjut lagi setelah TPS kembali ke angka ini |
max-average-mspt | 40.0 | Jeda saat rata-rata MSPT melewati angka ini |
max-in-flight | 2 | Chunk yang diproses bersamaan. Boleh dinaikkan saat maintenance tanpa pemain |
max-radius-chunks | 256 | Radius terbesar yang diizinkan |
player-buffer-chunks | 2 | Jarak aman tambahan di sekitar pemain yang dilewati |
Simpan perubahan di nusa-global.yml, lalu restart penuh. Penjelasan semua key ada di Referensi konfigurasi.
Langkah berikutnya
- Pantau dampaknya dengan Diagnosis lag & auto-tune.
- Lindungi hasil kerja Anda dengan Backup world.