Commands and permissions
Every /nusagate subcommand and network command, what it does, and which permission controls it.
On this page
This page lists every NusaGate command so you can check protection, block troublemakers and collect diagnostics. Each table says what the command does and who can use it.
Before you start
- The main command is
/nusagate. The shorter aliases/ng,/nusa,/antibotand/abdo the same thing. This page uses/ng. - In the proxy console, leave out the slash:
ng stats. - Every
/ngcommand needs thenusagate.command.adminpermission. You can change this permission name, or switch the whole command family off, underadmin-integration.commandsinnusagate.yml. /ngon its own shows the same status page as/ng stats, and/ng helplists every subcommand.
Status and monitoring
| Command | What it does |
|---|---|
/ng stats | Protection mode, online players, traffic, blocked threats and performance. /ng status does the same. |
/ng hud [mode] [view] | Live statistics on your screen in game. Modes: actionbar, bossbar, title, or off to hide it. Views: default, cpu, network. |
/ng cpu | CPU, memory and live packet and byte rates of the proxy. |
/ng memory | Memory use and the status of the memory leak guard. |
/ng benchmark [level] | Measures compression and pre-login filter cost on your own hardware. The optional level is 1 to 9. |
/ng resetstats | Resets the traffic, threat and attack-wave counters. /ng reset does the same. |
Blocking and unblocking
| Command | What it does |
|---|---|
/ng ban <target> | Blocks an IP address, a CIDR range or a player name and disconnects matching players who are online. |
/ng unban <target> | Removes a block, an automatic temporary block and cached Anti-VPN results for that target. Use all to clear everything. |
/ng banlist [page] | Shows active blocks and automatic temporary blocks, one page at a time. |
/ng blacklist list | Shows the runtime blocklist. |
/ng blacklist add <target> | Adds an IP address or player name to the runtime blocklist. |
/ng blacklist remove <target> | Removes an entry from the runtime blocklist. |
A CIDR range is a way to write a whole block of IP addresses at once, for example 198.51.100.0/24.
Attack controls
NusaGate watches three kinds of floods, called vectors: bot (login floods), ping (server-list ping floods) and spam (chat and connection spam). Normally it switches attack mode on and off by itself.
| Command | What it does |
|---|---|
/ng attack | Shows the state of every vector. |
/ng attack <vector> auto | Returns the vector to automatic detection. |
/ng attack <vector> on | Forces attack mode on, for example when you expect an attack. |
/ng attack <vector> off | Forces attack mode off. |
/ng attack <vector> toggle | Switches the forced state on or off. |
/ng attack <vector> trigger | Starts one attack-mode period as if a flood had been detected. |
/ng attack <vector> reset | Clears the vector's counters. |
Use all as the vector to change all three at once, for example /ng attack all auto.
Configuration and servers
| Command | What it does |
|---|---|
/ng reload | Reloads nusagate.yml without a restart. The shortcuts /ngreload and /nusagatereload do the same. |
/ng servers [list or reload] | Lists your backend servers, or reloads the server list from velocity.toml. |
/ng motd [status or reload] | Shows or reloads the MOTD and favicon protection rules. |
/ng edition | Compares Free and PRO and shows which modules this JAR unlocks. /ng pro does the same. |
Diagnostics and bug reports
| Command | What it does |
|---|---|
/ng diagnostics | Shows the build version, installed Velocity plugins, modules you switched off, and a verification summary. /ng doctor does the same. |
/ng bugreport [notes] | Saves a support report to logs/nusagate-bugreport-<time>.md. Add a short description of the problem as notes. |
See Get support for what the report contains and how to share it safely.
PRO-only commands
These commands belong to PRO modules. The Free edition does not include those modules, so the commands show a short notice or an empty list there.
| Command | What it does |
|---|---|
/ng verified [action] | Manages the verified-player trust cache. Actions: list, info, add, remove, clear. |
/ng whitelist [action] [target] | Manages the Anti-VPN allowlist. Actions: list, page, add, remove. |
/ng feeds [status or reload] | Shows or refreshes the public proxy feeds. |
/ng license [status or key] | Shows the license state, or saves a new license key. In Free it confirms that no license is needed. |
Network commands
NusaGate also adds a few everyday proxy commands. Each can be switched on or off, and its permission changed, under admin-integration.network-commands in nusagate.yml.
| Command | Default permission | What it does |
|---|---|---|
/alert <message> | nusagate.command.alert | Sends an announcement to every player. Add -title before the message to show it as a title. |
/alertraw <message> | nusagate.command.alert | Sends an announcement written in MiniMessage or JSON format. |
/find <player> | nusagate.command.find | Shows which server a player is on. /search does the same. |
/gkick <player> [reason] | nusagate.command.gkick | Disconnects a player from the whole network. |
/ping | none for players | Shows your own latency. |
/ping <player> | nusagate.command.ping.others | Shows another player's latency. |
Give staff access
With LuckPerms for Velocity, grant permissions from the proxy console. For example, to let a moderator find and kick players but not use /ng:
lpv user ModName permission set nusagate.command.find true
lpv user ModName permission set nusagate.command.gkick trueGive nusagate.command.admin only to trusted administrators, because it controls blocks and protection settings.
Next steps
- Get support: create a bug report and share it safely.
- Anti-bot and anti-exploit: what each protection does.
- Built-in ViaVersion: manage the bundled ViaVersion plugin.