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

Plugin Integration for %BASE_NAME%

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