editor lore format - magemonkeystudio/divinity GitHub Wiki

📜 Editor: Lore Format

The Lore Format option defines how the item’s final lore (tooltip text) is structured during generation. This is done using a custom template where you insert placeholders to control the layout, style, and content.

How to Use

  • Click the Lore Format icon in the editor.
  • Enter one line per lore entry.
  • Include any combination of supported placeholders and color codes.
  • Confirm to save your layout.

Default Supported Placeholders

Placeholder Inserts...
%BASE_LORE% Plugin-provided lore (Oraxen, ItemsAdder, Nexo)
%TIER_NAME% The display name of the item’s tier
%ITEM_LEVEL% The generated level of the item
%ITEM_AMMO% Allowed ammo types
%ITEM_HAND% Allowed hand types
%ENCHANTS% Enchantments
%USER_CLASS% Allowed player classes
%USER_BANNED_CLASS% Banned player classes
%USER_LEVEL% Required player level
%ITEM_SET% Item set information (if applicable)
%GENERATOR_SKILLS% Skill-based effects
%GENERATOR_DEFENSE% Defense type info
%GENERATOR_DAMAGE% Damage type info
%GENERATOR_STATS% All generated stat lines
%GENERATOR_FABLED_ATTR% Fabled Attributes (if used)
%GENERATOR_SOCKETS_GEM% Gem socket line(s)
%GENERATOR_SOCKETS_ESSENCE% Essence socket line(s)
%GENERATOR_SOCKETS_RUNE% Rune socket line(s)

%BASE_LORE% is only available when using plugin-based materials from Oraxen, ItemsAdder, or Nexo.


Example

%BASE_LORE%
'&7Tier: %TIER_NAME%'
'&7Level: &f%ITEM_LEVEL%'
''
'%GENERATOR_STATS%'
'%GENERATOR_DEFENSE%'
'%GENERATOR_DAMAGE%'
''
'%GENERATOR_SOCKETS_GEM%'
'%GENERATOR_SOCKETS_ESSENCE%'
'%GENERATOR_SOCKETS_RUNE%'
'%GENERATOR_FABLED_ATTR%'

This results in a formatted lore layout including:

  • Plugin-defined base lore
  • Tier and level
  • Stat and damage types
  • Socketed effects and fabled attributes

Tips

  • Default placeholders are automatically colored based on your config.yml and engine.yml. You do not need to add color codes for these.
  • Use color codes like &7, &f, or &o only when writing custom static lines or when you want to override formatting manually.
  • Use empty lines ('') to add spacing.
  • Placeholder sections with no data (e.g., no sockets) are automatically skipped at runtime.

Return to: Item Generator Module