editor fabled attributes - magemonkeystudio/divinity GitHub Wiki

✨ Editor: Fabled Attributes

The Fabled Attributes option integrates with the Fabled plugin to add scalable RPG-style attributes to generated items. These attributes enhance gear with additional bonuses like Vitality, Spirit, Intelligence, and more β€” all defined through Fabled's system.

🧠 This feature requires the Fabled plugin:

πŸ“ Where Attributes Are Defined

Fabled attributes are defined in:

plugins/Fabled/attributes.yml

The Divinity plugin will automatically detect these attributes and generate the appropriate placeholders for use in item lore.

➑️ See the Fabled Wiki for full configuration details.

βš™οΈ What the Editor Lets You Modify

In the Item Generator Editor:

  • Select which Fabled attributes can roll
  • Set how many attributes roll (min/max)
  • Assign individual roll chances
  • Define value range for each attribute
  • Enable scale-by-level support
  • Use a custom lore-format to define display order

πŸ“„ Example (Item Generator File)

fabled-attributes:
  minimum: 1
  maximum: 4
  lore-format:
    - '%FABLED_ATTRIBUTE_VITALITY%'
    - '%FABLED_ATTRIBUTE_SPIRIT%'
    - '%FABLED_ATTRIBUTE_INTELLIGENCE%'
  list:
    vitality:
      chance: 20.0
      scale-by-level: 1.025
      min: 3.0
      max: 6.25
    spirit:
      chance: 20.0
      scale-by-level: 1.025
      min: 1.1
      max: 1.25
    intelligence:
      chance: 10.0
      scale-by-level: 1.025
      min: 2.5
      max: 4.0
      flat-range: false

🧾 Explanation of Fields

Field Description
minimum / maximum Number of attributes that will roll on the item.
chance % chance for each specific attribute to be selected.
scale-by-level Multiplies the stat value based on the item’s level.
min / max Value range for the attribute if it rolls.
flat-range If true, no randomness β€” a fixed value is used.
lore-format Sets the display order of attributes in item lore.

πŸ”§ Placeholders

%FABLED_ATTRIBUTE_{ATTRIBUTE_NAME}%

These are generated automatically based on the entries in attributes.yml.

Examples:

  • %FABLED_ATTRIBUTE_VITALITY%
  • %FABLED_ATTRIBUTE_INTELLIGENCE%

πŸ§ͺ Use Case

  • Enhance magical gear with RPG-style bonuses
  • Create dynamic item rolls for high-level builds
  • Scale attribute values with item level to support long-term progression

Return to: Item Generator Module