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.ymltetapi tidak punyavelocity-plugin.json) tidak bisa dimuat langsung. Anda membutuhkan versi Velocity-nya atau alternatif untuk Velocity.
| Plugin BungeeCord lama | Gunakan ini di NusaGate |
|---|---|
| BungeeGuard | Modern forwarding bawaan Velocity: player-info-forwarding-mode = "modern" di velocity.toml. |
| AuthMeBungee | AuthMeVelocity atau LimboAuth. |
| BungeeTabListPlus | TAB 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 sendiri | Port 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 (
ipsetdaniptables); - 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
- Dukungan jika masalah Anda tidak tercantum di sini.
- Anti-bot dan anti-exploit untuk menyesuaikan batas dengan aman.
- Instalasi NusaGate untuk pengaturan forwarding dan backend.