Solusi masalah & FAQ
Jawaban cepat untuk error startup, aktivasi lisensi, TPS turun, pemain HP nyangkut, dan pertanyaan yang paling sering ditanyakan.
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
- Buka
nusa-license.propertiesdan pastikan kode lisensi tidak kelebihan spasi atau tanda kutip. Untuk memasukkan ulang, ubahrenew-license-input=truedinusacore.propertieslalu restart (lihat NusaCore & lisensi). - Pastikan hosting mengizinkan koneksi HTTPS keluar dan jam sistem (
NTP) tidak melenceng. - 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
- Pastikan
bedrock-optimization.enabled: truedinusa-global.yml. - Bila Geyser dipasang di proxy Velocity/BungeeCord tanpa memasang Floodgate di server backend, samakan
bedrock-optimization.username-prefixdengan awalan nama pemain HP Anda (default'.'), atau pasang Floodgate di backend agar deteksi UUID bekerja otomatis. - 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
- Cek
nusa statusuntuk melihat angka MSPT dan Heap. Jika Heap terus penuh di atas90%, naikkan-Xms/-Xmxatau turunkanview-distancedansimulation-distancediserver.properties. - 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. - Jalankan
nusa lagchunks start 30untuk 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.