Home›User Guide›Kit Setup

Kit Setup

How to create, update, and manage kits that players use during matches.

Creating a Kit

  1. Equip your full layout: place the items in your inventory and hotbar, wear your armor, and assign offhand items.
  2. Run the command: /kit create KitName to save your current inventory configuration.
  3. (Optional) Hold the item you want to represent the kit in selection GUIs and run: /kit seticon KitName
Kit Names are Case-Sensitive
Note that NoDebuff and nodebuff are handled as two distinct kit profiles.

Updating an Existing Kit

To overwrite a kit's item slots, arrange the new layout in your inventory and execute:

/kit setinv KitName

To modify only the GUI icon representation:

# Hold the new icon item in your main hand, then:
/kit seticon KitName

Build Mode (Kit and Arena Must Match)

Build mode marks whether a kit is used for block-building matches. Set it with:

/kit build <name> <true|false>

This must match the linked arena's build mode (/arena build). If they differ, matchmaking ignores the arena and players may see No arenas available for this kit.

Keep arena and kit build mode in sync
  • Build kit + build arena: /kit build Bridge true and /arena build BridgeArena true
  • Non-build kit + non-build arena: /kit build NoDebuff false and /arena build Arena1 false
Use /kit info <name> to check the kit's build mode. Setting /kit build <name> false also clears the block whitelist.

Build-Compatible Kits (Block Whitelist)

For build kits, you can optionally restrict which block types players may place and break:

/kit build Bridge true
# Hold the whitelist block (e.g. sandstone, glass) and run:
/kit allowblock Bridge
# Repeat for each block type you wish to whitelist

/kit allowblock also enables build mode automatically. If the whitelist is empty, any block can be placed in a build-enabled arena. If blocks are whitelisted, only those types are allowed during combat.

Kit Editor GUI (For Players)

Players can customize and rearrange item placements within their personal copy of a kit layout. This does not alter the base kit template generated by the administrator. Open the layout editor using:

/kiteditor          # Opens the kit selector GUI
/kiteditor NoDebuff # Directly launches the editor workspace for NoDebuff

This editor provides a drag-and-drop workspace where players can save custom layouts for matchmaking queues.

VIP Preferences inside the Kit Editor

All virtual practice features can be inherited by granting the parent permission node shyamduels.vip.

Custom Kits Builder

The Custom Kits builder system enables players to assemble personalized kits from category selections. It matches players using base configs defined in the configuration files.

Exhaustive Kit Setup Command Reference

Below is a complete reference guide of commands for registering, editing, and deleting kit configurations (requires shyamduels.admin):

Command Syntax / Parameters Functional Behavior
/kit create /kit create <name> Saves your current inventory, armor slots, offhand, and active effects as a new kit profile.
/kit delete /kit delete <name> Deletes the kit profile, clears linked arenas, and removes player customized layouts.
/kit setinv /kit setinv <name> Overwrites the kit's inventory items and armor layout to match your current inventory contents.
/kit seticon /kit seticon <name> Configures the GUI selection icon to your held item.
/kit allowblock /kit allowblock <name> Whitelists your held block material and enables build mode for the kit.
/kit removeblock /kit removeblock <name> Removes your held block material from the build whitelist. Disables build mode when the list is empty.
/kit build /kit build <name> <true/false> Enables or disables build mode for the kit. Must match the linked arena (/arena build). false clears the block whitelist.
/kit setdisplayname /kit setdisplayname <name> <displayname> Configures the GUI display name of the kit (supports Kyori MiniMessage formatting).
/kit setdescription /kit setdescription <name> <description> Sets the description lines displayed when hovering over the kit in selector GUIs.
/kit list /kit list Lists all registered kit configurations.
/kit info /kit info <name> Displays details about the kit, including inventory slots and whitelisted block list.
/kit matchstartpots enable|disable|scan|list <name> Controls match-start potion scanning for a kit. Removes blocked debuffs at round start (see match-start-potions in config.yml).
/kit queuerounds /kit queuerounds <name> <rounds> Sets default round count when this kit is queued.
/kit kitroom /kit kitroom <name> Opens the kit room editor for practice loadout testing.
/kit give /kit give <player> <name> Applies a kit to a player's inventory.
/kit load /kit load <name> Loads the kit into your inventory for editing.
/kit deleteeditedkits /kit deleteeditedkits <name> Clears all player-edited layouts saved for this kit.
/kit setsaturation /kit setsaturation <name> <value> Sets food saturation applied when the kit is given.
Kit Deletion Warning
Deleting a kit clears all customized player files associated with it from the database and removes all linked arena entries.