Masalah yang diketahui dan batasan

Cek kompatibilitas plugin dan batasan NusaGate yang sudah diketahui sebelum memasang atau melaporkan masalah.

Di halaman ini

Baca halaman ini sebelum memindahkan network ke NusaGate atau melaporkan masalah. Di sini tercantum apa yang berjalan, apa yang tidak, dan pengaturan yang paling sering membuat pemilik server baru kaget.

Kompatibilitas plugin

NusaGate dibangun di atas Velocity resmi dari PaperMC dan memakai API plugin Velocity yang biasa.

  • Plugin Velocity berjalan. Plugin Velocity populer seperti LuckPerms, ViaVersion, Geyser, Floodgate, LimboAPI, TAB, LiteBans, dan LibertyBans didukung.
  • Plugin khusus BungeeCord tidak bisa dimuat. Plugin yang hanya dibuat untuk BungeeCord atau Waterfall (punya bungee.yml tetapi tidak punya velocity-plugin.json) tidak bisa dimuat langsung. Anda membutuhkan versi Velocity-nya atau alternatif untuk Velocity.
Plugin BungeeCord lamaGunakan ini di NusaGate
BungeeGuardModern forwarding bawaan Velocity: player-info-forwarding-mode = "modern" di velocity.toml.
AuthMeBungeeAuthMeVelocity atau LimboAuth.
BungeeTabListPlusTAB edisi Universal atau Velocity.
ServerListPlus (build khusus BungeeCord)Build ServerListPlus yang mendukung Velocity, atau MiniMOTD untuk Velocity.
AdvancedBan (build BungeeCord lama)LibertyBans atau LiteBans untuk Velocity.
Plugin BungeeCord buatan sendiriPort plugin ke API Velocity.

Fitur khusus Linux

Beberapa modul PRO bekerja di level sistem operasi: pemeriksaan TCP native, blokir negara di level firewall, dan helper bridge yang mengelolanya. Modul ini membutuhkan:

  • host Linux dengan tool firewall yang diperlukan (ipset dan iptables);
  • helper bridge terpisah yang punya hak akses khusus, berjalan di samping proxy.

Di Windows, macOS, atau container standar tanpa hak admin jaringan (misalnya panel Pterodactyl pada umumnya), modul ini otomatis dilewati. Semua perlindungan lain tetap berjalan seperti biasa.

Jangan jalankan proxy sebagai root

Di Linux, NusaGate menolak start jika proxy dijalankan sebagai root. Jalankan dengan user biasa seperti minecraft atau nusagate. Jika Anda memakai helper bridge Linux, berikan hak jaringan tambahan hanya ke helper terpisah tersebut, jangan pernah ke proxy-nya.

Masuk dengan alamat IP ditolak

Secara bawaan, anti-bot.dns-check.block-direct-ip bernilai true. Pemain yang masuk memakai alamat IP mentah, bukan domain Anda, akan ditolak dengan pesan yang meminta mereka memakai alamat resmi. Masuk lewat localhost tetap bisa untuk uji coba lokal.

Jika Anda menguji server staging lewat alamat IP, ubah menjadi block-direct-ip: false lalu jalankan /ng reload. Aktifkan lagi sebelum server dibuka untuk umum.

Banyak pemain dari satu alamat IP

Sekolah, warnet, dan sebagian jaringan seluler menempatkan banyak pemain di balik satu IP publik. Nilai bawaan mengizinkan beberapa pemain per IP, tetapi koneksi bersama yang sangat ramai bisa terkena batas per IP. Cek batas per IP di bagian anti-bot, dan di PRO tambahkan alamat tersebut ke exempt-ips milik Account Guard. Packet Firewall PRO melewati batas per IP-nya jika proxy berada di belakang frontend PROXY protocol.

Anti-VPN tanpa API key (PRO)

Tanpa API key untuk minimal satu penyedia, modul Anti-VPN tidak bisa memastikan VPN dan akan meloloskan semua pemain. Country Guard memakai penyedia yang sama, jadi juga membutuhkan minimal satu penyedia yang sudah diatur. Biaya dan kuota penyedia terpisah dari NusaGate.

Pemain Bedrock

Pemain Bedrock membutuhkan Geyser dan Floodgate edisi Velocity yang dipasang di proxy. NusaGate akan mengenalinya dan memakai jalur cepat Bedrock.

Add-on ViaVersion

ViaVersion bawaan memungkinkan client yang lebih baru masuk ke server versi lama yang didukung. ViaBackwards dan ViaRewind adalah add-on terpisah dan tidak dipasang otomatis. Lihat ViaVersion bawaan.

Perlindungan DDoS

NusaGate menyaring koneksi di dalam proxy. NusaGate tidak bisa memulihkan jalur jaringan yang sudah penuh. Tetap gunakan perlindungan DDoS dari hosting dan firewall di depan server backend Anda.

Langkah berikutnya

Dokumentasi produk Nusa · NusaGateEdisi Free & PRO

Memuat indeks…