Content generated with AI — it may contain mistakes.

ExyliaSandBox/ConfiguringguideUpdated in v1.2.0

Stock the kit room

See what the kit room gives players, and add, rename or remove its categories and items.

Page 6 of 244 min read

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.admin to edit it, and exyliasandbox.command.kitroom (given to everyone by default) to use it.
  • /kitroom only 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.
It is ExyliaLib's kit room

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#

ClickWhat you get
Left or right clickOne stack, as stored
Shift + left or right clickA full stack, up to the material's maximum
FThe 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.

IdNameIconWhat is in it
armadurasArmorNetherite chestplateNetherite and diamond gear with Protection IV, Unbreaking III, Mending; Sharpness V swords, tridents with Impaling V and Loyalty III, maces, elytra
consumiblesConsumablesGolden appleGolden and enchanted golden apples, pearls, cobwebs, XP bottles, water buckets, totems, obsidian, end crystals, respawn anchors, glowstone
explosivosExplosivesTNTTNT, TNT minecarts, fireworks, wind charges, breeze rods
pocionesPotionsSplash potionTwenty-three splash potions
flechasArrowsTipped arrowTwenty-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