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
| Command | What it does |
|---|---|
/npb convert | Rebuilds every installed content plugin's pack, finds menus, converts everything and delivers it to Geyser |
/npb status | Active pack, pack waiting for a restart, running task, and one group per live Bedrock bridge (ModelEngine, furniture, font) |
/npb check | Geyser, extension, pack and content plugin versions, each with the fix when something is wrong |
/npb report | What the last conversion did |
/npb cancel | Stops the running task after its current step |
/npb config | Shows and changes settings (a menu in game, a list in the console) |
/npb gui | Manages converted custom chest menus |
/npb pack | Earlier packs: list, keep, use, undo |
/npb help | Short 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 itPlugin 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 itemSometimes 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 handChanges 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 entryFields you can change with tune:
| Field | Values | Effect |
|---|---|---|
offset_x | pixels, for example -8 | Moves the background left or right |
offset_y | pixels, for example -30 | Moves the background up or down |
rows | 1 to 6 | 1–3 rows use the Bedrock small chest, 4–6 rows the large chest |
slots | auto, art, native | auto decides from the art; art means the art draws the slot frames; native uses Bedrock slot frames |
enabled | on, off | off leaves this menu as a plain chest |
close_button | on, off | Close 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 beforeOlder 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.
| Command | Permission |
|---|---|
/npb panel in game, /npb gui | nusapack.command.gui |
/npb convert | nusapack.command.convert |
/npb status, /npb pack (list) | nusapack.command.status |
/npb check | nusapack.command.doctor |
/npb check <pack> | nusapack.command.validate |
/npb report, /npb report errors, /npb report glyphs | nusapack.command.report |
/npb report items | nusapack.command.material |
/npb cancel | nusapack.command.cancel |
/npb config | nusapack.command.settings |
/npb config reload | nusapack.command.reload |
/npb pack keep | nusapack.command.stage |
/npb pack use | nusapack.command.activate |
/npb pack undo | nusapack.command.rollback |
/npb help | nusapack.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
- Everyday use: how these commands fit into a normal day.
- Settings: what each
/npb configoption does. - Troubleshooting: what to do with the output of
/npb check.