Tiers and Difficulties

Tiers and difficulties are defined in separate YAML files and referenced on each quest.

---

Tiers (tiers.yml)

Tiers are quest rarity labels (common through mythic by default). You can add, remove, or rename tiers; the plugin loads them in file order (GUI display order matches). Keys are case-insensitive.

Field	Purpose
display	Name shown to players (& codes or MiniMessage)
prefix	Short tag for lists, e.g. [RARE]
color	Base color for tier text / placeholders
weight	Relative spawn weight in the random generator (must be > 0)
description	Tooltip under the selected tier in the Premium editor

Default weights (~103 total): common 48, uncommon 28, rare 14, epic 7, legendary 3, mythic 1.

Example:

tiers:
  rare:
    display: "<blue>Rare</blue>"
    prefix: "<dark_gray>[</dark_gray><blue>RARE</blue><dark_gray>]</dark_gray>"
    color: "&9"
    weight: 14
    description: "&9Worth hunting down for stronger rewards."

Placeholders: %soapsquest_tier_<tierid>% for completion counts. See Placeholders.

---

Difficulties (difficulties.yml)

Difficulties scale objective amounts and rewards. Like tiers, order in the file is the display order.

Field	Purpose
display	Name shown to players
color	Base color
weight	Random generator weight
description	Tooltip text
multiplier.objective-amount	Scales objective counts
multiplier.reward	Scales rewards

Example:

difficulties:
  hard:
    display: "&cHard"
    color: "&c"
    weight: 20
    description: "&cMore demanding objectives with noticeably better rewards."
    multiplier:
      objective-amount: 1.5
      reward: 1.5

Defaults in config.yml: default-tier: common, default-difficulty: normal.

---

On quests

my_quest:
  tier: epic
  difficulty: hard
  objectives:
    - type: kill
      target: BLAZE
      amount: 10

The Premium editor cycles tier and difficulty with live preview. Changing difficulty in the editor can rescale objective amounts by the difficulty multiplier.

---

Version 1.0.6