Kits

Kits determine the equipment (weapons, armor, food, and potions) that players receive at the start of each arena match. Each arena template can offer one or more kit presets for players to choose from.

How Kits Work

1. When a match starts, players are presented with the available kits for that arena.
2. Players select a kit (or get the default one if they don't choose).
3. The kit's items are placed into the player's inventory in the correct slots: hotbar, armor, and utility.
4. Players can change their kit during a match using /arena kit (useful in deathmatch modes with respawns).

Default Kit Presets

ArenaPvP ships with three preset kits:

Default Kit

A balanced loadout with cobalt-tier equipment.

• Weapon: Cobalt Battleaxe
• Armor: Full Cobalt set (Head, Torso, Legs, Feet)
• Consumables: 16× Pumpkin Pie, 8× Lesser Health Potion

Warrior Kit

A melee-focused loadout with thorium-tier equipment.

• Weapon: Thorium Sword
• Shield: Thorium Shield
• Armor: Full Thorium set
• Consumables: 32× Pumpkin Pie, 16× Greater Health Potion

Archer Kit

A ranged loadout with iron-tier equipment.

• Weapon: Iron Sword + Combat Shortbow
• Ammo: 64× Crude Arrows
• Armor: Full Iron set
• Consumables: 16× Pumpkin Pie, 8× Lesser Health Potion

Choosing a Kit

Before the Match

When the match begins, the kit selection UI opens automatically if the template offers multiple kits.

During the Match

In respawn modes (FFADM, TDM, TCTO), you can open the kit selection menu at any time:

• Press O (the gamemode key) to open the kit selection UI.
• Alternatively, use the command: /arena kit

Kit application rules:

• If you select a kit within 5 seconds of respawning, it is applied immediately to your current inventory.
• If you select a kit outside the 5-second window (or before your first death), it is preselected and will be applied on your next respawn.

To select a specific kit directly without opening the UI:

/arena kit warrior-kit

Creating Custom Kits

Server administrators can create new kit presets from their current inventory:

/arena kitcreate <name> <icon>

For example, to create a kit called "mage-kit" with the icon "Mythic":

/arena kitcreate mage-kit Mythic

This captures every item in your current inventory (hotbar, armor, and utility) and saves it as a new .json file in the presets/ directory. The kit will immediately be available to assign to arena templates.

Custom Enchantments

If the Simple Enchantments plugin is installed, any custom enchantments on items in your inventory will be preserved when the kit preset is created and applied.

Kit Item Format

In each preset file (mods/arenapvp/presets/<name>.json), kit items are defined using this format:

ItemId:quantity:zone:slotIndex

Part	Description	Examples
ItemId	The Hytale item identifier	Weapon_Battleaxe_Cobalt, Food_Pie_Pumpkin
quantity	How many items to give	1, 16, 64
zone	Inventory zone	hotbar, armor, utility
slotIndex	Slot position (0-based)	0 through 9

Example preset file presets/my-kit.json:

{
  "Icon": "MyIcon",
  "Items": [
    "Weapon_Sword_Thorium:1:hotbar:0",
    "Food_Pie_Pumpkin:32:hotbar:1",
    "Armor_Thorium_Head:1:armor:0",
    "Armor_Thorium_Torso:1:armor:1",
    "Armor_Thorium_Legs:1:armor:2",
    "Armor_Thorium_Feet:1:armor:3"
  ]
}

Assigning Kits to Arenas

In the arena template file's Presets array, list the preset names you want available:

templates/1vs1-CUSTOM.json:

{
  "Prefab": "arena_2FFA.prefab",
  "MaxPlayers": 2,
  "Type": "FFA",
  "TimeLimit": 180,
  "Presets": ["default-kit", "warrior-kit", "my-kit"]
}

If a template has no presets, players will keep their current inventory (not recommended for competitive play).