Anti-bot dan anti-exploit

Pahami setiap perlindungan NusaGate dengan bahasa sederhana, terapkan pengaturan yang disarankan, dan ketahui apa yang dilihat pemain saat diblokir.

Di halaman ini

Halaman ini menjelaskan cara NusaGate membedakan pemain asli dari bot, pengaturan apa yang perlu dicek sebelum network dibuka, dan apa yang dilihat pemain ketika sebuah pemeriksaan menghentikan mereka.

Cara lapisan perlindungan bekerja

Setiap koneksi baru melewati beberapa pemeriksaan sebelum sampai ke lobby. Kurang lebih urutannya seperti ini:

  1. Accept: koneksi dibuka. Batas laju per IP dan daftar blokir Anda berlaku di tahap ini.
  2. Handshake: client memberi tahu alamat dan versi yang dipakai. NusaGate mengecek domain, waktu, dan bentuk datanya.
  3. Pra-login: nama pemain dan laju login dicek, begitu juga riwayat percobaan gagal dari pemain tersebut.
  4. Verifikasi: client harus berperilaku seperti game asli, misalnya mengirim brand dan pengaturan client.

Setelah pemain masuk ke game, batas chat, paket, dan plugin message tetap melindungi server backend. Bot yang gagal di tahap awal tidak membebani server backend sama sekali.

Mode serangan

Pendeteksi serangan memantau tiga jenis banjir secara terpisah: bot (banyak login), ping (banyak ping daftar server), dan spam (spam chat dan koneksi). Ketika salah satunya melewati batas, NusaGate memasukkan jenis tersebut ke mode serangan untuk sementara waktu.

Selama mode serangan aktif, NusaGate bisa memakai kompresi lebih ringan agar CPU hemat, menampilkan MOTD khusus jika Anda mengaturnya, dan menjaga console tetap tenang dengan pesan ringkasan, bukan ribuan baris log. Beberapa pemeriksaan PRO, misalnya Reconnect Check, secara bawaan hanya aktif saat mode serangan, sehingga pemain biasa tidak terhambat di hari-hari normal.

Gunakan /ng attack untuk melihat status saat ini atau memaksa mode serangan menyala atau mati. Lihat Perintah dan permission.

Modul anti-bot

Semua modul ini ada di bawah anti-bot pada nusagate.yml. Modul Free aktif secara bawaan.

ModulEdisiPenjelasan sederhana
attack-detectorFreeMengenali banjir bot, ping, dan spam, lalu menyalakan dan mematikan mode serangan.
connection-login-speedFreeMembatasi jumlah ping, koneksi, dan login dari satu alamat IP dalam beberapa detik.
slow-bot-detectionFreeMenolak handshake yang terlalu lambat, memakai alamat atau nama tidak valid, atau tidak terlihat seperti client Minecraft. Nama Bedrock dengan awalan . tetap diizinkan.
timeout-checkFreeMenutup login yang tidak pernah selesai dan membatasi koneksi setengah jadi per IP.
network-exhaustion-preventionFreeMenghentikan koneksi yang mengirim data byte demi byte untuk membuat proxy sibuk.
chat-checkFreeMenghentikan spam chat serta banjir perintah /register dan /login.
dns-checkFreeMewajibkan pemain masuk lewat nama domain, bukan alamat IP mentah.
light-verificationFreeMemastikan client mengirim brand dan pengaturan client yang wajar, serta memblokir client bot yang sudah dikenal.
protocol-attribute-guardFreeMemungkinkan Anda memblokir versi game tertentu atau pola nama dan brand, serta mengecek kestabilan ping saat serangan.
motd-minifierFreeMenjaga MOTD dan ikon daftar server tetap kecil dan tersimpan di cache, dengan MOTD opsional saat serangan ping.
adaptive-escalationFreePelanggar berulang naik bertahap dari tantangan, ke jeda singkat, lalu ke blokir sementara yang makin lama setiap kali terulang.
bot-name-patternFreeMengenali nama yang terlihat acak dan gerombolan nama yang mirip.
dynamic-heavy-unloadFreeMelepas memori tambahan setelah serangan selesai.
fake-lobby-verificationPROSentinel Limbo: lobby virtual singkat yang mengecek balasan keep-alive, gerakan jatuh, dan tabrakan seperti client asli.
verified-player-cachePROMengingat pemain yang sudah terverifikasi agar tidak dicek berat lagi. Alamat IP baru berarti pemeriksaan baru.
interactive-captchaPROTantangan berupa kode, soal hitungan, atau angka yang ditulis dengan kata di chat. Mati secara bawaan.
reconnect-checkPROMeminta pemain baru untuk reconnect satu kali. Secara bawaan hanya saat serangan.
account-guardPROMembatasi jumlah akun yang online bersamaan, dan jumlah akun berbeda yang masuk, dari satu alamat IP.
nickname-guardPROMengunci nama staff ke alamat IP mereka dan menolak nama tiruan seperti 0wner.
attack-join-queuePROSaat serangan, memasukkan pemain baru secara bertahap. Pemain terverifikasi tidak perlu antre.
adaptive-dos-shieldPROMenyaring banjir koneksi sedini mungkin dan mati sendiri ketika trafik sudah tenang.

