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
andengine.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