editor tier - magemonkeystudio/divinity GitHub Wiki

🏷️ Editor: Tier

The Tier editor option assigns a predefined rarity tier to the item being generated. Tiers are fully customizable and defined manually in your config.yml.

Each item generator file can only have one tier assigned.

⚙️ What It Does

  • Adds a tier to the item, such as Common, Rare, Epic, etc.
  • Tiers control formatting and behavior, such as:
    • Display color
    • Prefix or suffix formatting
    • Stat ranges
    • Drop weighting
  • Tiers must be defined ahead of time in config.yml.

🛠️ How to Use

  1. Open the Item Generator Editor.
  2. Click Tier.
  3. Select from available tier names (automatically populated from your config).

⚠️ Rules

  • Only one tier can be selected per generator file.
  • Tier definitions must exist in config.yml, or they will not appear in the editor.

📄 Example (config.yml)

tiers:
  Common:
    display: '&fCommon'
  Rare:
    display: '&9Rare'
  Legendary:
    display: '&6Legendary'

In the editor, you’d see: Common, Rare, Legendary as options.

🧪 Tip

Tiers are especially useful for:

  • Visual styling (color-coded gear)
  • Tier-specific stat scaling
  • Loot balancing across level ranges

Use in conjunction with the Tier Lore or %TIER_NAME% placeholder to display the tier in the item's name or lore.

Return to: Item Generator Module