Free and PRO editions

Compare NusaGate Free and NusaGate PRO, decide which one you need, and upgrade to PRO step by step.

On this page

NusaGate comes in two editions that share one configuration file. This page shows what each edition includes, helps you choose, and walks you through the upgrade to PRO.

Two editions, one config file

  • NusaGate Free is a free JAR. It needs no license key, no account and makes no license or account connections.
  • NusaGate PRO is a paid add-on. It contains every Free module plus 20 PRO modules, and your download already includes your license file.

Both editions read the same nusagate.yml. The Free JAR ignores PRO sections, and the PRO JAR uses safe defaults for sections that are missing. You can start with Free and upgrade without rewriting anything. Run /ng edition at any time to see which edition you are running and which modules are unlocked.

What Free includes

AreaModules
Anti-botAttack detector for bot, ping and spam floods; connection, ping and login rate limits; slow-bot and fake-client handshake checks; timeout and half-open handshake guard; slow-drip guard; domain check; light client verification; bot username patterns; protocol attribute guard; chat and /login /register flood guard; adaptive escalation with temporary blocks; attack-aware MOTD and favicon cache
SecurityProtocol exploit fixes, backend plugin-message shield, static IP, CIDR and username blacklist
PerformanceCompression floor, packet batching and Bedrock fast paths; memory leak guard
Players and consoleQuiet console during attacks and honest kick messages in English and Indonesian
AdministrationBuilt-in ViaVersion with verified updates; /ng admin commands, live HUD, diagnostics and bug report; /alert, /find, /gkick and /ping; events API for plugin developers

What PRO adds

PRO moduleWhat it does
Sentinel LimboA short virtual lobby checks that the client behaves like a real game before it reaches your servers.
Interactive CAPTCHAAsks the player to type a code, solve a sum or write a number in digits in chat.
Verified-player trust cacheRemembers verified players across restarts so they skip heavy checks next time.
Reconnect CheckAsks a first-time player to reconnect once. Flood bots rarely do this correctly.
Account GuardLimits how many accounts can be online, or join, from one IP address.
Nickname GuardLocks staff names to their own IP addresses and rejects look-alike names.
Packet FirewallLimits packets and bandwidth per connection and per IP address.
Anti-VPN and ASN/ISP filterChecks connecting players against VPN detection providers that you configure, and can block hosting networks.
Country GuardAllows or blocks countries and alerts staff when a player logs in from a new country.
Public proxy feedsBlocks addresses from public proxy lists.
Live blacklistLoads a shared blacklist feed that you provide.
Port DoS shieldSwitches on by itself during connection floods and switches off when traffic is calm.
Attack join queueLets new players in at a steady pace during an attack.
Pre-Mojang gateScreens new players before Mojang authentication runs.
Linux kernel bridgeOptional Linux helper for TCP checks and firewall-level blocks.
Web dashboard and config studioA private web page with live statistics.
Cloud monitoring linkOptional connection to Formatra cloud monitoring.
Discord alertsPosts attack, blacklist and security alerts to your own Discord webhook.
Seamless maintenance reconnectMoves players to a fallback server when a backend restarts.
Backend DNS refreshPicks up backend hostname changes without restarting the proxy.

Which edition do I need

Start with Free. It covers the core protection most networks need and costs nothing to try.

Consider PRO if you need any of the following:

  • verify suspicious players in a limbo or with a CAPTCHA;
  • block VPNs, hosting networks or whole countries;
  • limit alt accounts per IP address, or protect staff names on an offline-mode (cracked) network;
  • get Discord alerts or move players to a fallback server during restarts.

Upgrade from Free to PRO

  1. Buy the NusaGate PRO add-on on the NusaGate BuiltByBit page.
  2. Download your PRO ZIP. It contains the PRO JAR, a nusa-license.properties file with your private key already filled in, and a short start guide.
  3. Stop the proxy and back up the whole proxy folder.
  4. Replace the Free JAR with the PRO JAR, and update your start command or script to the new file name.
  5. Put nusa-license.properties in the same folder as the PRO JAR.
  6. Keep your existing nusagate.yml and velocity.toml.
  7. Start the proxy. If no key is found, the console pauses and asks you to paste your key.
  8. Run /ng edition. Every PRO module should show as unlocked.

PRO sections that are missing from your nusagate.yml use safe defaults. To tune one, copy that section from default-nusagate.yml, the reference configuration inside the PRO JAR (open the JAR with any ZIP tool).

Where the license file goes

Your PRO license lives in nusa-license.properties, in the same folder as the PRO JAR.

  • Never share this file, and do not show it in screenshots or support chats.
  • When you update to a newer PRO JAR, keep the license file and any key that already works.
  • /ng license shows the current license state. /ng license followed by your key lets you paste a new key from the console or in game.
  • If you lost the file, download your purchase again from BuiltByBit or contact Formatra Studio there.

Next steps

Nusa product documentation · NusaGateFree & PRO editions

Loading the index…