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
| Area | Modules |
|---|---|
| Anti-bot | Attack 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 |
| Security | Protocol exploit fixes, backend plugin-message shield, static IP, CIDR and username blacklist |
| Performance | Compression floor, packet batching and Bedrock fast paths; memory leak guard |
| Players and console | Quiet console during attacks and honest kick messages in English and Indonesian |
| Administration | Built-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 module | What it does |
|---|---|
| Sentinel Limbo | A short virtual lobby checks that the client behaves like a real game before it reaches your servers. |
| Interactive CAPTCHA | Asks the player to type a code, solve a sum or write a number in digits in chat. |
| Verified-player trust cache | Remembers verified players across restarts so they skip heavy checks next time. |
| Reconnect Check | Asks a first-time player to reconnect once. Flood bots rarely do this correctly. |
| Account Guard | Limits how many accounts can be online, or join, from one IP address. |
| Nickname Guard | Locks staff names to their own IP addresses and rejects look-alike names. |
| Packet Firewall | Limits packets and bandwidth per connection and per IP address. |
| Anti-VPN and ASN/ISP filter | Checks connecting players against VPN detection providers that you configure, and can block hosting networks. |
| Country Guard | Allows or blocks countries and alerts staff when a player logs in from a new country. |
| Public proxy feeds | Blocks addresses from public proxy lists. |
| Live blacklist | Loads a shared blacklist feed that you provide. |
| Port DoS shield | Switches on by itself during connection floods and switches off when traffic is calm. |
| Attack join queue | Lets new players in at a steady pace during an attack. |
| Pre-Mojang gate | Screens new players before Mojang authentication runs. |
| Linux kernel bridge | Optional Linux helper for TCP checks and firewall-level blocks. |
| Web dashboard and config studio | A private web page with live statistics. |
| Cloud monitoring link | Optional connection to Formatra cloud monitoring. |
| Discord alerts | Posts attack, blacklist and security alerts to your own Discord webhook. |
| Seamless maintenance reconnect | Moves players to a fallback server when a backend restarts. |
| Backend DNS refresh | Picks 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
- Buy the NusaGate PRO add-on on the NusaGate BuiltByBit page.
- Download your PRO ZIP. It contains the PRO JAR, a
nusa-license.propertiesfile with your private key already filled in, and a short start guide. - Stop the proxy and back up the whole proxy folder.
- Replace the Free JAR with the PRO JAR, and update your start command or script to the new file name.
- Put
nusa-license.propertiesin the same folder as the PRO JAR. - Keep your existing
nusagate.ymlandvelocity.toml. - Start the proxy. If no key is found, the console pauses and asks you to paste your key.
- 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 licenseshows the current license state./ng licensefollowed 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
- Install NusaGate if you have not set up the proxy yet.
- Anti-bot and anti-exploit explains every module in plain language.
- Module map shows where each module lives in
nusagate.yml.