Modul anti-exploit

Modul berikut ada di bawah anti-exploit-security.

ModulEdisiPenjelasan sederhana
exploit-fixesFreeMenutup koneksi yang mengirim frame rusak atau menyalahgunakan paket login dan brand.
backend-payload-shieldFreeMemblokir plugin message yang terlalu besar atau berbahaya sebelum sampai ke backend.
static-blacklistFreeBlokir permanen untuk alamat IP, rentang CIDR, dan nama pemain.
packet-firewallPROBatas paket dan bandwidth per koneksi dan per IP, lebih ketat saat serangan.
anti-vpnPROMendeteksi koneksi VPN, proxy, dan hosting lewat penyedia yang Anda atur. Juga bisa memblokir ASN, nama ISP, dan negara.
proxy-blocklist-feedsPROMemblokir alamat dari daftar proxy publik. Mati secara bawaan.
passthrough-modePROMenyaring pemain baru sebelum autentikasi Mojang. Mati secara bawaan.
native-tcp-check, kernel-country-blockPROPemeriksaan khusus Linux lewat helper bridge terpisah. Otomatis dilewati di sistem lain.

Pengaturan yang disarankan

Nilai bawaan sudah disetel untuk server publik yang ramai: cukup ketat untuk menghentikan banjir bot, cukup longgar agar pemain asli tidak merasakannya. Mulailah dengan nilai bawaan, lalu cek poin-poin berikut:

  1. Atur domain Anda. Tambahkan ke anti-bot.dns-check.allowed-domains. Matikan block-direct-ip hanya selama Anda menguji lewat alamat IP.
  2. Koneksi bersama. Nilai bawaan mengizinkan beberapa pemain dari satu koneksi rumah atau sekolah. Jika banyak pemain Anda berbagi satu IP publik, misalnya di warnet, cek dulu batas per IP. Di PRO, biarkan distinct-accounts-mode milik Account Guard di ONLY_UNDER_ATTACK dan tambahkan alamat seperti itu ke exempt-ips.
  3. Anti-VPN butuh API key (PRO). Tanpa API key untuk minimal satu penyedia (ProxyCheck, IP-API, IPHub, atau IPQualityScore), modul ini tidak bisa memastikan VPN dan akan meloloskan semua pemain. Biaya dan kuota penyedia terpisah dari NusaGate.
  4. CAPTCHA bersifat opsional (PRO). Secara bawaan mati. Jika Anda menyalakannya, mode ONLY_UNDER_ATTACK membuatnya tidak mengganggu di hari-hari normal.
  5. Beri tahu pemain ke mana harus bertanya. Isi reliability-ux.localization.support-url dengan tautan Discord atau website Anda sendiri.
  6. Terapkan perubahan dengan /ng reload, lalu cek hasilnya dengan /ng stats.

Yang dilihat pemain saat diblokir

NusaGate tidak pernah memutus pemain tanpa penjelasan. Setiap kick diawali NusaGate », berisi alasan singkat, dan memberi tahu apa yang harus dilakukan. Pesan bawaannya berbahasa Inggris, contohnya:

ModulPesan bawaan
connection-login-speedYou are connecting too quickly. Please wait a few seconds and try again.
dns-checkPlease connect with the official server address instead of its IP address.
light-verificationClient verification failed. Please join with the official Minecraft client.
bot-name-patternYour username looks automated. Please join with a normal Minecraft account.
adaptive-escalationYou are on a short security cooldown. Please rejoin in a few seconds.
static-blacklistYour IP address or account is blocked on this server.

Setiap pesan bisa diganti lewat pengaturan kick-message milik modul tersebut, misalnya diterjemahkan ke bahasa Indonesia. Saat serangan berat, kick berulang ke alamat IP yang sama akan diberi tambahan "(please wait a few seconds)" di akhir pesan.

Untuk menampilkan pesan beberapa baris dalam bahasa pemain (Inggris atau Indonesia, sesuai bahasa game mereka) beserta tautan dukungan di bawahnya, nyalakan kartu pesan terlokalisasi:

reliability-ux:
  localization:
    use-localized-kick-cards: true
    support-url: "https://example.com/support"

Jika pemain asli ikut terblokir

  1. Minta pemain mengirim pesan persis yang muncul di layarnya. Pesan itu menunjukkan modul mana yang memblokir.
  2. Cek pengaturan modul tersebut di nusagate.yml, terutama batas per IP untuk pemain yang berbagi koneksi.
  3. Jika perlu, ubah enabled modul itu menjadi false, jalankan /ng reload, lalu minta pemain mencoba lagi. Jika berhasil masuk, penyebabnya sudah ketemu.
  4. Nyalakan kembali modul dengan nilai yang sudah disesuaikan, lalu laporkan kasusnya lewat Dukungan.

Langkah berikutnya

Dokumentasi produk Nusa · NusaGateEdisi Free & PRO

Memuat indeks…