Skip to main content
This guide walks you through the entire process of going from a fresh server to a fully functional PerPlayerKit setup. By the end you will have the plugin installed, a Virtual Kit Room stocked with items, permissions assigned to your groups, and a working kit system that your players can start using immediately. The whole process takes under ten minutes.

​
Setup Steps

1

Install the Plugin

Stop your server, then copy the PerPlayerKit-x.x.x.jar file into your plugins/ folder. Start the server to let PerPlayerKit generate its configuration files, then stop the server again before making any edits.
# Your plugins folder structure after first start
plugins/
├── PerPlayerKit-x.x.x.jar
└── PerPlayerKit/
    ├── config.yml
    └── ...
2

Configure Storage

Open plugins/PerPlayerKit/config.yml and set the storage type. For a single server, SQLite requires no external database and is the simplest option:
storage:
  type: "sqlite"
Save the file. If you need MySQL or PostgreSQL for a multi-server network, see the full Installation guide for connection details.
3

Start the Server and Open the Kit Room Editor

Start the server and join with an account that has operator status or the perplayerkit.admin permission. Once in-game, run /kit to open the main plugin GUI, then click the Nether Star item to enter the Kit Room editor.
4

Fill the Kit Room with Items

Inside the Kit Room editor, place every item you want players to be able to pick from — armor, weapons, potions, food, tools, and anything else that belongs in your PvP meta. When you’re satisfied with the contents, shift-right-click the Barrier block in the corner to save the Kit Room.
You can create multiple themed Kit Rooms (for example, Crystal PvP, Sword PvP, and UHC). Each Kit Room page is configured separately. Players browse all available pages when building their loadout.
Some Kit Room ideas to get you started:
ThemeExample Items
Crystal PvPEnd crystals, obsidian, totems, netherite armor
Sword PvPSwords, shields, golden apples, netherite armor
Axe CombatAxes, shields, crossbows, specialized gear
UtilityPotions, wind charges, ender pearls, food
5

Grant Player Permissions

Add the following permissions to your groups using a permissions plugin such as LuckPerms:
GroupPermissions to GrantWhat They Grant
Playersperplayerkit.useKit creation, loading, sharing, enderchest kits, regear, heal, and repair
Staffperplayerkit.use + perplayerkit.staffAll player features plus /inspectkit and /inspectec for moderation
Adminsperplayerkit.use + perplayerkit.staff + perplayerkit.adminEverything above plus Kit Room editing and public kit management
perplayerkit.staff and perplayerkit.admin are additive — they grant only their own specific commands and do not automatically include player-facing features. Always pair them with perplayerkit.use for staff and admin groups.
# Example LuckPerms commands
/lp group default permission set perplayerkit.use true
/lp group staff permission set perplayerkit.use true
/lp group staff permission set perplayerkit.staff true
/lp group admin permission set perplayerkit.use true
/lp group admin permission set perplayerkit.staff true
/lp group admin permission set perplayerkit.admin true
6

Test the Setup as a Player

Switch to a non-admin account (or use a test player) and run /kit to open the main kit menu. Select Create New Kit, browse the Kit Room you just filled, choose items, arrange them in your inventory, and save the kit with a name. Then run /k1 to load it instantly.If the menu opens and items from your Kit Room appear correctly, your setup is complete.
/kit (alias /k) always opens the full GUI where players manage all their kits. The shortcut commands /k1 through /k9 skip the menu entirely and load the corresponding kit slot directly into the player’s inventory — great for quick reskitting between fights.
Once the basics are working, consider enabling these popular features in config.yml: 
feature:
  # Restore health and hunger when a player loads a kit
  set-health-on-kit-load: true
  set-hunger-on-kit-load: true

  # Re-apply the player's last kit automatically on respawn
  rekit-on-respawn: true
  rekit-on-respawn-delay: 0   # delay in ticks; increase if another plugin gives items on spawn

​
Where to Go Next

Full Configuration Reference

Explore every available configuration option: storage settings, anti-exploit rules, disabled worlds, regear modes, and more.

All Commands

See the complete list of player, staff, and admin commands, their aliases, and the exact permissions each one requires.