Item Tiers

Item Tiers

The tier filter on the browse screen sorts listings by rarity. Tiers are eco's rarities — read straight from plugins/EcoItems/rarities/.

The key idea: one source of truth

EcoItems' rarities/ folder is the rarity registry for the whole eco suite, not just EcoItems. Each rarity file has an items: list that can claim items from any eco namespace:

# plugins/EcoItems/rarities/rare.yml
lore:
  - "&9&lRARE"
weight: 3
items:
  - ecoitems:enchanted_diamond
  - talismans:starter_talisman
  - reforges:stone_sharp
  - ecoarmor:set_miner_helmet
  - ecopets:frog_spawn_egg
  - ecoscrolls:scroll_hot_potato_book

So there is no per-plugin tier mapping to maintain, and RoyalAuctions never compiles against a paid plugin. Whatever rarity an item shows in-game is exactly what the tier filter sorts by — one source of truth, no drift. Add a rarity file and it becomes filterable.

An item's rarity comes from either a rarity's items: list or an EcoItems item's own rarity: field. If several rarities claim an item, the highest weight wins (that's why none ships with the highest weight — it means "no rarity" and is always excluded from the filter).

The filter

The tier button cycles: it always starts at No Filter, then steps through your tiers. Left-click goes up the list, right-click goes down (swap ah_tier_prev / ah_tier_next in browse.yml to reverse). The whole list shows in the button's lore via the %tier_list% list placeholder.

Curating the filter

Tiers are discovered automatically. config.yml only curates the filter — it never defines tiers:

tiers:
  enabled: true
  order:                    # cycle order; discovered rarities not listed are appended (by weight)
    - common
    - uncommon
    - rare
    - epic
    - legendary
    - mythic
    - special
    - very_special
  hide: []                  # rarities to leave out of the filter entirely
  icons:                    # optional icon per tier on the filter button
    common: WHITE_DYE
    uncommon: LIME_DYE
    rare: BLUE_DYE
    epic: PURPLE_DYE
    legendary: ORANGE_DYE
    mythic: RED_DYE
    special: PINK_DYE
    very_special: MAGENTA_DYE

Key	Meaning
enabled	Turn the tier filter on/off.
order	Cycle order. Any discovered rarity not listed is appended after these (sorted by weight). none is always excluded.
hide	Rarities to leave out of the filter entirely — use this to hide test rarities.
icons	Optional icon per tier, shown on the filter button.

Timing

An item's tier is resolved once, when the listing is created, and stored on the row — browsing never recomputes it. Listings created before this feature existed have no tier and appear only under No Filter.

Without EcoItems

No EcoItems means no rarities to read, so the filter reports 0 tiers and sits inert. Everything else in the browser still works.