engine attributes

🧬 Engine Config: attributes

This section controls how Divinity handles item durability, offhand behavior, and whether mobs and players are affected by attribute effects.

---

🔑 Options

Key	Description
durability.break-items-on-zero	Whether items break when durability reaches 0 (like vanilla).
durability.effective-for.mobs	If true, mob equipment is affected by durability usage.
durability.effective-for.skill-api-skills.*	Controls whether casting or using skills applies durability loss.
effective-for-mobs	If true, mobs can use custom damage/defense stats from plugins like MythicMobs.
effective-in-offhand	If true, offhand items can apply attribute effects.
allow-hold-items-you-cant-use	If true, players can hold gear that doesn't meet requirements (but no effects will apply).

---

🧪 Example

attributes:
  durability:
    break-items-on-zero: true
    effective-for:
      mobs: true
      skill-api-skills:
        cast: true
        left_click: true
        right_click: true
        initialize: false
        cleanup: false
  effective-for-mobs: true
  effective-in-offhand: false
  allow-hold-items-you-cant-use: false

---

🧠 Breakdown

• Durability Hooks:
  Skill usage can wear down items if skill-api-skills options are enabled.
  Perfect for servers where durability matters in PvP or combat skill usage.

• Mob Support:
  Mobs can inherit full stat logic if effective-for-mobs is true, including custom defense, damage types, and buffs.

• Offhand Attributes:
  Enables or disables attributes from shields, tomes, or custom offhand tools.

• Holding Restricted Items:
  Setting allow-hold-items-you-cant-use to true lets players hold gear they don’t qualify for, but it will have no stat effect.

---

🔗 Related

• engine-combat – For PvP modifiers and shield behavior
• engine-lore – For formatting durability and requirements visually