Solusi masalah & FAQ

Jawaban cepat untuk error startup, aktivasi lisensi, TPS turun, pemain HP nyangkut, dan pertanyaan yang paling sering ditanyakan.

Di halaman ini

Sebagian besar kendala operasional dapat diselesaikan dalam hitungan menit lewat panduan singkat di bawah ini.

Solusi cepat masalah umum

Server gagal menyala dengan pesan UnsupportedClassVersionError

Mesin atau kontainer Pterodactyl Anda memakai Java yang terlalu lama. Minecraft 1.21.11 membutuhkan Java 21 atau lebih baru, dan Minecraft 26.2 membutuhkan Java 25 atau lebih baru. Ganti Docker Image di panel, atau pastikan java -version menunjukkan versi yang benar.

Muncul IllegalArgumentException dari NusaConfigurations saat startup

Ada nilai di dalam nusa-global.yml yang salah ketik tipe datanya atau berada di luar rentang yang diizinkan (contohnya mengisi huruf pada kolom angka, atau mengisi resume-tps lebih kecil dari minimum-tps). Lihat nama key yang disebutkan pada pesan error, lalu samakan batas angkanya di Tabel lengkap semua key.

Validasi lisensi gagal saat dinyalakan

  1. Buka nusa-license.properties dan pastikan kode lisensi tidak kelebihan spasi atau tanda kutip. Untuk memasukkan ulang, ubah renew-license-input=true di nusacore.properties lalu restart (lihat NusaCore & lisensi).
  2. Pastikan hosting mengizinkan koneksi HTTPS keluar dan jam sistem (NTP) tidak melenceng.
  3. Baca pesan di console. Jika tertulis lisensi ditolak atau versi tidak termasuk lisensi, buka tiket support daripada mencoba terus.

Server meminta dijalankan lewat NusaCore

Build berlisensi hanya bisa dijalankan melalui NusaCore. Ubah perintah start atau Startup JAR di panel menjadi NusaCore.jar (lihat Instalasi & langkah cepat).

Saya salah memilih versi Minecraft

Pilihan versi dikunci ke lisensi, jadi tidak bisa diubah sendiri. Buka tiket support, kami akan membuka pilihannya lagi. NusaCore akan bertanya ulang pada start berikutnya.

Pemain HP (Geyser/Bedrock) masih suka ketarik balik di blok

  1. Pastikan bedrock-optimization.enabled: true di nusa-global.yml.
  2. Bila Geyser dipasang di proxy Velocity/BungeeCord tanpa memasang Floodgate di server backend, samakan bedrock-optimization.username-prefix dengan awalan nama pemain HP Anda (default '.'), atau pasang Floodgate di backend agar deteksi UUID bekerja otomatis.
  3. Periksa apakah pemain ditarik balik oleh plugin anti-cheat pihak ketiga (seperti Grim, Vulcan, atau Matrix).

TPS turun saat banyak pemain menjelajah map atau berada di farm

  1. Cek nusa status untuk melihat angka MSPT dan Heap. Jika Heap terus penuh di atas 90%, naikkan -Xms / -Xmx atau turunkan view-distance dan simulation-distance di server.properties.
  2. Lakukan pre-generasi world dengan nusa pregen 128 world (radius dalam chunk) agar pemain yang menjelajah tidak memaksa server membuat terrain baru. Lihat Pre-generasi world.
  3. Jalankan nusa lagchunks start 30 untuk melihat chunk dan plugin yang paling membebani tick. Lihat Diagnosis lag & auto-tune.

Pertanyaan yang Sering Diajukan (FAQ)

Apakah semua plugin Paper dan Spigot bisa dipakai di NusaSpigot?

Ya. NusaSpigot mempertahankan seluruh signature API Paper, Spigot, dan Bukkit 1.21.11 serta tetap menggunakan satu main thread asli, sehingga plugin standar berjalan normal tanpa modifikasi.

Kenapa di versi lama TPS saat sepi di Windows kadang tertulis 19.x?

Secara bawaan, sistem operasi Windows melonggarkan resolusi timer tidur menjadi ~15,6 ms ketika beban rendah. Sejak NusaSpigot v1.2, kalibrasi timer presisi tinggi sudah berjalan otomatis sehingga server idle tetap terkunci stabil di 20.00 TPS baik di Windows maupun Linux.

Bagaimana cara update NusaSpigot?

Restart server. NusaCore otomatis mengunduh rilis terbaru untuk versi Minecraft Anda. Daftar perubahannya ada di Catatan rilis.

Apakah harus membuka port baru di hosting untuk memakai Cloud Panel?

Tidak perlu. Perintah /nusa link menggunakan koneksi HTTPS keluar (outbound) dari server ke cloud, sehingga langsung berjalan di panel Pterodactyl biasa maupun jaringan rumah tanpa buka port tambahan.

Kenapa setelah mengedit nusa-global.yml harus restart penuh?

Pool thread worker, pipeline jaringan Netty, dan kompresi file chunk diinisialisasi saat startup agar tidak pernah bentrok dengan data world yang sedang dimainkan. Melakukan stop lalu start ulang menjamin perubahan teraplikasi secara bersih dan aman.

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…