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 dibutuhkanKeterangan
Java 25 atau lebih baruJava dipasang terpisah, misalnya Eclipse Temurin.
Minimal satu server backendServer Paper (atau fork Paper seperti NusaSpigot) yang akan menjadi tujuan pemain.
Pengetahuan dasar VelocityNusaGate adalah proxy Velocity. Daftar server backend dan forwarding diatur di velocity.toml, sama seperti Velocity biasa.
User biasa di LinuxNusaGate menolak berjalan sebagai root. Gunakan user biasa, misalnya minecraft.
Hanya plugin VelocityPlugin 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

  1. Pasang Java 25 atau lebih baru, lalu cek di terminal:

    java -version
  2. Buat folder baru yang kosong untuk proxy, lalu taruh JAR NusaGate yang Anda unduh di dalamnya.

  3. 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
  4. 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.

  5. Ketik shutdown di 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
pause

File yang dibuat saat start pertama

File atau folderFungsinya
velocity.tomlPengaturan standar Velocity: alamat yang didengarkan, server backend, dan player forwarding.
nusagate.ymlSemua modul perlindungan NusaGate. File yang sudah ada tidak pernah ditimpa.
forwarding.secretKode rahasia yang dipakai Velocity untuk modern forwarding. Server backend butuh nilai yang sama.
plugins/ViaVersion.jarViaVersion 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"
]
  • bind adalah alamat dan port yang dihubungi pemain.
  • Setiap baris di bawah [servers] memberi nama pendek dan alamat untuk satu backend. try adalah 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:

  1. Atur online-mode=false di server.properties milik backend. Proses login sekarang ditangani proxy.

  2. Buka config/paper-global.yml di backend dan aktifkan dukungan Velocity dengan isi file forwarding.secret dari proxy:

    proxies:
      velocity:
        enabled: true
        online-mode: true
        secret: "tempel-isi-forwarding-secret-di-sini"
  3. 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

  1. Jalankan server backend, lalu jalankan NusaGate.

  2. Masuk ke network di Minecraft memakai domain Anda (atau localhost di komputer sendiri).

  3. Di console proxy, jalankan ng stats. Anda akan melihat mode perlindungan, trafik, dan jumlah ancaman yang diblokir.

  4. Jalankan ng edition untuk melihat edisi dan modul yang aktif.

  5. Agar bisa memakai perintah di dalam game, berikan permission nusagate.command.admin ke akun Anda, misalnya dengan LuckPerms untuk Velocity:

    lpv user NamaAnda permission set nusagate.command.admin true

Mengganti Velocity atau NusaGate versi lama

  1. Matikan proxy dan buat cadangan seluruh folder.
  2. Ganti JAR lama dengan JAR NusaGate yang baru, lalu sesuaikan perintah atau skrip start.
  3. 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

Dokumentasi produk Nusa · NusaGateEdisi Free & PRO

Memuat indeks…