NusaGate overview

Learn what NusaGate does, who it is for, how the Free and PRO editions differ, and which page to read first.

On this page

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 FreeNusaGate PRO (add-on)
License keyNot neededIncluded with your PRO download
Modules22 core modulesAll 22 Free modules plus 20 PRO modules
HighlightsAnti-bot, exploit fixes, blacklist, MOTD protection, Bedrock paths, ViaVersion, admin commandsSentinel 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.

  1. Install NusaGate: install Java, start the proxy and connect your backend servers.
  2. Commands and permissions: check protection status with /ng stats and manage blocks.
  3. Anti-bot and anti-exploit: understand each protection and what players see when they are blocked.
Nusa product documentation · NusaGateFree & PRO editions

Loading the index…