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

CommandPermissionWhat it does
/nusa help [1|2]any /nusa permissionLists the commands you are allowed to use
/nusa gui [close]OP or nusaspigot.adminOpens or closes your private hologram control panel
/nusa status [watch|once|details|json|off]nusaspigot.command.statusTPS, MSPT, memory and active modules
/nusa setupnusaspigot.command.setupGuided setup for your server type and hardware
/nusa doctor [page|json|scan]nusaspigot.command.doctorChecks plugins and gives compatibility advice
/nusa lagchunks start [seconds]nusaspigot.command.lagchunksFinds the most expensive chunks and plugins
/nusa perf and /nusa lagspikesnusaspigot.command.perfPerformance history and a list of lag spikes
/nusa alerts on|offnusaspigot.alertsTurns lag alerts in chat on or off for you
/nusa autotune [status|on|off]nusaspigot.command.autotuneAuto-tune status and control
/nusa pregen <radius> <world>nusaspigot.command.pregenGenerates chunks around spawn in advance
/nusa backup [status|now|list|restore <id>]nusaspigot.command.backupWorld backups and restore
/nusa gamerules [world]nusaspigot.command.gamerulesBrowse and change gamerules per world
/nusa security [status|update]nusaspigot.command.securityStatus of the crash-protection rules
/nusa link <token|status|off>nusaspigot.command.linkConnects the server to the Cloud Panel
/nusa license <key>OP or nusaspigot.adminSaves and verifies a new license key
/nusa safemode [status|json]nusaspigot.command.safemodeEmergency mode: turns off Nusa optimizations and guards until restart

In-game hologram panel (/nusa gui)

Join the server as an operator and type:

/nusa gui

A private control panel appears in front of your character. Only you can see it.

  1. Aim at a button until it lights up, then click.
  2. The performance section refreshes every second.
  3. Startup values change when you click them. Before anything is saved, the panel shows a preview that explains every change.
  4. Press Shift or type /nusa gui close to 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
StepExampleMeaning
Server typenusa setup survivalsurvival, skyblock, hub (or lobby), or minigame
Expected playersnusa setup 100Players online at the same time
Hardwarenusa setup 12 16CPU cores and RAM in GB
Reviewnusa setup preview 2Shows a page of changes. Every page must be reviewed
Savenusa setup applySaves 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.00 means the server keeps up comfortably.
  • MSPT (milliseconds per tick): every tick has a 50 ms budget. 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 safemode
  • nusa doctor lists your plugins with compatibility advice.
  • nusa doctor scan checks plugin JARs for server classes that do not exist in this version, a common cause of errors after a Minecraft update.
  • nusa safemode immediately 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

Nusa product documentation · NusaSpigotPaper fork · Java 21 / 25

Loading the index…