Commands

Every /npb command, what it does and which permission it needs.

On this page

All NusaPack commands start with /npb (alias /nusapack). This page lists each command with its options, plus the permissions you can give to staff.

In game, type commands with a slash. In the console, leave the slash out, for example npb status. Typing /npb on its own opens the control panel in game, where every action is also a button, and shows the status in the console. /npb help shows short help for all commands, and /npb help convert for one command.

Command overview

CommandWhat it does
/npb convertRebuilds every installed content plugin's pack, finds menus, converts everything and delivers it to Geyser
/npb statusActive pack, pack waiting for a restart, running task, and one group per live Bedrock bridge (ModelEngine, furniture, font)
/npb checkGeyser, extension, pack and content plugin versions, each with the fix when something is wrong
/npb reportWhat the last conversion did
/npb cancelStops the running task after its current step
/npb configShows and changes settings (a menu in game, a list in the console)
/npb guiManages converted custom chest menus
/npb packEarlier packs: list, keep, use, undo
/npb helpShort help for all commands or one command

Converting

/npb convert                      every installed content plugin that is switched on
/npb convert nexo                 one plugin
/npb convert nexo,itemsadder      several plugins (comma list)
/npb convert list                 pick from the installed plugins
/npb convert nexo --no-rebuild    use the plugin's last built pack instead of rebuilding it

Plugin names are nexo, itemsadder, oraxen, craftengine and ecoitems. A full conversion also includes ModelEngine models and custom menus. If you name a plugin that is switched off in settings.yml, NusaPack tells you how to switch it back on.

The last line of the result says whether Bedrock players only need to rejoin or the server needs one restart.

Status and checks

/npb status shows what is active right now and what waits for a restart. In the console it also prints each bridge's debug counters under Details:.

/npb check is the first thing to run when Bedrock players do not see your content. It shows the versions in use and checks the usual causes, each with its fix:

  • Geyser missing, or custom content switched off in Geyser's config
  • players allowed to refuse the resource pack
  • the NusaPack Geyser extension missing, or installed but not loaded yet
  • two copies of a NusaPack jar
  • no pack yet, or a pack waiting for a restart

/npb check <pack> validates one specific pack. Pack names start with gen-; /npb pack lists them.

Reports

/npb report                                  counts and blocking problems of the last conversion
/npb report errors                           every problem, with the reason
/npb report glyphs                           how fonts and emoji were converted
/npb report items                            items waiting for a base material
/npb report items resolve <item> <material>  choose the base material for one item

Sometimes NusaPack cannot decide which Java base material an item should use. /npb report items lists those items, and resolve stores your choice. /npb report also says how many animated textures were kept still and how much smaller the pack got.

Settings

/npb config                    every setting (a menu in game, a list in the console)
/npb config <name>             one setting: what it does, its value and its choices
/npb config <name> <value>     change it, for example: /npb config auto_convert on
/npb config reload             read the files again after editing them by hand

Changes made by command or in the menu are saved to settings.yml at once. Settings explains every option.

Custom menus

/npb gui list                         every converted menu with its size, rows and offset
/npb gui scan [plugins]               find menus in menu plugin files (comma list to limit)
/npb gui capture [id]                 measure the custom menu you have open right now
/npb gui tune <id> <field> <value>    adjust one menu
/npb gui remove <id>                  remove a hand-made menu entry

Fields you can change with tune:

FieldValuesEffect
offset_xpixels, for example -8Moves the background left or right
offset_ypixels, for example -30Moves the background up or down
rows1 to 61–3 rows use the Bedrock small chest, 4–6 rows the large chest
slotsauto, art, nativeauto decides from the art; art means the art draws the slot frames; native uses Bedrock slot frames
enabledon, offoff leaves this menu as a plain chest
close_buttonon, offClose button in the menu corner, on by default (touch players have no Esc key)

Offsets are in pixels at Java GUI scale. Menu changes apply after /npb convert, and Bedrock players see them after rejoining. A menu-only change needs no restart.

Earlier packs

/npb pack                 earlier packs, the active one first
/npb pack keep [plugin]   convert without installing
/npb pack use [pack]      install a kept pack
/npb pack undo            go back to the pack before

Older command names

Older names such as details, settings, set, stage, activate, rollback and doctor still work when typed, but are no longer listed. Use the names on this page in new guides and scripts.

Permissions

nusapack.admin grants everything and is given to operators by default. To let staff use only some commands, give them the matching permission. Each one covers only its own command: for example, the status permission does not allow converting.

CommandPermission
/npb panel in game, /npb guinusapack.command.gui
/npb convertnusapack.command.convert
/npb status, /npb pack (list)nusapack.command.status
/npb checknusapack.command.doctor
/npb check <pack>nusapack.command.validate
/npb report, /npb report errors, /npb report glyphsnusapack.command.report
/npb report itemsnusapack.command.material
/npb cancelnusapack.command.cancel
/npb confignusapack.command.settings
/npb config reloadnusapack.command.reload
/npb pack keepnusapack.command.stage
/npb pack usenusapack.command.activate
/npb pack undonusapack.command.rollback
/npb helpnusapack.command.help

All of these default to operators only. nusapack.use is a small bundle that gives read access to /npb status and /npb help.

Next steps

Nusa product documentation · NusaPackPaper 1.21.x · Java 21

Loading the index…