Equipment Sets

Overview

Equipment sets are collections of gear pieces that share common characteristics like level, rarity, and stat computation formulas. DatasheetLang supports inline equipment blocks within item definitions and computed stats that automatically calculate appropriate values based on item properties.

How Computation Works

The computed: true flag tells the system to automatically calculate equipment stats rather than requiring manual specification. When enabled, you provide a formula reference that determines how stats are derived:

equipment:
  computed: true
  compute:
    formula: "standard"

The formula considers the item’s level, category, and rarity to produce balanced stat values. This eliminates manual stat entry and ensures consistency across equipment pieces.

Inline Equipment Blocks

Items can include their equipment definitions directly within the item declaration using the equipment: block. This keeps related data together and simplifies set creation:

items:
  create:
    - id: 99001
      name: "iron_chest"
      level: 60
      category: bodyMail

      equipment:
        computed: true
        compute:
          formula: "standard"

The inline block is processed and linked to the item automatically during compilation.

Note

Equipment items (EQUIP_* combat types) receive automatic soft defaults for common fields like maxStack, dropSound, icon, dropSilhouette, and equipSound. You only need to specify fields where the default doesn’t apply. See Item Template — Equipment Item Defaults for the full list.

Creating a Set

For consistent armor sets, follow this approach:

1. Define shared properties (level, rarity, formula) across all pieces
2. Vary only the slot-specific fields: id, name, category, combatItemType
3. Use computed stats to ensure balanced scaling

Example

A level 60 uncommon armor set with chest, gloves, and boots:

spec:
  version: "1.0"

items:
  create:
    # Chest piece
    - id: 99001
      name: "iron_chest"
      level: 60
      category: bodyMail
      combatItemType: EQUIP_ARMOR_BODY
      rareGrade: Uncommon

      equipment:
        computed: true
        compute:
          formula: "standard"

      strings:
        name: "Iron Chestplate"
        toolTip: "Sturdy iron armor."

    # Gloves
    - id: 99002
      name: "iron_gloves"
      level: 60
      category: handMail
      combatItemType: EQUIP_ARMOR_ARM
      rareGrade: Uncommon

      equipment:
        computed: true
        compute:
          formula: "standard"

      strings:
        name: "Iron Gauntlets"
        toolTip: "Protective iron gloves."

    # Boots
    - id: 99003
      name: "iron_boots"
      level: 60
      category: feetMail
      combatItemType: EQUIP_ARMOR_LEG
      rareGrade: Uncommon

      equipment:
        computed: true
        compute:
          formula: "standard"

      strings:
        name: "Iron Greaves"
        toolTip: "Heavy iron boots."

Each piece shares the same level (60), rarity (Uncommon), and computation formula (standard), but differs in slot category and combat item type. The computed stats will vary appropriately based on each armor slot’s characteristics.

See Also

• Equipment Computation - Details on stat formulas and computation
• Equipment Template Schema - Full schema reference for equipment definitions