Migrasi dari Paper & update

Pindahkan server Paper ke NusaSpigot, perbarui ke rilis terbaru, dan ketahui apa yang perlu dicek sebelum kembali ke Paper.

Di halaman ini

NusaSpigot adalah fork Paper yang tinggal pasang, jadi folder world, server.properties, paper-global.yml, spigot.yml, dan folder plugins/ Anda tetap dipakai apa adanya. Halaman ini menunjukkan urutan langkah yang aman.

Pindah dari Paper ke NusaSpigot

  1. Matikan server dengan benar memakai perintah stop, lalu tunggu sampai prosesnya benar-benar berhenti.
  2. Buat backup penuh seluruh folder server (world, plugins/, dan file konfigurasi), lalu simpan salinannya di luar folder server.
  3. Salin NusaCore.jar dan nusa-license.properties dari file download ke folder server.
  4. Arahkan script start atau panel ke NusaCore.jar, bukan lagi JAR Paper. Perintah start ada di Instalasi & langkah cepat.
  5. Nyalakan server. Pilih versi Minecraft saat NusaCore bertanya. NusaSpigot membuat nusa-global.yml dan nusa-world.yml dengan nilai default yang aman di samping konfigurasi Paper Anda.
  6. Cek kesehatan server dengan nusa status dan nusa doctor di console.

Gunakan versi Minecraft yang sama dengan server Paper lama Anda (misalnya 1.21.11). Naik ke versi Minecraft yang lebih baru adalah langkah terpisah; coba dulu di salinan server.

Update NusaSpigot

Jika Anda sudah memakai NusaCore, update hanya satu langkah:

  1. Restart server.
  2. NusaCore otomatis mengunduh dan memverifikasi rilis terbaru untuk versi Minecraft Anda.

Nilai konfigurasi lama tetap dipakai. Pengaturan baru yang belum ada di file Anda otomatis memakai default yang aman. Kadang catatan rilis juga menyarankan mengganti NusaCore.jar dengan versi terbaru dari halaman download; lakukan saat server mati.

Dari build lama yang dijalankan langsung

Jika Anda masih menjalankan build NusaSpigot lama langsung sebagai JAR server (misalnya NusaSpigot-v1.2-1.21.11.jar), beralihlah ke NusaCore:

  1. Matikan server dan buat backup.
  2. Taruh NusaCore.jar dan nusa-license.properties dari download terbaru ke folder server.
  3. Ubah perintah start menjadi java -jar NusaCore.jar --nogui. Flag memori tetap dipakai.
  4. Nyalakan server dan pilih versi Minecraft saat diminta.

World, plugin, dan nusa-global.yml Anda tidak berubah.

Memindahkan lisensi ke Minecraft 26.2

Lisensi dikunci ke satu versi Minecraft saat pertama dipakai. Untuk memindahkan lisensi yang sudah ada ke 26.2, buka tiket support. Ingat: 26.2 membutuhkan Java 25, dan plugin yang memakai internal server (NMS) dengan mapping Spigot perlu versi khusus 26.2 dari pembuatnya. Lihat Kompatibilitas plugin.

Penting: kompresi region dan kembali ke Paper

feature-flags.region-file-compression bernilai true secara default. Artinya:

  • Chunk Paper yang sudah ada tetap terbaca normal. Tidak ada konversi massal saat startup.
  • Chunk yang baru disimpan memakai kompresi Zstandard (Zstd). Paper biasa atau vanilla tidak bisa membaca chunk tersebut secara langsung.
  • Masih tahap mencoba? Jika Anda mungkin kembali ke Paper tanpa memulihkan backup, matikan opsi ini sebelum pemain masuk:
feature-flags:
  region-file-compression: false

Simpan backup Paper sebelum migrasi sampai Anda yakin dengan perpindahannya.

Langkah berikutnya

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…