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

Field	Purpose
display	Name shown to players
prefix	Short tag for lists, e.g. [RARE]
color	Base color for tier text
weight	Relative spawn weight in random generator
description	Tooltip text in GUIs

Example:

tiers:
  rare:
    display: "&9Rare"
    prefix: "&9[RARE]"
    color: "&9"
    weight: 25
    description: "&9Quests worth seeking out for better loot."

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

---

Difficulties (difficulties.yml)

Difficulties scale objective amounts and rewards.

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