Skip to main content
loot.yml controls the drops and rewards that elites leave behind when defeated. This includes their equipped gear, vanilla loot multipliers, custom drop tables, and loot templates.

​
Equipment Drops

Elites have a chance to drop the gear they are wearing. Each slot rolls independently. 
Loot:
  dropWeaponChance: 0.05
  dropArmorPieceChance: 0.05
  dropOffhandItemChance: 0.05
SettingWhat it doesDefault
dropWeaponChanceChance for the elite to drop its main-hand weapon.0.05 (5%)
dropArmorPieceChanceChance for each armor piece to drop individually.0.05 (5%)
dropOffhandItemChanceChance for the off-hand item (shield, torch) to drop.0.05 (5%)
Tip: If you want equipment drops to feel special and rare, keep these low. If you want a more generous loot experience, raise them to 0.15 or higher.

​
Dropped Gear Durability

Controls the condition of equipment dropped by elites on death. These values can be overridden per-world via the overlay system. 
Loot:
  droppedGearDurabilityMin: 0.02
  droppedGearDurabilityMax: 0.30
SettingWhat it doesDefault
droppedGearDurabilityMinMinimum durability fraction for dropped gear.0.02 (2%)
droppedGearDurabilityMaxMaximum durability fraction for dropped gear.0.30 (30%)

​
Vanilla Loot Extra Rolls

Higher-tier elites roll the mob’s vanilla drop table additional times, dropping more of their standard loot (bones, rotten flesh, etc.). 
Loot:
  vanillaDroplistExtraRollsPerTier:
    - 0  # Tier 1  -  no extra drops
    - 0  # Tier 2  -  no extra drops
    - 2  # Tier 3  -  2 extra rolls
    - 4  # Tier 4  -  4 extra rolls
    - 6  # Tier 5  -  6 extra rolls
A value of 0 means the mob drops its normal vanilla amount (no extra rolls). A value of 4 means the vanilla drop table is rolled 4 additional times.

​
Extra Drops

Custom items that only drop from elites of specific tiers. This is where you add crafting materials, potions, gems, and other rewards. 
Loot:
  extraDrops:
    - itemId: "Ingredient_Life_Essence"
      chance: 1.0
      enabledPerTier: [false, false, true, true, false]
      minQty: 11
      maxQty: 21

    - itemId: "Ore_Mithril"
      chance: 0.15
      enabledPerTier: [false, false, false, true, true]
      minQty: 1
      maxQty: 5
FieldWhat it does
itemIdThe Hytale item identifier to drop.
chanceDrop probability from 0.0 (never) to 1.0 (always).
enabledPerTierBoolean array [T1..T5]. true means this drop can come from elites of that tier.
minQtyMinimum stack size when dropped.
maxQtyMaximum stack size when dropped.
The default configuration includes a progression of crafting materials: copper and iron ores from early tiers, cobalt and thorium from mid tiers, and mithril, onyxium, adamantite, gems, and potions from the highest tiers.

​
Loot Templates

Loot templates are named collections of drop rules that can be linked to specific mob rules. When an elite dies, RPGMobs checks if any loot template’s linked mob rules include the elite’s matched rule key. If a match is found, the template’s drops are rolled in addition to the base extra drops. 
Loot:
  lootTemplates:
    "Per Tier":
      linkedMobRuleKeys:
        - "category:All"
      drops:
        - { itemId: "Ore_Copper", chance: 0.3, enabledPerTier: [true, true, false, false, false], minQty: 1, maxQty: 3 }
        - { itemId: "Ore_Iron", chance: 0.2, enabledPerTier: [false, true, true, false, false], minQty: 1, maxQty: 3 }
        - { itemId: "Ore_Mithril", chance: 0.1, enabledPerTier: [false, false, false, true, true], minQty: 1, maxQty: 2 }
FieldWhat it does
linkedMobRuleKeysList of mob rule keys and category:* keys. When an elite’s matched rule key appears in this list, these drops are eligible.
dropsList of extra drop rules (same format as base extra drops, with itemId, chance, enabledPerTier, minQty, maxQty).

​
Linking

  • Individual mob keys: "Goblin_Duke" targets that specific mob rule.
  • Category keys: "category:Goblins" targets all mob rules in the Goblins category.

​
Per-World Overlays

Overlays can define their own loot templates. The defaultLootTemplate overlay field assigns a fallback template, and lootOverrides can map specific mob rule keys to specific templates. Loot templates can be managed through the Admin UI in the Loot tab.