Migrasi dari Paper atau fork lain

Siapkan staging

Staging adalah salinan server untuk pengujian pribadi. Gunakan folder terpisah, port berbeda, dan akses terbatas. Jangan biarkan salinan plugin mengirim notifikasi produksi atau menulis ke database produksi yang sama tanpa rencana yang jelas.

1. Catat versi Minecraft, Java, Paper/fork, dan semua plugin beserta dependensinya.
2. Jalankan stop pada server asal. Tunggu seluruh proses berhenti.
3. Buat backup lengkap dan simpan JAR lama. Jangan bekerja pada satu-satunya salinan world.
4. Salin folder server yang diperlukan ke staging. Ubah port dan sambungan layanan plugin pada salinan.
5. Pilih distribusi NusaSpigot yang cocok. Jangan menggabungkan upgrade versi Minecraft dengan migrasi fork tanpa menguji kedua perubahan.

Apa yang dipertahankan

Salin world utama beserta world dimensi/world tambahan sesuai susunan server, folder plugins/ beserta datanya, server.properties, config Paper/Bukkit/Spigot, whitelist, operator, permission, dan daftar ban. Plugin berbasis database memerlukan backup database yang konsisten, bukan hanya folder plugin.

File nusa-global.yml dan nusa-world.yml dibuat jika belum ada. Untuk migrasi pertama, pertimbangkan zstd dan rollback sebelum world disimpan oleh Nusa. Jika ingin mempertahankan format writer Paper, buat potongan konfigurasi berikut di staging sebelum startup:

feature-flags:
  region-file-compression: false

Default lain tetap berlaku. Ini tidak mengonversi chunk yang sudah terlanjur ditulis sebagai zstd.

Uji sebelum mengganti produksi

Jalankan server, baca nusa doctor, dan uji login, izin, inventory, teleport, klaim, ekonomi, serta tindakan penting plugin. Periksa world/dimensi, simpan, hentikan, dan buka kembali. Pastikan perilaku mob, hopper, tracking, serta item khusus sesuai kebutuhan.

Dari Spigot atau fork lain, tata letak world, perilaku plugin, dan pengaturan khusus dapat berbeda. Ikuti prosedur migrasi asal ke Paper yang relevan, lalu uji Nusa secara terpisah. API yang dipertahankan tidak menjamin plugin NMS/reflection setiap versi.

Jika gagal, hentikan staging dan pulihkan salinan backup. Setelah uji lulus, jadwalkan downtime dan ulangi proses pada backup terbaru. Ikuti prosedur update untuk pergantian JAR produksi.