Backup world

Jadwalkan backup semua world ke folder lokal dan penyimpanan S3 milik Anda, lalu pulihkan world dengan aman lewat /nusa backup.

Di halaman ini

NusaSpigot bisa membackup semua world secara terjadwal ke folder lokal, dan jika Anda mau, mengunggahnya ke penyimpanan S3-compatible milik Anda sendiri (AWS S3, Cloudflare R2, Backblaze B2, Wasabi, atau MinIO). Restore selalu dilakukan saat restart berikutnya, jadi world yang sedang berjalan tidak pernah disentuh.

Backup sekarang juga

Tanpa pengaturan apa pun, Anda bisa langsung membuat backup:

nusa backup now
nusa backup list

Arsip disimpan di folder nusa-backups/ dengan nama backup-YYYYMMDD-HHMMSS.zip (waktu UTC, jadi urutannya sesuai waktu pembuatan). nusa backup tanpa argumen menampilkan jadwal, tujuan, retensi, dan hasil backup terakhir.

Backup terjadwal

Backup terjadwal mati secara default. Nyalakan di bagian backup pada nusa-global.yml, lalu restart:

KeyContohArti
backup.enabledtrueMenyalakan backup terjadwal
backup.interval-minutes360Jarak antar backup dalam menit. 0 = hanya lewat /nusa backup now
backup.keep-local3Jumlah arsip lokal yang disimpan. Arsip lebih lama dihapus
backup.keep-remote14Jumlah arsip di S3 yang disimpan. 0 = tidak pernah menghapus

Upload ke penyimpanan S3

Isi bagian backup.s3 untuk mengunggah setiap arsip:

KeyContoh
backup.s3.endpointAlamat endpoint penyedia S3 Anda
backup.s3.regionauto (untuk R2) atau region bucket Anda
backup.s3.bucketmc-backups
backup.s3.prefixsurvival/

Kunci akses tidak boleh ditulis di nusa-global.yml, karena file itu ikut dibagikan ke Cloud Panel saat server terhubung. Gunakan salah satu cara ini:

  • Environment variable NUSA_BACKUP_S3_ACCESS_KEY dan NUSA_BACKUP_S3_SECRET_KEY, atau
  • File nusa-backup-credentials.properties di samping nusa-global.yml:
access-key=ISI_ACCESS_KEY
secret-key=ISI_SECRET_KEY

Beri kunci tersebut izin tulis, baca, list, dan hapus hanya untuk prefix backup Anda.

Restore world

Restore tidak pernah menyentuh world yang sedang berjalan:

  1. Lihat daftar arsip dengan nusa backup list.
  2. Jalankan nusa backup restore <id>. NusaSpigot menjelaskan apa yang akan terjadi.
  3. Konfirmasi dengan menambahkan confirm di akhir perintah yang sama. Arsip diunduh jika belum ada di lokal, diperiksa keutuhannya, lalu disiapkan untuk restore.
  4. Restart server. Sebelum world mana pun dibuka, folder world yang lama dipindahkan ke nusa-backups/pre-restore-<waktu>/, lalu isi arsip diekstrak di tempatnya.

Ingin membatalkan? Jalankan nusa backup restore cancel sebelum restart.

Saat backup berjalan

Autosave setiap world dijeda sebentar, semua data disimpan, lalu arsip ditulis di thread terpisah. Autosave kembali normal segera setelah arsip selesai, atau paling lambat setelah 30 menit (dan backup dibatalkan). Izin yang dibutuhkan: nusaspigot.command.backup (default OP).

Langkah berikutnya

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…