NusaGate overview
Learn what NusaGate does, who it is for, how the Free and PRO editions differ, and which page to read first.
NusaGate is a Minecraft proxy that stands in front of your servers and stops bot floods and broken connections before they reach your lobby. This page explains what it does, whether it fits your network, and where to start.
What NusaGate is
NusaGate is built on official PaperMC Velocity. It is a complete Velocity proxy: you run it instead of a plain Velocity JAR, and it keeps velocity.toml, player forwarding and the Velocity plugin API. On top of that it adds:
- Multi-layer anti-bot: rate limits, handshake and client checks, bot-name detection, and stricter steps for connections that keep failing.
- Protocol exploit filtering: invalid or oversized game data is dropped at the proxy instead of reaching your backend servers.
- Bedrock optimisation: players joining through Geyser and Floodgate get faster paths through the proxy.
- Built-in ViaVersion: the official ViaVersion plugin is installed on first start and kept up to date.
- Honest kick messages: every kick tells the player what happened and what to do next.
A proxy is the server players connect to first. It sends each player on to one of your game servers (the backend servers), which makes it the natural place to filter bad traffic.
Who it is for
NusaGate is for server owners who run, or want to run, a network behind Velocity, for example a lobby plus survival or minigame servers. It is a good fit if you:
- see bot attacks or connection floods that fill your lobby or your console;
- want protection built into the proxy instead of several separate plugins;
- have Java and Bedrock players on the same network.
If you run a single server without a proxy, start with NusaSpigot instead. NusaGate also does not replace your host's DDoS protection: it filters connections inside the proxy, but it cannot rescue a network link that is already full.
Free and PRO at a glance
| NusaGate Free | NusaGate PRO (add-on) | |
|---|---|---|
| License key | Not needed | Included with your PRO download |
| Modules | 22 core modules | All 22 Free modules plus 20 PRO modules |
| Highlights | Anti-bot, exploit fixes, blacklist, MOTD protection, Bedrock paths, ViaVersion, admin commands | Sentinel Limbo, CAPTCHA, Anti-VPN, Account and Nickname Guard, Packet Firewall, Discord alerts, web dashboard |
Both editions read the same nusagate.yml, so you can start with Free and upgrade later without rewriting your configuration. The full list is on Free and PRO editions.
What to read next
- Install NusaGate: install Java, start the proxy and connect your backend servers.
- Commands and permissions: check protection status with
/ng statsand manage blocks. - Anti-bot and anti-exploit: understand each protection and what players see when they are blocked.