Mendiagnosis konflik plugin
Reproduksi pada staging, periksa dependensi, dan pertahankan aturan thread server.
Plugin gagal enable
Baca error awal yang menyebabkan plugin berhenti, bukan hanya error lanjutan. Periksa versi Minecraft/Java, dependensi wajib, JAR duplikat, izin file, dan migrasi data plugin. Jalankan nusa doctor dan cocokkan advisory dengan dokumentasi build plugin.
Jangan memperbaiki dengan menghapus folder plugin produksi tanpa backup. Database dan file data bisa membutuhkan versi yang cocok untuk rollback.
Isolasi bertahap
- Buat staging dari backup dan nonaktifkan koneksi/notifikasi produksi pada salinan.
- Reproduksi dengan langkah paling kecil yang masih memicu masalah.
- Coba plugin beserta dependensi wajib saja, lalu tambah plugin lain secara bertahap. Pada banyak plugin, pembagian kelompok membantu menemukan kombinasi.
- Pertahankan config dan workload agar perbandingan bermakna. Restart penuh tiap perubahan.
- Uji flag Nusa yang relevan satu per satu jika profil/gejala menunjukkannya. Catat hasil OFF dan ON.
Plugin yang bergantung reflection/NMS atau adapter server mungkin perlu update tepat, walau API publik dipertahankan. Peringatan doctor sendiri tidak membuktikan plugin rusak.
AsyncCatcher dan CME
AsyncCatcher atau error ownership dapat berarti state server diakses dari thread yang salah. ConcurrentModificationException dapat menunjukkan perubahan koleksi yang tidak aman atau bug lain; stack trace perlu diperiksa dengan konteks.
Jangan menonaktifkan AsyncCatcher, memalsukan primary thread, atau memindahkan World/Entity/Player mutation ke worker. Gunakan scheduler main thread yang didukung plugin/API. Kirim reproduksi dan bagian stack trace relevan yang disensor kepada pembuat plugin atau support.
Kapan memakai safemode
Untuk pemulihan darurat, baca safemode seluruhnya. Mode ini melewati optimasi dan guard Nusa serta mempertahankan beberapa resource startup sampai shutdown. Hasil yang berubah dalam safemode membantu mempersempit penyebab, tetapi tidak langsung menunjuk satu modul atau membuktikan kesalahan plugin.
Jika ada penolakan input sah, gunakan diagnosis false positive dan siapkan paket support.