Plugin, proxy & safemode
Panduan memasang plugin Paper/Spigot, menghubungkan proxy Velocity/BungeeCord, dan melacak sumber lag dengan /nusa doctor.
Di halaman ini
NusaSpigot menjaga 100% kompatibilitas API Bukkit, Spigot, dan Paper 1.21.11. Plugin populer seperti LuckPerms, Vault, WorldEdit, WorldGuard, EssentialsX, Citizens, MythicMobs, TAB, ViaVersion, Geyser, dan Floodgate dapat langsung dipasang tanpa ubahan khusus.
Tiga aturan aman memasang plugin
- Pastikan versi plugin mendukung Minecraft 1.21.x / Paper. Khusus plugin yang membaca paket internal NMS (seperti ProtocolLib, PacketEvents, atau Citizens), gunakan rilis terbaru yang mendukung Minecraft 1.21.11.
- Jangan pernah menjalankan
/reload. Perintah/reloadrawan membuat memori bocor dan merusak listener plugin. Selalu gunakanstoplalu nyalakan ulang server setiap habis menambah atau memperbarui plugin. - Satu main thread asli: NusaSpigot tidak pernah memalsukan
Bukkit.isPrimaryThread()pada background worker, sehingga semua event Bukkit tetap aman seperti di Paper.
Menghubungkan ke proxy Velocity atau BungeeCord
Jika server NusaSpigot berada di belakang jaringan proxy (misalnya gabungan Lobby + Survival + Minigame):
- Ubah
online-mode=falsediserver.propertiespada server backend NusaSpigot (karena autentikasi akun dilakukan di proxy). - Rekomendasi utama (Velocity): Aktifkan
proxies.velocity.enabled: true,proxies.velocity.online-mode: true, dan samakan isiforwarding.secretdi dalam fileconfig/paper-global.yml. - BungeeCord: Aktifkan
settings.bungeecord: truepadaspigot.ymldan tutup akses langsung ke port backend menggunakan firewall agar tidak bisa ditembus dari luar proxy. - Geyser & Floodgate di jaringan proxy: Pasang Floodgate di proxy sekaligus di backend (dengan file
key.pemyang sama) agar NusaSpigot otomatis mengenali UUID pemain HP untuk fitur Optimasi pemain Bedrock.
Cara cepat melacak plugin penyebab lag
Jika TPS tiba-tiba turun atau ada fitur plugin yang berjalan aneh, jangan menebak-nebak—lakukan dua langkah praktis ini:
Langkah 1: Jalankan /nusa doctor
nusa doctornusa doctor memeriksa argumen startup Java, status modul NusaSpigot, dan daftar plugin aktif. Contohnya, bila ada plugin yang memantau seluruh pemindahan item hopper secara global (InventoryMoveItemEvent), NusaSpigot otomatis menyesuaikan polling hopper agar plugin tersebut tetap akurat.
Langkah 2: Uji langsung dengan /nusa safemode
nusa safemode on
nusa safemode status
nusa safemode off/nusa safemode onlangsung melewati optimasi dan guard NusaSpigot saat itu juga tanpa perlu restart.- Bila lag masih tetap ada saat safemode menyala, jalankan profiler bawaan Paper (
/spark profiler startatau/spark health) untuk melihat nama plugin atau kerumunan entity yang memakan waktu main thread paling besar. - Setelah selesai menguji, kembalikan dengan
/nusa safemode off(status safemode juga otomatis kembali normal saat server restart).