Content generated with AI — it may contain mistakes.

ExyliaEvents/GuidesUpdated in v1.11.0

Teams, kits and loot

Hand every player the same kit, balance teams, and fill chests from a loot table.

Page 6 of 257 min read

By the end of this page an event hands every player a kit you saved from your own inventory, team games split players fairly, and chest games fill their chests from a loot table you control.

Before you start#

  • An event configuration exists. See Your first event.
  • Build the kit in your own inventory first: items, armour and offhand are saved exactly as you carry them.

Steps#

Open the kit list

Run /eventsadmin, click Configurations, open your event and click Manage kits.

Create the kit

Click Create kit and type a name in chat. The kit appears in the list.

Save your inventory into it

Left-click the kit. Your current inventory, armour and offhand become its contents. Shift + left-click renames it, shift + right-click gives it to you to check, right-click deletes it (after a confirmation).

Check that it works#

Start the event as a player with /events start <id> and join. Everyone should receive the kit when the game starts. With two or more kits, the player who starts the event picks one from a menu first. See Kits.

Going further#

Teams, the PracticeCore link and loot tables are below.

Teams#

Fourteen types are team games: the eight _teams variants — Top Killer, OITC, Quake, CS:GO, LMS, Gem Crawler, Thimble and King of the Hill — and six games that are team games in their own right: The Bridge, Capture the Flag, Domination, Dodgeball, Sheep Wars and Splatoon.

Eight colours are available, handed out in this order:

Team colours
TeamChat colourWool
Red&cRED_WOOL
Blue&9BLUE_WOOL
Green&aGREEN_WOOL
Yellow&eYELLOW_WOOL
Orange&6ORANGE_WOOL
Purple&5PURPLE_WOOL
Cyan&bCYAN_WOOL
Pink&dPINK_WOOL

Team names come from messages.yml, so they translate along with the rest of the plugin.

Telling teams apart#

Every team type dresses its players in unbreakable leather armour dyed their team's colour, and draws their names in that colour too — in the world, in the tab list and with %rel_exyliaevents_team_color% wherever a nametag plugin uses it. A kit is worn over the colours rather than instead of them: any armour slot the kit leaves empty keeps the team's piece.

Picking a team#

With team-selector-enabled on — the default for every team type — players get a selector item in the lobby and choose their own team. The item is a compass in the last hotbar slot (slot 9, index 8); only its name is configurable, in messages.yml. A lobby-item, hotbar or per-world inventory plugin that writes to that slot replaces it, and players then have no way to pick a team.

Before the game starts the teams are rebalanced: anyone who did not pick lands in the smallest team, and players are moved until no team is more than one player larger than another.

Turn the selector off for random teams

Setting team-selector-enabled to false skips the choosing entirely — everyone is assigned by the balancer, which is what you want for a tournament-style event where stacking one team would ruin it.

How many teams#

Every team type reads team-count, defaulting to 2 and never lower, so a four-colour ink war or a three-way Domination is a setting rather than a different type.

How spawn points are shared out#

Spawn points keep the order you set them in and are cut into one contiguous block per team: twenty-four points and two teams means the first twelve are one side of the map and the last twelve the other. A team always starts together and never inside the enemy base.

The remainder of an uneven split goes to the last team, and fewer points than teams falls back to teams sharing a point rather than nobody spawning. That is why validation asks for at least one point per team.

Per-team markers — The Bridge's goal, CTF's stand, Dodgeball's court — follow the same team-count: see Arenas · Markers.

Kits#

Kits belong to a configuration and are edited from the kit list in the admin panel. Each one stores a full inventory, armour and offhand, exactly as you had them when saving.

Kit fields
FieldWhat it is
idInternal identifier
configIdThe configuration it belongs to
nameWhat the selector shows
iconMaterialThe icon in the selector
ContentsInventory, armour and offhand

The kit is chosen once per event, not per player: every player gets the same kit when the game starts. Players never pick their own.

Brackets and Tournament can draw it instead, once per round or once per match, from the configuration's kits; the starter is then not asked to pick one. See Event types · Kit mode.

Kits in the configurationStarted by a player (/events start, start menu)Started without a player (console, scheduler, gauntlet, network)
NoneNo kitNo kit
OneThat kitThat kit
Two or moreThe starter picks one from a menu before the event opensNo kit

With no kit, a type that has a default-kit setting (CTF, for example) hands out its built-in gear while that setting is true, and only the team outfit when it is false. CS:GO gives its own loadout, since its weapons are its own system.

Console starts need a single kit

To start a kitted event from the console or a schedule, leave exactly one kit in the configuration. With two or more, only a player can choose which one is used.

PracticeCore kits#

With ExyliaPracticeCore installed, PracticeCore kits on the kit list opens every enabled PracticeCore category and kit, and a click links one to the configuration or unlinks it. A link stores only the reference, so the event always hands out the kit as it is in PracticeCore right now; a kit or category that is disabled or deleted there simply drops out.

  • A linked kit counts as one kit of the configuration. A linked category counts as every enabled kit in it, so the table above, the kit picker and the kit mode draws treat each of them as a kit of their own.
  • A player gets their own PracticeCore layout of the kit when they saved one, then the kit's effects, attributes and start values.
  • The kit's rules hold for whoever fights with it. Fall damage, health regeneration, hunger and the ender pearl and golden apple cooldowns follow the kit. Building, breaking, dropping and picking up belong to the game when its own rules allow them (a spleef breaks blocks whatever the kit says); otherwise the kit decides, and a kit that allows them does so only inside a PracticeCore arena copy, since only a copy is regenerated afterwards.

Without PracticeCore the button says it is missing, and existing links resolve to nothing.

Loot tables#

Edit the table from the event's setup screen: Type settings, then Loot table (shown on the Survival Games settings).

Chest-based types — Survival Games above all — fill their chests from the configuration's loot table rather than from vanilla tables.

Loot entry fields
FieldWhat it does
ItemThe stack itself, with its own name, enchantments and lore
weightHow likely this entry is relative to the others
minAmount / maxAmountThe stack size range rolled per pick
tierA label, so an entry can belong to a rarity band

Survival Games decides how much lands in each chest with its own settings:

min-items-per-chest: 3
max-items-per-chest: 12
chest-refill-interval: 180

A minimum above the maximum is read as the maximum, so a chest still fills instead of the range being rejected.

Chest locations inside the arena bounds are scanned and cached on the configuration, so a chest added to the map is picked up when the arena is scanned again.

Weights are relative, not percentages

An entry with weight 10 next to one with weight 5 is drawn twice as often. The numbers do not need to add up to anything in particular.

Something missing on this page? Tell us on Discord