🧱 Config: Item Definitions

This page covers item categorization settings used across Divinity modules. These settings define how materials are grouped and labeled for use in systems like socketing, fortifying, drops, and more.

---

🛠️ item-sub-types

Defines individual item sub-types like sword, helmet, or shovel, each mapped to a list of Minecraft materials. These are used internally by many modules to determine which types of items are eligible for a mechanic.

🔑 Format

Key	Description
name	Human-readable label for the sub-type.
materials	A list of Bukkit material names under that sub-type.

🧪 Example

item-sub-types:
  sword:
    name: Sword
    materials:
      - WOODEN_SWORD
      - STONE_SWORD

📌 Full Default Config

item-sub-types:
  axe:
    name: Axe
    materials:
      - WOODEN_AXE
      - GOLDEN_AXE
      - IRON_AXE
      - DIAMOND_AXE
      - STONE_AXE
      - NETHERITE_AXE
  sword:
    name: Sword
    materials:
      - WOODEN_SWORD
      - GOLDEN_SWORD
      - IRON_SWORD
      - DIAMOND_SWORD
      - STONE_SWORD
      - NETHERITE_SWORD
  shears:
    name: Shears
    materials:
      - SHEARS
  shovel:
    name: Shovel
    materials:
      - WOODEN_SHOVEL
      - GOLDEN_SHOVEL
      - IRON_SHOVEL
      - DIAMOND_SHOVEL
      - STONE_SHOVEL
      - NETHERITE_SHOVEL
  pickaxe:
    name: Pickaxe
    materials:
      - WOODEN_PICKAXE
      - GOLDEN_PICKAXE
      - IRON_PICKAXE
      - DIAMOND_PICKAXE
      - STONE_PICKAXE
      - NETHERITE_PICKAXE
  hoe:
    name: Hoe
    materials:
      - WOODEN_HOE
      - GOLDEN_HOE
      - IRON_HOE
      - DIAMOND_HOE
      - STONE_HOE
      - NETHERITE_HOE
  helmet:
    name: Helmet
    materials:
      - GOLDEN_HELMET
      - IRON_HELMET
      - DIAMOND_HELMET
      - CHAINMAIL_HELMET
      - LEATHER_HELMET
      - TURTLE_HELMET
      - NETHERITE_HELMET
  chestplate:
    name: Chestplate
    materials:
      - GOLDEN_CHESTPLATE
      - IRON_CHESTPLATE
      - DIAMOND_CHESTPLATE
      - CHAINMAIL_CHESTPLATE
      - LEATHER_CHESTPLATE
      - NETHERITE_CHESTPLATE
  leggings:
    name: Leggings
    materials:
      - GOLDEN_LEGGINGS
      - IRON_LEGGINGS
      - DIAMOND_LEGGINGS
      - CHAINMAIL_LEGGINGS
      - LEATHER_LEGGINGS
      - NETHERITE_LEGGINGS
  boots:
    name: Boots
    materials:
      - GOLDEN_BOOTS
      - IRON_BOOTS
      - DIAMOND_BOOTS
      - CHAINMAIL_BOOTS
      - LEATHER_BOOTS
      - NETHERITE_BOOTS
  elytra:
    name: Elytra
    materials:
      - ELYTRA
  shield:
    name: Shield
    materials:
      - SHIELD
  bow:
    name: Bow
    materials:
      - BOW
  crossbow:
    name: Crossbow
    materials:
      - CROSSBOW
  fishing_rod:
    name: Fishing Rod
    materials:
      - FISHING_ROD
  trident:
    name: Trident
    materials:
      - TRIDENT

---

🧩 item-groups

Groups related item materials under broader categories like WEAPON, TOOL, or ARMOR. These are used in modules for filtering, requirement checks, and behavior targeting.

🔑 Format

Key	Description
name	Display label for the group.
materials	A list of materials belonging to the group.

🧪 Example

item-groups:
  WEAPON:
    name: Weapon
    materials:
      - WOODEN_SWORD
      - IRON_AXE

📌 Full Default Config

item-groups:
  WEAPON:
    name: Weapon
    materials:
      - WOODEN_SWORD
      - WOODEN_AXE
      - STONE_SWORD
      - STONE_AXE
      - GOLDEN_SWORD
      - GOLDEN_AXE
      - IRON_SWORD
      - IRON_AXE
      - DIAMOND_SWORD
      - DIAMOND_AXE
      - NETHERITE_SWORD
      - NETHERITE_AXE
      - SHEARS
      - FISHING_ROD
      - BOW
      - CROSSBOW
      - TRIDENT
  TOOL:
    name: Tool
    materials:
      - WOODEN_HOE
      - WOODEN_AXE
      - WOODEN_SHOVEL
      - WOODEN_PICKAXE
      - STONE_HOE
      - STONE_AXE
      - STONE_SHOVEL
      - STONE_PICKAXE
      - GOLDEN_HOE
      - GOLDEN_AXE
      - GOLDEN_SHOVEL
      - GOLDEN_PICKAXE
      - IRON_HOE
      - IRON_AXE
      - IRON_SHOVEL
      - IRON_PICKAXE
      - DIAMOND_HOE
      - DIAMOND_AXE
      - DIAMOND_SHOVEL
      - DIAMOND_PICKAXE
      - NETHERITE_HOE
      - NETHERITE_AXE
      - NETHERITE_SHOVEL
      - NETHERITE_PICKAXE
      - SHEARS
      - FISHING_ROD
  ARMOR:
    name: Armor
    materials:
      - LEATHER_HELMET
      - LEATHER_CHESTPLATE
      - LEATHER_LEGGINGS
      - LEATHER_BOOTS
      - GOLDEN_HELMET
      - GOLDEN_CHESTPLATE
      - GOLDEN_LEGGINGS
      - GOLDEN_BOOTS
      - CHAINMAIL_HELMET
      - CHAINMAIL_CHESTPLATE
      - CHAINMAIL_LEGGINGS
      - CHAINMAIL_BOOTS
      - IRON_HELMET
      - IRON_CHESTPLATE
      - IRON_LEGGINGS
      - IRON_BOOTS
      - DIAMOND_HELMET
      - DIAMOND_CHESTPLATE
      - DIAMOND_LEGGINGS
      - DIAMOND_BOOTS
      - NETHERITE_HELMET
      - NETHERITE_CHESTPLATE
      - NETHERITE_LEGGINGS
      - NETHERITE_BOOTS
      - SHIELD
      - ELYTRA
      - TURTLE_HELMET

---

💬 Notes

• Sub-types and groups are referenced throughout the plugin to apply filters or matching logic.
• You can freely define your own categories (e.g., MAGIC_WANDS) to suit your custom items.
• Conflicts are avoided by using separate item-sub-types and item-groups keys.