Kits

Create Duels kits, set their items, combat system and game type, and turn on rule flags such as rounds, building and void deaths.

How kits work

A kit is the loadout and rule set for a match. Every kit has an id, a display name, an icon, its items, a combat system, a game type and a list of flags.

Kits are stored in MongoDB and shared by every Duels server. A change on one server reaches the others straight away.

You can build kits with commands or with the menu from /duels editor. Both need duels.admin. Kit commands work on the lobby and on game servers.

Create a kit

Create it

Run /kit create <id>. The id is 1 to 32 characters: lowercase letters, digits, _ and -.

A new kit is enabled straight away. Run /kit toggle <kit> to hide it from players while you set it up, and again when it is ready.

Set its items

Put the items in your own inventory, armour slots, offhand and ender chest, then run /kit inventory setcontents <kit>. All four are saved.

/kit inventory getcontents <kit> gives you the saved items back. /kit enderchest <kit> edits only the ender chest.

Name it and give it an icon

/kit displayname <kit> <name> sets the name players see. Colour codes work.
/kit seticon <kit> uses the item in your hand, with its potion type and enchantments.
/kit seticon-typed <kit> <material> [potion] [enchant:level ...] sets the icon without holding it.
/kit description add <kit> <line> adds a description line. /kit description clear <kit> removes them all.
/kit weight <kit> <weight> sets the order in menus. Higher weights are listed first.

Pick the combat system

/kit system <kit> <system> takes MODERN or LEGACY.

MODERN is normal 1.21 combat. Modern kits are hidden from players on clients older than 1.21.
LEGACY removes the attack cooldown for the match.

New kits are MODERN.

Pick the game type

/kit lifecycle <kit> <lifecycle> sets how a match is won. Some flags only work with some game types. Changing the game type removes flags that no longer fit and tells you which ones.

Game type	Value
Soul Bound	`SoulBound` (default)
Round Bound	`RoundBound`
Objective Bound	`ObjectiveBound`
Objective + Soul Bound	`ObjectivePlusSoulBound`

Add flags

Add the rules you want with /kit features add <kit> <flag>. See the table below.

Flags

Manage flags with these commands:

/kit features add <kit> <flag> and /kit features remove <kit> <flag>
/kit features list <kit>
/kit features metadata add <kit> <flag> <key> <value> changes a setting of a flag.
/kit features metadata remove <kit> <flag> <key> puts that setting back to its default.
/kit features metadata list <kit> <flag>

/kit info <kit> shows everything about a kit, including its flags and their settings.

Adding a flag fails if it clashes with a flag the kit already has, or if it needs another flag first.

Queues and arenas

Flag	Settings (default)	What it does
`QueueSizes`	`sizes` (`1:casual+ranked`)	Which team sizes and queue types the kit appears in. See Queues and ranked. A kit without this flag uses the default.
`VanillaTerrain`	`border` (`100`)	The kit plays on generated vanilla arenas. `border` is the world border width in blocks. See Arenas.
`NewlyCreated`	none	Shows a "new" tag next to the kit in menus.

Combat and health

Flag	Settings (default)	What it does
`SpawnProtection`	`time` (`3`)	Players cannot be hurt for this many seconds after spawning.
`DoNotTakeDamage`	`doDamageTick` (`false`)	Players lose no health.
`DoNotTakeFallDamage`	none	No fall damage.
`DoNotTakeHunger`	none	No hunger loss.
`HardcoreHealing`	none	No natural health regeneration.
`HeartsBelowNameTag`	none	Shows every player's health under their name tag, with health notices on the hotbar.
`StartingEffects`	`effects` (`speed:2:infinite`)	Potion effects applied at the start of the match and of each round. Comma-separated `effect:level:seconds`; seconds can be `infinite`.
`FrozenOnGameStart`	none	Players cannot move at the start of a match.
`FlyOnWin`	none	The winner can fly after the match. Cannot be combined with `SpectateAfterDeath`.

Items

Flag	Settings (default)	What it does
`PreventDropAnyItems`	none	Players cannot drop items.
`DoNotDropInventoryOnDeath`	none	Nothing drops when a player dies.
`DoNotRemoveArmor`	none	Players cannot take their armour off.
`EditorPool`	`pool` (`kit`), `exclude`, `allow`, `totems` (`0`)	What players may put in their layout. `kit` only allows rearranging the kit's items; `survival` allows anything obtainable. `exclude` bans more materials or potion types, `allow` permits items that are banned by default, `totems` caps totems per layout (`0` for no cap).

