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

  1. 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.
  2. Jangan pernah menjalankan /reload. Perintah /reload rawan membuat memori bocor dan merusak listener plugin. Selalu gunakan stop lalu nyalakan ulang server setiap habis menambah atau memperbarui plugin.
  3. 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):

  1. Ubah online-mode=false di server.properties pada server backend NusaSpigot (karena autentikasi akun dilakukan di proxy).
  2. Rekomendasi utama (Velocity): Aktifkan proxies.velocity.enabled: true, proxies.velocity.online-mode: true, dan samakan isi forwarding.secret di dalam file config/paper-global.yml.
  3. BungeeCord: Aktifkan settings.bungeecord: true pada spigot.yml dan tutup akses langsung ke port backend menggunakan firewall agar tidak bisa ditembus dari luar proxy.
  4. Geyser & Floodgate di jaringan proxy: Pasang Floodgate di proxy sekaligus di backend (dengan file key.pem yang 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 doctor

nusa 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 on langsung 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 start atau /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).
Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…