Pre-generasi world

Buat chunk di sekitar spawn sebelum server ramai dengan /nusa pregen, pahami radius dalam chunk, dan atur agar TPS tetap aman.

Di halaman ini

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 spawnLebar 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
PerintahFungsi
/nusa pregen <radius-dalam-chunk> <world>Memulai pre-generasi di sekitar spawn world tersebut
/nusa pregen statusProgres: chunk dibuat, sudah ada, dilewati karena pemain, dan gagal
/nusa pregen pauseMenjeda tanpa kehilangan posisi
/nusa pregen resumeMelanjutkan dari posisi terakhir
/nusa pregen cancelMenghentikan pekerjaan
/nusa pregen helpRingkasan perintah

Langkah aman menjelang pembukaan:

  1. Nyalakan server tanpa pemain (atau saat sepi).
  2. Jalankan nusa pregen 64 world di console.
  3. Pantau dengan nusa pregen status sampai statusnya FINISHED.
  4. 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
KeyDefaultArti
minimum-tps18.0Jeda saat TPS turun di bawah angka ini
resume-tps19.0Lanjut lagi setelah TPS kembali ke angka ini
max-average-mspt40.0Jeda saat rata-rata MSPT melewati angka ini
max-in-flight2Chunk yang diproses bersamaan. Boleh dinaikkan saat maintenance tanpa pemain
max-radius-chunks256Radius terbesar yang diizinkan
player-buffer-chunks2Jarak 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

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…