Staff and admin commands

kit.staff and kit.admin are the same two nodes, shortened.

Staff commands

These need perplayerkit.staff.

Command	Does
`/inspectkit <player>`	Opens that player’s kits.
`/inspectec <player>`	Opens that player’s enderchest kits.

Admin commands

These need perplayerkit.admin.

Command	Does
`/kitroom save`	Saves the current kit room to the database.
`/kitroom load`	Reloads the kit room from the database. Unsaved edits are lost.
`/savepublickit <id>`	Saves your inventory as that public kit.
`/purgeitem <item> <all confirm\|player ...>`	Deletes every copy of an item from stored kits.
`/kitdata export <scope> <file>`	Writes kit data to a `.ppk` file.
`/kitdata import <file>`	Reads a `.ppk` file back in.
`/perplayerkit autosetup`	Fills empty kit room pages and public kits with the bundled setup.
`/perplayerkit migrate <from> <to>`	Copies all kit data to a different database.
`/perplayerkit import kitsx`	Imports data from the KitsX plugin.
`/perplayerkit about`	Prints a one-line description of the plugin.

/purgeitem, /kitdata, and /perplayerkit also run from the console.

Set the server up quickly

/perplayerkit autosetup
/perplayerkit autosetup add-kits

Fills every kit room page and public kit that has never been saved on this server, using the bundled crystal setup. Anything you already configured is left alone, so it is safe to run twice. It reports what it filled, then points you at /kit and /publickit.

Admins joining a server with an empty kit room see this offered in chat, with the command as a clickable link.

add-kits also adds missing bundled definitions to an existing config. It preserves custom entries and saved contents.

Starting over

/perplayerkit autosetup reset confirm

Resets every enabled kit room page and declared public kit that has bundled defaults. Extra enabled pages become empty. Hidden pages and custom kit IDs without bundled contents are preserved.

reset overwrites work you have done. It runs from the server console only, and confirm is required.Player kits are not touched.

The kit room

/kitroom save     # save the current contents
/kitroom load     # throw away unsaved edits and reload

/kitroom does not open the editor. It only takes save or load. To edit, run /kit and click the nether star.

In the editor, shift-right-click the barrier block to save a page. Run /kitroom save before an export.

Public kits

/savepublickit <id>

The id is the key under publickits in config.yml, not the display name. See Public kits.

Managing data

Task	Page
Delete a banned item from every stored kit, including copies inside and bundles	Purge items
Move a kit room and public kits to another server	Export and import
Copy all kit data to another database	Change database
Find and restore a backup	Backups

Move to a different database

/perplayerkit migrate <from> <to>

Valid types: sqlite, mysql, postgresql, redis, yml.

/perplayerkit migrate sqlite mysql
/perplayerkit migrate mysql postgresql
/perplayerkit migrate redis sqlite

Runs in the background with the server online, and leaves the source database untouched.

Back up first, and set the new database’s details in config.yml before you run this.

Import from KitsX

/perplayerkit import kitsx

Reads KitsX data files from plugins/PerPlayerKit/.

Check world and region rules

Stand at the location and run /perplayerkit location [feature]. This uses the existing perplayerkit.admin permission. For example, /perplayerkit location rekit-respawn shows the current world, matching regions, location decision, and configured kit choice. Tab completes feature names. The command checks location rules only. See Worlds and regions for how permissions and other settings also affect an action.

Start here

Features

Commands

Settings

Managing data

Common issues

For developers

Staff and admin commands

Staff commands

Admin commands

Set the server up quickly

Starting over

The kit room

Public kits

Managing data

Move to a different database

Import from KitsX

Check world and region rules

​Staff commands

​Admin commands

​Set the server up quickly

​Starting over

​The kit room

​Public kits

​Managing data

​Move to a different database

​Import from KitsX

​Check world and region rules

Staff commands

Admin commands

Set the server up quickly

Starting over

The kit room

Public kits

Managing data

Move to a different database

Import from KitsX

Check world and region rules