Commands & in-game panel
Every /nusa command in one table, plus how to use the hologram panel, guided setup, status, doctor and safe mode.
On this page
All NusaSpigot tools live under one command: /nusa. In the console, type it without the slash, for example nusa status. If another plugin also registers nusa, use /nusaspigot:nusa.
Command overview
| Command | Permission | What it does |
|---|---|---|
/nusa help [1|2] | any /nusa permission | Lists the commands you are allowed to use |
/nusa gui [close] | OP or nusaspigot.admin | Opens or closes your private hologram control panel |
/nusa status [watch|once|details|json|off] | nusaspigot.command.status | TPS, MSPT, memory and active modules |
/nusa setup | nusaspigot.command.setup | Guided setup for your server type and hardware |
/nusa doctor [page|json|scan] | nusaspigot.command.doctor | Checks plugins and gives compatibility advice |
/nusa lagchunks start [seconds] | nusaspigot.command.lagchunks | Finds the most expensive chunks and plugins |
/nusa perf and /nusa lagspikes | nusaspigot.command.perf | Performance history and a list of lag spikes |
/nusa alerts on|off | nusaspigot.alerts | Turns lag alerts in chat on or off for you |
/nusa autotune [status|on|off] | nusaspigot.command.autotune | Auto-tune status and control |
/nusa pregen <radius> <world> | nusaspigot.command.pregen | Generates chunks around spawn in advance |
/nusa backup [status|now|list|restore <id>] | nusaspigot.command.backup | World backups and restore |
/nusa gamerules [world] | nusaspigot.command.gamerules | Browse and change gamerules per world |
/nusa security [status|update] | nusaspigot.command.security | Status of the crash-protection rules |
/nusa link <token|status|off> | nusaspigot.command.link | Connects the server to the Cloud Panel |
/nusa license <key> | OP or nusaspigot.admin | Saves and verifies a new license key |
/nusa safemode [status|json] | nusaspigot.command.safemode | Emergency mode: turns off Nusa optimizations and guards until restart |
In-game hologram panel (/nusa gui)
Join the server as an operator and type:
/nusa guiA private control panel appears in front of your character. Only you can see it.
- Aim at a button until it lights up, then click.
- The performance section refreshes every second.
- Startup values change when you click them. Before anything is saved, the panel shows a preview that explains every change.
- Press Shift or type
/nusa gui closeto close the panel.
Saved changes take effect after a server restart.
Guided setup (/nusa setup)
The guided setup picks starting values for your server type and hardware. Answer each question with a command:
nusa setup
nusa setup survival
nusa setup 100
nusa setup 12 16
nusa setup preview 2
nusa setup apply| Step | Example | Meaning |
|---|---|---|
| Server type | nusa setup survival | survival, skyblock, hub (or lobby), or minigame |
| Expected players | nusa setup 100 | Players online at the same time |
| Hardware | nusa setup 12 16 | CPU cores and RAM in GB |
| Review | nusa setup preview 2 | Shows a page of changes. Every page must be reviewed |
| Save | nusa setup apply | Saves with an automatic backup in nusa-config-backups/ |
Every change is shown as old -> new. nusa setup cancel discards the plan. The result applies after a restart.
Watching server health (/nusa status)
nusa status
nusa status watch
nusa status off- TPS (ticks per second):
20.00means the server keeps up comfortably. - MSPT (milliseconds per tick): every tick has a
50 msbudget. Staying under 35–40 ms leaves room for spikes. - Heap: the Java memory in use. A sawtooth pattern is normal. If it stays above 85–90%, the server needs more RAM or has too many chunks or entities loaded.
watch refreshes the numbers every few seconds (an action bar for players, one line per update in the console) and stops by itself after five minutes. details shows per-module timings, and json prints raw data for other tools.
Plugin doctor and safe mode
When you investigate lag or strange plugin behaviour, run these in order:
nusa doctor
nusa doctor scan
nusa safemodenusa doctorlists your plugins with compatibility advice.nusa doctor scanchecks plugin JARs for server classes that do not exist in this version, a common cause of errors after a Minecraft update.nusa safemodeimmediately turns off all Nusa optimizations and security guards until the server restarts. If the problem disappears in safe mode, a Nusa module is involved. If it still happens, the cause is a plugin, datapack or hardware.
Restart the server to leave safe mode. Check it any time with nusa safemode status.
Other commands
- Lag, auto-tune and staff alerts: Lag diagnostics & auto-tune
- Generating chunks in advance: World pre-generation
- Backups and restore: World backups
- Connecting the Cloud Panel: Cloud panel & server presets