Inventory Presets

Inventory presets (kits) define the equipment players receive in arenas. Each preset is stored as an individual JSON file inside the mods/arenapvp/presets/ directory.

The filename (without .json) is the preset name — there is no key name inside the file.

File Location

mods/arenapvp/presets/
  default-kit.json
  warrior-kit.json
  archer-kit.json

Preset Structure

Each preset file contains an Icon and an Items array:

{
  "Icon": "IconName",
  "Items": [
    "ItemId:quantity:zone:slotIndex",
    "ItemId:quantity:zone:slotIndex"
  ]
}

Fields

Field	Description
Icon	Icon filename (without extension) displayed in the kit selection UI. Must match a file at Common/UI/Presets/Backgrounds/{Icon}.png
Items	Array of item strings in the format described below

Available Icons

The following icons are bundled with the plugin (located in Common/UI/Presets/Backgrounds/):

Icon	Icon	Icon
Abyssal	Avian	Critter
Elemental	Feran	Fiend
Freshwater	Goblin	Kweebec
Livestock	Mythic	Outlander
Predator	Reptile	Scarak
Trork	Undead	Voidspawn
Voidtaken

Item Format

Each item string uses this format:

ItemId:quantity:zone:slotIndex

Part	Description	Values
ItemId	Hytale item identifier	e.g. Weapon_Sword_Thorium, Food_Pie_Pumpkin
quantity	Number of items	1 to 64
zone	Inventory zone	hotbar, armor, utility
slotIndex	Slot position (0-based)	0 through 9

Inventory Zones

Zone	Slots	Description
hotbar	0–9	The bottom action bar, slot 0 is leftmost
armor	0–3	Armor slots: 0 = head, 1 = chest, 2 = legs, 3 = feet
utility	0–3	Utility / accessory slots

Default Presets

If the presets/ directory is empty on first launch, ArenaPvP generates three default preset files automatically.

default-kit.json

{
  "Icon": "Feran",
  "Items": [
    "Weapon_Battleaxe_Cobalt:1:hotbar:0",
    "Food_Pie_Pumpkin:16:hotbar:1",
    "Potion_Health_Lesser:8:hotbar:2",
    "Armor_Cobalt_Head:1:armor:0",
    "Armor_Cobalt_Torso:1:armor:1",
    "Armor_Cobalt_Legs:1:armor:2",
    "Armor_Cobalt_Feet:1:armor:3"
  ]
}

warrior-kit.json

{
  "Icon": "Goblin",
  "Items": [
    "Weapon_Sword_Thorium:1:hotbar:0",
    "Food_Pie_Pumpkin:32:hotbar:1",
    "Potion_Health_Greater:16:hotbar:2",
    "Armor_Thorium_Head:1:armor:0",
    "Armor_Thorium_Torso:1:armor:1",
    "Armor_Thorium_Legs:1:armor:2",
    "Armor_Thorium_Feet:1:armor:3",
    "Shield_Thorium:1:utility:0"
  ]
}

archer-kit.json

{
  "Icon": "Trork",
  "Items": [
    "Weapon_Sword_Iron:1:hotbar:0",
    "Weapon_Shortbow_Combat:1:hotbar:1",
    "Ammo_Arrow_Crude:64:hotbar:2",
    "Food_Pie_Pumpkin:16:hotbar:3",
    "Potion_Health_Lesser:8:hotbar:4",
    "Armor_Iron_Head:1:armor:0",
    "Armor_Iron_Torso:1:armor:1",
    "Armor_Iron_Legs:1:armor:2",
    "Armor_Iron_Feet:1:armor:3"
  ]
}

Creating Presets In-Game

The fastest way to create a preset is to equip the items you want in your inventory, then run:

/arena kitcreate <name> <icon>

This captures your full inventory and saves it as a new .json file in the presets/ directory. The preset is available immediately — no server restart needed.

tip

Use this method when you have items with custom enchantments from the Simple Enchantments plugin. The enchantment data is preserved automatically.