engine attributes - magemonkeystudio/divinity GitHub Wiki

🧬 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