Stock the kit room
See what the kit room gives players, and add, rename or remove its categories and items.
The kit room is a shelf. A player opens it while building a kit, clicks an item and gets a copy: the shelf never empties and never changes. This page shows what players see and how an admin edits the shelf.
Before you start#
- You have
exyliasandbox.adminto edit it, andexyliasandbox.command.kitroom(given to everyone by default) to use it. /kitroomonly works while a player is in the kit creator or inside a sandbox world; anywhere else they are told they must be in kit creator mode. It opens by itself five ticks after a player enters the creator. See Build and manage kits.
Since 1.2.x the shelf, its editor and its storage belong to ExyliaLib's kit room module; ExyliaSandBox only seeds it and decides where it opens. The old user/kitroom.yml and the two admin/kitroom_category_*.yml screens no longer exist, and the room is always a chest window, even under the SCREEN menu style, because the player builds in their own inventory.
Editing it#
Open the editor
Run /sandboxadmin and click Kit room. You get ExyliaLib's staff editor: the list of categories, where you create, rename and delete them.
Add a category
Create one from the list. The categories become the tabs along the bottom of the player's screen, and a tab is drawn with its first item.
Fill it
Editing a category asks for its name and then opens its items in the library's item list editor. Add and remove the items players can take. Use the back button to return to the admin panel.
Rename or delete categories
From the same list, rename a category or delete it. Deleting a category deletes its items too.
The editor and its screens are the library's, so their wording and layout follow ExyliaLib, not this plugin's lang/ files.
Check that it works#
Run /kitcreator, click Create Kit and name it. The kit room opens: your tabs are along the bottom and the items of the current tab fill the rows above. Click an item and a copy lands in your inventory; the shelf is unchanged. /kitroom <category> opens it on one category.
Going further#
What a click takes#
| Click | What you get |
|---|---|
| Left or right click | One stack, as stored |
| Shift + left or right click | A full stack, up to the material's maximum |
| F | The item into your offhand; whatever was there comes back to your inventory |
A full inventory refuses with a short line in chat. Clicks are limited to one every 150 ms, so a held click cannot fill the inventory in a blink. Players can take as many copies as they like: the room limits which items exist, not how many.
Start from the shipped categories#
The first time the plugin runs with an empty room it is seeded with five categories holding roughly 130 pre-enchanted items.
| Id | Name | Icon | What is in it |
|---|---|---|---|
armaduras | Armor | Netherite chestplate | Netherite and diamond gear with Protection IV, Unbreaking III, Mending; Sharpness V swords, tridents with Impaling V and Loyalty III, maces, elytra |
consumibles | Consumables | Golden apple | Golden and enchanted golden apples, pearls, cobwebs, XP bottles, water buckets, totems, obsidian, end crystals, respawn anchors, glowstone |
explosivos | Explosives | TNT | TNT, TNT minecarts, fireworks, wind charges, breeze rods |
pociones | Potions | Splash potion | Twenty-three splash potions |
flechas | Arrows | Tipped arrow | Twenty-three tipped-arrow types, plus spectral and normal arrows |
The shipped ids are in Spanish while the display names are English; a server seeded before 1.1.0 keeps its Spanish names. Rename the display names whenever you like: the ids are what /kitroom <category> takes and they do not change with a rename.
An admin who empties the room on purpose gets the seed again on the next start. Reset to Defaults no longer exists.
What is stored#
The room lives in ExyliaLib's table exylia_kitroom, in this plugin's database, and is held in memory.
Upgrading from the old shelf
A server that ran the older shelf keeps its categories: the first time the new table is empty, the rows of sandbox_kitroom_categories and sandbox_kitroom_items are copied in, categories in their priority order and items in slot order. The old rows are left where they are and never written again. Two things do not carry over: a category's own icon (the tab shows its first item) and the gaps between items.
Something missing on this page? Tell us on Discord