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