📊 Editor: Item Stats

The Item Stats editor option lets you define what flat stats an item will roll when generated. These stats include things like Critical Rate, Vampirism, Accuracy, and more — all of which can be customized and scaled by item level.

---

📁 Where Item Stats Are Defined

Many core stat properties — such as formatting, scaling behavior, and display names — can be configured globally in:

plugins/Divinity/item_stats/stats.yml

➡️ For full customization details, see: item_stats-stats

The editor controls how these predefined stats are used and generated on specific items.

---

⚙️ What the Editor Lets You Modify

From the Item Generator Editor, you can:

• Select one or more item stats to roll.
• Define the chance (%) that each stat appears.
• Set a min/max range for the stat's base value.
• Enable level scaling for each stat individually.
• Choose to round the final value or keep decimals.
• Control the lore-format for display.

---

📄 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	Total number of stats that will roll.
chance	% chance for this specific stat to roll.
scale-by-level	Multiplies the value by item level.
flat-range	If true, uses the raw value without randomness.
round	If true, rounds the final value.
lore-format	Defines the placeholder order shown in the lore.

---

🔧 Placeholders

Use this format in your lore-format:

%ITEM_STAT_{STAT_NAME}%

Examples:

• %ITEM_STAT_CRITICAL_RATE%
• %ITEM_STAT_ATTACK_SPEED%
• %ITEM_STAT_LOOT_RATE%

These are auto-generated based on your stats.yml configuration.

---

🧪 Use Case

• Create stat-scaling weapons without needing many separate item files.
• Balance early- and late-game gear using scale-by-level.
• Allow multiple types of stat bonuses to randomly appear on items.

---

Return to: Item Generator Module