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, /antibot and /ab do the same thing. This page uses /ng.
  • In the proxy console, leave out the slash: ng stats.
  • Every /ng command needs the nusagate.command.admin permission. You can change this permission name, or switch the whole command family off, under admin-integration.commands in nusagate.yml.
  • /ng on its own shows the same status page as /ng stats, and /ng help lists every subcommand.

Status and monitoring

CommandWhat it does
/ng statsProtection 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 cpuCPU, memory and live packet and byte rates of the proxy.
/ng memoryMemory 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 resetstatsResets the traffic, threat and attack-wave counters. /ng reset does the same.

Blocking and unblocking

CommandWhat 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 listShows 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.

CommandWhat it does
/ng attackShows the state of every vector.
/ng attack <vector> autoReturns the vector to automatic detection.
/ng attack <vector> onForces attack mode on, for example when you expect an attack.
/ng attack <vector> offForces attack mode off.
/ng attack <vector> toggleSwitches the forced state on or off.
/ng attack <vector> triggerStarts one attack-mode period as if a flood had been detected.
/ng attack <vector> resetClears the vector's counters.

Use all as the vector to change all three at once, for example /ng attack all auto.

Configuration and servers

CommandWhat it does
/ng reloadReloads 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 editionCompares Free and PRO and shows which modules this JAR unlocks. /ng pro does the same.

Diagnostics and bug reports

CommandWhat it does
/ng diagnosticsShows 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.

CommandWhat 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.

CommandDefault permissionWhat it does
/alert <message>nusagate.command.alertSends an announcement to every player. Add -title before the message to show it as a title.
/alertraw <message>nusagate.command.alertSends an announcement written in MiniMessage or JSON format.
/find <player>nusagate.command.findShows which server a player is on. /search does the same.
/gkick <player> [reason]nusagate.command.gkickDisconnects a player from the whole network.
/pingnone for playersShows your own latency.
/ping <player>nusagate.command.ping.othersShows 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 true

Give nusagate.command.admin only to trusted administrators, because it controls blocks and protection settings.

Next steps

Nusa product documentation · NusaGateFree & PRO editions

Loading the index…