Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/GuidesUpdated in v1.4.0

Create kits and categories

Build a kit, choose where it can be played, and group kits into categories for the menus.

Page 7 of 355 min read

You will end with a kit players can pick: a loadout, the arenas it is played in, a category that lists it and the places it is allowed (queue, duels, parties, ranked). A kit is a row in practice_kits; its rules are stored on the same row.

Before you start#

  • You have exyliapractice.admin (operators do).
  • An arena to play it in is optional while you build the kit, but a kit with none cannot start a match: see Set up arenas.

Steps#

Create a category

Every player-facing kit screen opens on the category list first, so a kit needs one. Run /epc, click Manage kits, then Categories, then Create. Chat asks for an id, then a display name. On the category screen set Name, Icon, Description, Status and Priority.

Create the kit

Manage kits → All kits → Create. Chat asks for an id, then a display name. The kit screen (titled KIT: your-id) opens.

Fill the loadout

Left click Loadout to open the grid, laid out the way a player reads an inventory: armour, offhand, inventory and hotbar. Right click Loadout to receive the kit in your own inventory.

Pick categories and arenas

Categories and Compatible arenas list every category and arena; click one to toggle it. A kit can be in several categories. The arena list is the same one as the arena's Kits button.

Choose where it can be played

Click Playability & ranked and set the switches (see below). Turn on Queue, and Ranked if you want ELO to move.

Enable it

Click Status. A disabled kit is skipped everywhere, including by a match that was already being set up.

Check that it works#

  • /queue lists the category, then the kit. If it does not, the kit is disabled, has no category, or Queue is off.
  • /duel <player> offers the kit when Duel is on.
  • Starting a match gives you the loadout you placed. If the kit has no compatible arena, players are told there are no arenas available.

The kit screen#

/epc → Manage kits → All kits → a kit.

ButtonWhat it sets
NameDisplay name
IconThe material shown in menus
StatusEnabled. A disabled kit is skipped everywhere.
DescriptionLore
CategoriesToggle each category on or off
Compatible arenasToggle each arena on or off
LoadoutLeft click opens the loadout grid; right click hands you the kit.
Kit rulesThe rules screen
Playability & rankedThe six switches below, and Bot practice, which links the kit to a bot combat mode. See Bot PvP
PrioritySort order

Kits and categories are drawn in priority order. It is a plain integer with no special meaning beyond sorting: left click adds 1, right click removes 1, Shift adds or removes 10. Set the ones you want at the top of /queue higher.

Playability#

Six independent switches decide where a kit may be used:

SwitchEffect when off
QueueNot offered in /queue
DuelNot offered in /duel
Party FFANot offered for a party free-for-all
Party splitNot offered for split teams
Party duelNot offered when one party queues against another
RankedMatches are played, ELO is not applied
Ranked is not the same as queue

A kit can be queueable and unranked, a fun kit that people want to matchmake without touching their rating. It can also be ranked and duel-only, which makes /duel the only way to gain LP with it.

Categories#

Categories are rows in practice_kit_categories and they exist for one reason: queue, duels, party games, stats, leaderboards, match history and the kit editor all page through categories before they show a kit.

ButtonWhat it does
NameThe label in menus
IconThe material shown
DescriptionLore under the name
StatusA disabled category is hidden everywhere
Manage kitsPick which kits belong to this category
PrioritySort order

Right click a category in the list to delete it. Deleting a category rewrites every kit that named it, so no kit is left pointing at a filter that matches nothing.

Going further#

Compatible arenas#

A kit with no compatible arenas cannot start a match at all: players are told there are no arenas available. A kit with several picks a free instance from any of them, preferring one that is already pasted over cloning a new one.

For a duel the player may name a preferred arena; it is moved to the front of the list and the rest is shuffled behind it, so a preferred arena that is busy still falls back rather than failing.

The loadout#

41 slots: 36 inventory, 4 armour, 1 offhand. Whatever you place is what every player is handed at the start of a match, before their own kit editor slot rearranges it.

Leather armour and coloured blocks are recoloured per team

In a party split or a party duel, the kit is dyed on the way in: leather armour takes the team colour and any block whose material name starts with a Minecraft colour (RED_WOOL, BLUE_CONCRETE, and so on) is swapped for the team's version. Team A is red, team B is blue. In a 1v1 or an FFA nothing is recoloured.

Deleting a kit

Right click the kit in the list and confirm. Deleting removes the row. Player loadouts saved against that kit id in practice_player_kits are not removed by the delete; clear them from Data management → Clear kit loadouts if you want them gone.

Something missing on this page? Tell us on Discord