📊 Editor: Item Stats

The Item Stats editor option controls the core RPG stats applied to the item, such as critical rate, movement speed, max health, and more.

This setting is one of the most powerful customization options for stat-heavy equipment, allowing you to define multiple stat rolls with individual chances and level scaling.

---

📁 Where Item Stats Are Defined

Some stat behaviors and labels can be configured in:

plugins/Divinity/item_stats/stats.yml

➡️ See: item_stats-stats

---

⚙️ What the Editor Lets You Modify

In the Item Generator Editor, you can:

• Choose which item stats are allowed to roll
• Set minimum and maximum number of rolled stats
• Set individual chances for each stat
• Define min/max value range per stat
• Enable level-scaling using scale-by-level
• Enable or disable rounding or flat-range
• Customize the order of stat display in the lore

---

📄 Example (Item Generator File)

item-stats:
  minimum: 1
  maximum: 4
  lore-format:
    - '%ITEM_STAT_AOE_DAMAGE%'
    - '%ITEM_STAT_CRITICAL_RATE%'
    - '%ITEM_STAT_CRITICAL_DAMAGE%'
    - '%ITEM_STAT_ACCURACY_RATE%'
    - '%ITEM_STAT_DODGE_RATE%'
    - '%ITEM_STAT_BLOCK_RATE%'
    - '%ITEM_STAT_BLOCK_DAMAGE%'
    - '%ITEM_STAT_LOOT_RATE%'
    - '%ITEM_STAT_MOVEMENT_SPEED%'
    - '%ITEM_STAT_BASE_ATTACK_SPEED%'
    - '%ITEM_STAT_ATTACK_SPEED%'
    - '%ITEM_STAT_MAX_HEALTH%'
    - '%ITEM_STAT_PENETRATION%'
    - '%ITEM_STAT_VAMPIRISM%'
    - '%ITEM_STAT_BURN_RATE%'
    - ''
  list:
    critical_rate:
      chance: 20.0
      scale-by-level: 1.025
      min: 3.0
      max: 6.25
      flat-range: false
      round: false
    critical_damage:
      chance: 20.0
      scale-by-level: 1.025
      min: 1.1
      max: 1.25
      flat-range: false
      round: false

---

🧾 Explanation of Fields

Field	Description
minimum / maximum	Number of item stats that can roll on this item.
chance	% chance that a specific stat will roll.
scale-by-level	Multiplies the rolled value by the item’s level.
min / max	Value range for the stat if it rolls.
flat-range	If true, uses a fixed value instead of a random range.
round	Rounds the result if enabled.
lore-format	Controls the display order of the stats in the lore.

---

🔧 Placeholders

%ITEM_STAT_{STAT_NAME}%

Examples:

• %ITEM_STAT_CRITICAL_RATE%
• %ITEM_STAT_MAX_HEALTH%

---

🧪 Use Case

• Create powerful gear with rare stat combinations.
• Add scaling mechanics to reflect item level.
• Make legendary gear that always rolls specific stats.

---

Return to: Item Generator Module