Deaths

Flag	Settings (default)	What it does
`DeathBelowYAxis`	`level` (`95`)	A player who falls below this Y level is out.
`DeathOnLiquidInteraction`	none	A player who touches water or lava is out.

Building

Flag	Settings (default)	What it does
`PlaceBlocks`	none	Players can place blocks.
`BuildLimit`	`blocks` (`16`)	Players cannot build more than this many blocks above the first team's spawn. Needs `PlaceBlocks`.
`ExpirePlacedBlocksAfterNSeconds`	`time` (`10`), `return` (`false`)	Placed blocks disappear after `time` seconds. With `return: true` they go back to the player. Needs `PlaceBlocks`.
`BlockRefund`	none	Broken placed blocks go back to the player who placed them.
`DoNotDropBrokenBlocks`	none	Broken blocks do not drop.
`ExplodePlacedBlocks`	none	Explosions can remove placed blocks.
`RequiresBuildMap`	none	Marks a building kit. The three break flags below need it.
`BreakAllBlocks`	none	Players can break any block.
`BreakPlacedBlocks`	none	Players can break blocks placed during the match.
`BreakSpecificBlockTypes`	`types` (`LIGHT_BLUE_TERRACOTTA,RED_TERRACOTTA`)	Players can break these block types even if no one placed them.

Rounds and respawns

These need the Round Bound game type unless noted.

Flag	Settings (default)	What it does
`RoundsRequiredToCompleteGame`	`value` (`2`)	Rounds a team must win to win the match.
`CountDownTimeBeforeRoundStart`	`value` (`5`)	Countdown before each round, in seconds.
`StartNewRoundOnDeath`	none	A death ends the round.
`StartNewRoundOnPortalEnter`	none	Entering a portal ends the round.
`RemovePlacedBlocksOnRoundStart`	none	Placed blocks are cleared when a new round starts.
`SpectateAfterDeath`	none	A player who dies spectates for a while. Works with Round, Objective and Objective + Soul Bound kits.
`TimeUserSpectatesAfterDeath`	`value` (`3`)	How long they spectate, in seconds. Needs `SpectateAfterDeath`.

Objectives and achievements

Flag	Settings (default)	What it does
`WinWhenNHitsReached`	`hits` (`100`)	The first player to land this many hits wins. Needs the Objective Bound or Objective + Soul Bound game type.
`Achievements`	`extra`, `exclude`	Which achievement groups the kit shows. Groups are picked from the kit's items; `extra` forces tags on and `exclude` forces them off.

Player layouts

Run /kit editable <kit> to let players save their own layout of a kit. It is off for new kits. Players open the editor with /kiteditor or the kit editor item on the lobby hotbar. EditorPool controls what they may add.

Command	What it does
`/kitcategory list`	Lists every category.
`/kitcategory create <id>`	Creates a category.
`/kitcategory delete <category>`	Deletes a category.
`/kitcategory name <category> <name>`	Sets the display name.
`/kitcategory icon <category> <material>`	Sets the icon.
`/kitcategory color <category> <color>`	Sets the colour the category and its kits are shown in.
`/kitcategory weight <category> <weight>`	Sets how early the category is listed.
`/kitcategory add <category> <kit>`	Puts a kit in the category.
`/kitcategory remove <category> <kit>`	Takes a kit out.

Tiers and trims

Staff can give a player a tier per kit with /tier set <player> <kit> <tier>, or pick one from a menu with /tier grant <player>. A tier is LT, MT or HT followed by 1 to 5, for example HT3. HT1 is the highest and LT5 the lowest.

The player's tier for a kit unlocks armour trims in that kit's editor:

Unlock	Needs
Iron	`LT4`
Copper	`LT3`
Quartz	`HT4`
Lapis	`LT2`
Emerald	`HT3`
Gold	`LT1`
Diamond	`HT1`
Amethyst	A top 50 place on the overall wins leaderboard
Coast, dune, host, raiser, rib, sentry, shaper, snout, wayfinder and wild patterns	Any unlocked trim material
Vex, ward, eye, tide, spire, flow and bolt patterns	`HT2`
Silence pattern	`MT1`

/tier list <player> shows a player's tiers and /tier remove <player> <kit> clears one.