Skip to main content
The Kit Room is a virtual inventory of admin-curated items that players browse when building their personal PvP kits. Think of it as your server’s item catalogue: whatever you place inside a Kit Room page is exactly what players are allowed to equip in their loadouts. Setting it up correctly is the most important first step before opening kit-based PvP to your community.

​
Setting Up the Kit Room

You can open the Kit Room editor in two ways: by running the /kitroom command directly (requires perplayerkit.admin), or by opening the main /kit menu and clicking the Nether Star. Both methods take you to the same editor where you manage each Kit Room page.
1

Join the server as an admin

Make sure your account has either the perplayerkit.admin permission or full operator (OP) status. Without it, the Kit Room editor will not be accessible.
2

Open the Kit Room editor

Run /kitroom directly, or run /kit (alias /k) to open the main menu and then click the Nether Star. Both paths open the same Kit Room editor where you can manage each page.
3

Fill each Kit Room page with items

You will see an empty GUI representing a single Kit Room page. Place every item you want players to be able to pick from into the available slots. You can include weapons, armor, potions, food, consumables — anything your server’s PvP format calls for.
4

Save the Kit Room page

When the page is ready, hover over the barrier block in the corner of the GUI and shift right-click it. This saves the current contents as a Kit Room page. You will hear a success sound confirming the save.
5

Repeat for each additional page

Navigate to the next Kit Room page and repeat the process — fill the GUI with items, then shift right-click the barrier block to save. You can configure up to five named pages (see below for how to customize their names and icons).

​
Customizing Kit Room Names and Icons

Each Kit Room page has its own display name and icon shown in the selection GUI. Configure these in config.yml under the kitroom.items block:
config.yml
kitroom:
  items:
    1:
      name: "OG Vanilla"
      material: "DIAMOND_SWORD"
    2:
      name: "Training"
      material: "WOODEN_SWORD"
    3:
      name: "Potions"
      material: "SPLASH_POTION"
    4:
      name: "Armory"
      material: "NETHERITE_SWORD"
    5:
      name: "Axe & UHC"
      material: "SHIELD"
The name field sets the label shown in the GUI, and material sets the icon next to it. Use any valid Bukkit material name in uppercase. After saving the file, reload or restart the plugin for the changes to take effect.

​
Kit Room Ideas

Not sure what to put in each page? Here are some popular PvP loadout categories to inspire your setup:

Crystal PvP

End crystals, obsidian, armor, totems of undying, respawn anchors, and glowstone.

Sword PvP

Swords, shields, full armor sets, golden apples, and food for sustain.

UHC

Golden apples, potions, bows, arrows, crafting materials, and enchanted gear.

Axe Combat

Axes of varying enchantments, shields, heavy armor, and gap apples.

Utility

Splash potions, wind charges, ender pearls, fireworks, and miscellaneous tools.
The only-allow-kitroom-items anti-exploit setting in config.yml controls whether players are restricted to using only items present in a Kit Room page. When set to true, any item not found in the Kit Room will be blocked from kit saving and loading — a useful safeguard on competitive servers to prevent item duplication or unapproved gear.
config.yml
anti-exploit:
  only-allow-kitroom-items: true
You can disable kit commands entirely in non-PvP worlds — such as your spawn or lobby — using the disabled-command-worlds config key. Players who run /kit in a listed world will see your custom message instead.
config.yml
disabled-command-worlds:
  - "spawn"
  - "lobby"
disabled-command-message: "<red>Kits are disabled here!</red>"
The message supports full MiniMessage formatting, so you can style it with colors, bold text, and more.