Rarity tiers
A tier is the rarity label an enchant or crystal carries — common, uncommon, rare, epic, legendary, mythic. Tiers are purely cosmetic and organizational: they decide
- the lore color an enchant's name renders in,
- whether items of that tier glint (the enchanted shimmer), and
- the sort weight used to order things in the in-game browser GUIs.
Each enchant or crystal declares its rarity with a single tier: field. Tiers themselves are
defined once in content/tiers.yml, which lists every tier with its color, weight, and glint flag.
The tier ladder StarEnchants ships with:
| Tier | Colour | Weight | Glint |
|---|---|---|---|
| common (default) | &7 | 10 | — |
| uncommon | &a | 20 | — |
| rare | &b | 30 | — |
| epic | &d | 40 | Yes |
| legendary | &6 | 50 | Yes |
| mythic | &c&l | 60 | Yes |
:::warning Tiers are never part of an item's identity
A tier is metadata only — it is not part of an enchant's stable key. Re-tiering a file (changing
its tier:) restyles the lore but never changes the identity of gear that already has that enchant.
You can freely rename, recolor, or add tiers without breaking existing items.
:::
Tiers also scope the unopened (mystery) book and the random-book commands: a legendary mystery book rolls a random enchant from the legendary tier.
Related concepts
- Enchants and Crystals — what carries a tier.
- Groups — a different kind of grouping (suppression match keys), unrelated to rarity.
To define or customize tiers, see Configuring content.