Panduan config & contoh siap pakai

Memahami fungsi nusa-global.yml dan nusa-world.yml beserta contoh konfigurasi siap salin untuk SMP, Lobby, dan PvP.

Di halaman ini

NusaSpigot memisahkan seluruh pengaturannya di file sendiri supaya tidak bercampur dengan paper-global.yml atau spigot.yml.

Fungsi tiap file konfigurasi

Nama fileCakupanCara kerja
nusa-global.ymlSeluruh serverFile pengaturan utama di folder root server. Jika ada key yang tidak ditulis, server otomatis memakai nilai default bawaan.
nusa-world.ymlKhusus per worldDigunakan bila Anda ingin mematikan/menyalakan feature-flags tertentu hanya pada satu world saja.
nusa-license.propertiesKode lisensiMenyimpan kode lisensi privat Anda. Lihat NusaCore & lisensi.
nusacore.propertiesOpsi loaderPilihan versi Minecraft, auto-update, dan opsi NusaCore lainnya.
nusa-cloud-bridge.propertiesCloud PanelDibuat otomatis ketika server dihubungkan memakai /nusa link <token>.

Setiap perubahan isi nusa-global.yml atau nusa-world.yml wajib diikuti restart penuh (stop, lalu nyalakan kembali).

Struktur dasar nusa-world.yml

Secara bawaan, nusa-world.yml mengikuti seluruh pengaturan dari nusa-global.yml:

defaults:
  feature-flags: {}
worlds: {}

Contoh konfigurasi siap salin (nusa-global.yml)

Salin bagian yang sesuai dengan jenis server Anda ke dalam nusa-global.yml, lalu restart server.

1. Server Survival SMP Ramai + Cross-Play (Java & Bedrock)

Menjaga hasil farm tetap normal, membuat pemain HP Geyser/Floodgate bebas nyangkut, dan menahan lonjakan lag dari mob maupun item:

tuning-preset: DEFAULT
 
hopper-tick-spreading:
  groups: 4
  full-container-backoff-ticks: 8
 
entity-behavior:
  ticking-mode: OPTIMIZED
  skip-idle-goal-ticks: true
  brain-distance-scaling:
    enabled: true
    near-radius: 12.0
    max-interval: 20
  sensor-cadence:
    water-check-interval: 4
    equipment-sync-interval: 4
    line-of-sight-interval: 6
    dolphin-treasure-seek: false
 
tick-budgets:
  item-merge-scans-per-tick: 150
  vehicle-collision-stack-limit: 10
 
bedrock-optimization:
  enabled: true
  moved-wrongly-multiplier: 2.5
  max-chunks-per-tick: 2.0

2. Server Lobby / Auth Hub Kapasitas Tinggi

Mematikan beban simulasi survival yang tidak diperlukan di lobby serta menghemat pengiriman paket pemain jauh:

tuning-preset: HUB
 
hub-networking:
  near-distance: 8.0
  far-interval: 6
  waypoint-far-interval: 4
  tab-window-millis: 250
 
world-mechanics:
  advancement-criterion-triggers: false
  visual-effects:
    fall-impact-particles: false
    water-splash-particles: false

3. Server PvP / Practice / BoxPvP

Memastikan respons pukulan 1-tick tetap tajam, drop item kematian rapi di satu titik, anti one-shot Mace, serta mekanik kombo ala 1.8:

combat-priority-override:
  enabled: true
  window-ticks: 100
 
world-mechanics:
  compact-death-drops: true
  advancement-criterion-triggers: false
 
pvp-mechanics:
  allow-sprint-criticals: true
  fishing-hook-knockback: true
  ignore-netherite-kb-resistance: true
  mace:
    fall-distance-cap: 30.0

Ingin mengecek arti atau batas angka dari setiap key lainnya? Buka Tabel lengkap semua key.

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…