Instalasi NusaGate
Pasang Java, jalankan NusaGate untuk pertama kali, hubungkan server backend, dan pastikan perlindungan sudah aktif.
Di halaman ini
Panduan ini membawa Anda dari folder kosong sampai proxy NusaGate berjalan dan meneruskan pemain ke server backend. Di akhir panduan, Anda akan memastikan perlindungan aktif hanya dengan satu perintah.
Sebelum mulai
| Yang dibutuhkan | Keterangan |
|---|---|
| Java 25 atau lebih baru | Java dipasang terpisah, misalnya Eclipse Temurin. |
| Minimal satu server backend | Server Paper (atau fork Paper seperti NusaSpigot) yang akan menjadi tujuan pemain. |
| Pengetahuan dasar Velocity | NusaGate adalah proxy Velocity. Daftar server backend dan forwarding diatur di velocity.toml, sama seperti Velocity biasa. |
| User biasa di Linux | NusaGate menolak berjalan sebagai root. Gunakan user biasa, misalnya minecraft. |
| Hanya plugin Velocity | Plugin yang dibuat khusus untuk BungeeCord atau Waterfall tidak bisa dimuat. |
Pemain Bedrock juga membutuhkan Geyser dan Floodgate edisi Velocity, yang dipasang terpisah di folder plugins milik proxy.
Memasang dan menjalankan proxy
-
Pasang Java 25 atau lebih baru, lalu cek di terminal:
java -version -
Buat folder baru yang kosong untuk proxy, lalu taruh JAR NusaGate yang Anda unduh di dalamnya.
-
Jalankan proxy dari folder tersebut. Sesuaikan nama file dengan JAR Anda dan atur nilai memori sesuai hosting:
java -Xms512M -Xmx1G -jar NusaGate-Free-2.0.0+vel4.3.1.jar -
Tunggu sampai console selesai memuat. NusaGate Free tidak menampilkan permintaan lisensi, tidak butuh akun, dan tidak terhubung ke server lisensi. Untuk NusaGate PRO, lihat Edisi Free dan PRO untuk lokasi file lisensi.
-
Ketik
shutdowndi console untuk mematikan proxy sebelum Anda mengubah konfigurasi.
Di Windows, Anda bisa menyimpan perintah start di file start.bat di sebelah JAR lalu klik dua kali:
@echo off
java -Xms512M -Xmx1G -jar NusaGate-Free-2.0.0+vel4.3.1.jar
pauseFile yang dibuat saat start pertama
| File atau folder | Fungsinya |
|---|---|
velocity.toml | Pengaturan standar Velocity: alamat yang didengarkan, server backend, dan player forwarding. |
nusagate.yml | Semua modul perlindungan NusaGate. File yang sudah ada tidak pernah ditimpa. |
forwarding.secret | Kode rahasia yang dipakai Velocity untuk modern forwarding. Server backend butuh nilai yang sama. |
plugins/ViaVersion.jar | ViaVersion bawaan, dipasang saat start pertama kecuali Anda mematikannya. |
plugins/.nusagate-bundled/ | Data pembaruan dan cadangan untuk ViaVersion bawaan. |
logs/ | Log console, termasuk laporan yang dibuat oleh /ng bugreport. |
Menghubungkan server backend
Langkah ini memakai pengaturan Velocity biasa. Buka velocity.toml dan atur setidaknya nilai berikut:
bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"
[servers]
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
try = [
"lobby"
]bindadalah alamat dan port yang dihubungi pemain.- Setiap baris di bawah
[servers]memberi nama pendek dan alamat untuk satu backend.tryadalah daftar server tujuan pertama pemain. player-info-forwarding-mode = "modern"meneruskan IP asli dan UUID pemain ke backend secara aman.
Lalu siapkan setiap backend berbasis Paper:
-
Atur
online-mode=falsediserver.propertiesmilik backend. Proses login sekarang ditangani proxy. -
Buka
config/paper-global.ymldi backend dan aktifkan dukungan Velocity dengan isi fileforwarding.secretdari proxy:proxies: velocity: enabled: true online-mode: true secret: "tempel-isi-forwarding-secret-di-sini" -
Restart backend. Pastikan pemain tidak bisa mengakses port backend secara langsung, hanya lewat proxy.
Panduan kompatibilitas server Velocity resmi membahas jenis server lain dan opsi tambahan.
Mengatur domain server
Secara bawaan, NusaGate menolak pemain yang masuk memakai alamat IP mentah, bukan domain Anda. Cara ini menghentikan banyak bot, karena bot biasanya masuk lewat IP. Buka nusagate.yml dan tambahkan domain Anda:
anti-bot:
dns-check:
block-direct-ip: true
allowed-domains:
- "play.example.com"Jika allowed-domains kosong, domain apa pun diterima dan hanya alamat IP mentah yang ditolak. Masuk lewat localhost tetap bisa untuk uji coba lokal.
Memastikan semuanya berjalan
-
Jalankan server backend, lalu jalankan NusaGate.
-
Masuk ke network di Minecraft memakai domain Anda (atau
localhostdi komputer sendiri). -
Di console proxy, jalankan
ng stats. Anda akan melihat mode perlindungan, trafik, dan jumlah ancaman yang diblokir. -
Jalankan
ng editionuntuk melihat edisi dan modul yang aktif. -
Agar bisa memakai perintah di dalam game, berikan permission
nusagate.command.adminke akun Anda, misalnya dengan LuckPerms untuk Velocity:lpv user NamaAnda permission set nusagate.command.admin true
Mengganti Velocity atau NusaGate versi lama
- Matikan proxy dan buat cadangan seluruh folder.
- Ganti JAR lama dengan JAR NusaGate yang baru, lalu sesuaikan perintah atau skrip start.
- Jalankan kembali proxy.
velocity.toml, plugin, dan nusagate.yml yang sudah ada tetap dipertahankan. Bagian khusus PRO di nusagate.yml lama akan diabaikan oleh JAR Free.
Langkah berikutnya
- Perintah dan permission: semua yang bisa Anda lakukan dengan
/ng. - Anti-bot dan anti-exploit: pengaturan yang disarankan sebelum server dibuka untuk umum.
- Edisi Free dan PRO: fitur tambahan PRO dan cara upgrade.