editor name format - magemonkeystudio/divinity GitHub Wiki
📝 Editor: Name Format
The Name Format option defines how the item’s display name is constructed at generation time. This is a dynamic template that supports placeholders for affixes, tiers, types, and more.
How to Use
- Click the Name Format icon in the editor.
- Enter a format string using any combination of supported placeholders.
- Confirm to save.
Supported Placeholders
Placeholder | Description |
---|---|
%BASE_NAME% |
The base name from the material (see plugin support below) |
%prefix_tier% |
The tier of the prefix |
%prefix_material% |
The material tag from the prefix |
%prefix_type% |
The type tag from the prefix |
%item_type% |
The defined item type (e.g., Sword, Bow, Axe) |
%suffix_material% |
The material tag from the suffix |
%suffix_type% |
The type tag from the suffix |
%suffix_tier% |
The tier of the suffix |
%BASE_NAME%
Plugin Integration for The %BASE_NAME%
placeholder is automatically populated when using custom materials from supported plugins:
Plugin | %BASE_NAME% Value |
---|---|
Oraxen | The Oraxen item’s internal name or display |
ItemsAdder | The registered ItemsAdder item name |
Nexo | The Nexo item’s name or display name |
Vanilla | (No value — placeholder is skipped) |
This makes %BASE_NAME%
especially useful when using animated or stylized items specifically from Oraxen, ItemsAdder, or Nexo, as these are the only integrations that support resolving a base name.
Example Format
%prefix_tier% %item_type% of %suffix_material%
Might generate:
Rare Sword of Flame
Or with custom plugin items:
%BASE_NAME% of the %suffix_type%
→ Sunfang of the Void
Tips
- Use color codes (
&6
,&b
, etc.) for visual enhancement. - Keep name length in check to avoid tooltip truncation.
- Combine with affix systems and item types for maximum variation.
Return to: Item Generator Module