Mengedit konfigurasi

Dua file Nusa

nusa-global.yml dan nusa-world.yml berada di working directory server, biasanya di samping JAR dan server.properties. Jika service membuatnya di tempat tak terduga, periksa working directory script/panel.

Semua modul yang didokumentasikan saat ini membaca pengaturan global. nusa-world.yml menyediakan struktur cadangan defaults.feature-flags: {} dan worlds: {}; jangan menganggap menambahkan key world telah mengaktifkan override per world. Struktur YAML-nya tetap diperiksa saat startup.

Ubah satu hal setiap kali

1. Catat keadaan awal dan backup file terkait.
2. Hentikan server dengan stop sebelum mengedit manual.
3. Cari key melalui indeks. Periksa tipe, rentang, dependensi, dan efek permainan.
4. Edit dengan text editor yang mempertahankan UTF-8. Gunakan spasi untuk indentasi, bukan tab.
5. Jalankan kembali dan periksa error startup, nusa doctor, serta perilaku yang diubah.

Restart penuh diperlukan untuk semua opsi Nusa pada referensi ini. /reload atau reload plugin tidak mengganti pool, codec, listener, maupun pengaturan startup yang hidup.

Aturan YAML yang sering terlewat

feature-flags:
  ai-precompute-queue: true
ai-precompute-queue:
  threads: 0
  exclude-mob-types: [minecraft:villager]

true adalah boolean; 'true' adalah string dan dapat ditolak. threads: 0 memilih ukuran otomatis, bukan mematikan fitur. Tulis sebuah parent seperti feature-flags satu kali; gabungkan isinya saat menyalin potongan. Hindari key duplikat.

Default dan file lama

Startup membuat file bawaan hanya jika belum ada. File yang sudah ada tidak ditulis ulang untuk menyisipkan key baru. Key yang hilang memakai default implementasi: flag optimasi/guard umumnya true, Discord dan AI eksternal false. Nilai dikenal yang invalid menggagalkan startup.

Untuk membatalkan, hentikan server, pulihkan config backup, dan jalankan lagi. Jika Anda sudah menyimpan world dengan zstd, pemulihan config tidak mengubah format chunk tersebut. Baca rollback world.