editor damage types - magemonkeystudio/divinity GitHub Wiki
๐ก๏ธ Editor: Damage Types
The Damage Types editor option lets you define what types of damage can roll on an item. These types are fully customizable and defined manually, allowing for effects like Slashing
, Fire
, Arcane
, etc.
๐ Where Damage Types Are Defined
Damage types are defined in:
plugins/Divinity/item_stats/damage.yml
โก๏ธ For setup details, see: item_stats-damage
๐ Example (damage.yml)
physical:
priority: 100
name: Physical Damage
format: ' &7Gives %value% %name%'
attached-damage-causes: {}
on-hit-actions:
- ENTITY_ATTACK
biome-damage-modifier: {}
entity-type-modifier: {}
mythic-mob-faction-modifier:
airwitch: 50
โ๏ธ What the Editor Lets You Modify
In the Item Generator Editor:
- Choose which damage types can roll
- Set individual chances for each type
- Define min/max values for each
- Enable level-scaling
- Control randomization and rounding
- Format output in lore
๐ Example (Item Generator File)
damage-types:
minimum: 1
maximum: 2
lore-format:
- '%DAMAGE_PHYSICAL%'
- '%DAMAGE_WATER%'
- '%DAMAGE_FIRE%'
- ''
- '%DAMAGE_SLASHING%'
- '%DAMAGE_BLUDGEONING%'
list:
physical:
chance: 25.0
scale-by-level: 1.0
min: 2
max: 4
flat-range: false
round: true
fire:
chance: 10.0
scale-by-level: 1.25
min: 1
max: 3
flat-range: false
round: false
๐งพ Explanation of Fields
Field | Description |
---|---|
minimum / maximum |
Total number of damage types that will roll. |
chance |
% chance for this damage type to roll. |
scale-by-level |
Multiplies the value by item level. |
flat-range |
If true, uses a fixed value instead of a range. |
round |
If true, rounds the final number. |
lore-format |
Sets display order of damage types in item lore. |
๐ง Placeholders
%DAMAGE_{TYPE}%
Examples:
%DAMAGE_FIRE%
%DAMAGE_SLASHING%
๐งช Use Case
- Add elemental traits to weapons
- Randomize physical vs. magical damage
- Scale item strength by level
Return to: Item Generator Module