Shadows of UI: Upgrade

Finds gear upgrades (and flags gear missing its enchant) for your whole warband and shows them where you make keep-or-sell decisions: on item tooltips, and across Warbandeer's Summary, Gear and Detail views.

The point is to stop hoarding. Instead of holding onto ten intellect one-handers "just in case", you can see at a glance which characters an item actually upgrades — and which copy is the best — so everything else can be vendored.

What counts as an upgrade

An item is an upgrade for a character when:

• the character can equip it (right armour type for their class, a weapon/shield they're proficient with — rings, necks, cloaks and trinkets are usable by everyone), and
• its item level beats what they currently have in that slot (for rings and trinkets, it's compared against the weaker of the two — the one you'd replace).

Two-handers are handled specially: if a character is wielding a two-hander their off-hand isn't really empty, so a stray off-hand or one-hander on its own is not counted as an upgrade for them. Only a better two-hander, or a main-hand + off-hand pair whose combined item level beats the two-hander, is suggested (both halves are marked as part of the swap).

Item level is the gate, but gear carrying the wrong primary stat for the spec is skipped first — an Intellect dagger is rogue-equippable but useless, so it's never offered as an upgrade. On top of that, the item's secondary stats are checked against the character's spec stat priority and tagged good stats (it carries a top-priority stat) or off-stats. The stat priorities are a small built-in table (derived from current PvE secondary-stat weightings), so this addon is fully standalone — no other addon is needed.

Missing enchants

It also flags equipped gear that's missing a permanent enchant — the head, shoulders, chest, legs, boots, rings and weapon(s) that take one this season but don't have it. Because the enchant is read straight from the item, this works for every character in the warband, not just the one you're logged into, so you can spot the alt whose rings still aren't enchanted without logging over. An item that's too low item level to take the enchant isn't flagged — you can't enchant it, so it's not treated as missing one (and gets no recommendation).

Characters below max level are skipped entirely: while you're still levelling, gear is replaced constantly, so enchanting or gemming it is a waste. No enchant/gem flags or recommendations (missing, wrong, or empty-socket) appear for a character until they hit max level.

It also tells you which enchant to apply. If you have the ClassCodex addon installed, the recommendation is its per-spec best enchant (from Wowhead) for every slot. Without it, a built-in fallback is used: rings are matched to the character's top secondary stat (so a Haste spec is pointed at the Haste ring enchant), the chest gets the universal primary-stat enchant, and weapons get a stat-matched enchant. The recommendation shows up next to the "missing enchant" flag everywhere it appears.

Wrong enchants

It also flags equipped gear that has an enchant, but not the recommended one — handy when a piece is still carrying an enchant for a different spec or an older, cheaper choice. The applied enchant name is recorded while each character is logged in, so (like the other flags) this works warband-wide, and the note shows what you have alongside the recommended swap. Because which enchant is "right" follows your played spec, this naturally re-evaluates when you change specs.

Empty gem sockets

It likewise flags equipped gear with an empty gem socket and recommends a gem to fill it. Whether a slot has an unfilled socket is recorded while each character is logged in (the game only exposes it for loaded items), so once a character has been seen it's known warband-wide — a slot you socket later just won't update until that character next logs in.

The recommendation respects that the primary-stat gem ("diamond") is unique-equipped — you can only socket one. So it suggests the diamond for a single socket and a secondary-stat gem to fill the rest. With ClassCodex installed both are its per-spec picks; without it, a built-in secondary-stat gem matched to the character's top stat is used (the role-specific diamond isn't bundled).

Recommended consumables

With ClassCodex installed, it also surfaces the spec's recommended consumables — flask, combat potion, food, weapon buff and augment rune (ClassCodex's Wowhead picks). Unlike enchants and gems there's no built-in fallback for these, so they appear only when ClassCodex is present. They're shown in Warbandeer's Detail view (see below); this addon adds no consumable tooltip line of its own.

Held vs. better elsewhere

• An upgrade sitting in a character's own bags or personal bank is held for them (green ▲).
• If the best upgrade for that slot is instead in the warband bank, it's flagged gold ▲ and called out as "better one in the warband bank" — so you know to move it over.

Where it shows up

• Item tooltips — hovering any equippable item adds an "Upgrade for:" line listing the characters it would upgrade, with the item-level gain and the stat tag. How binding affects this: Binds-when-equipped and Warbound-until-equipped items are checked against every character, since they can be moved freely; Soulbound items only list the character they're already bound to; and Bind-on-Pickup items that aren't bound yet get no block at all, since whoever loots one is stuck with it. Separately, hovering one of your own equipped pieces that's missing its enchant or has an empty socket adds a "Missing enchant — recommend …" / "Empty socket — recommend …" reminder.
• Warbandeer (optional) — when Warbandeer is installed:
  • the Summary view gains an "Up" column counting each character's available upgrades (hover for the list), an "Ench" column counting equipped slots missing an enchant, and a "Gem" column counting empty gem sockets (each a green check when there's nothing to do; the hovers name the enchant/gem to apply),
  • the Gear view marks each slot that has an upgrade with a ▲,
  • the Detail view marks each equipped item that can be upgraded — and notes any slot missing its enchant or with an empty socket (with the recommendation) beneath the item — and its Suggested box lists active world-quest rewards that would upgrade a slot (the quest's gear, the item-level gain, and where to find it) alongside the ready upgrades — world quests are scanned while each character is logged in, so the suggestions persist when you view an alt. Click a world-quest suggestion to open the map to it (and start tracking the quest). With ClassCodex, the Detail view also shows a Consumables box (flask, combat potion, food, weapon buff, augment rune), each category toggleable in Warbandeer's settings.

/supgrade [name] prints a character's available upgrades to chat (defaults to the logged-in character) — a debugging aid; you won't normally need it. /supgrade enchants [name] opens a copyable window explaining how each missing-enchant slot resolves (which source supplied the recommendation, or why none did) — useful when a slot shows "Missing enchant" with no suggested enchant.

Dependencies

• LibNAddOn
• Warbandeer_Characters — records the equipped gear, bag gear and warband-bank gear this addon reads. Open a character's bags, personal bank and the warband bank at least once so their loose gear is scanned.
• Warbandeer (optional) — for the Summary/Gear/Detail markers. The tooltip line works without it.
• ClassCodex (optional) — when installed, its per-spec best enchant and gem (from Wowhead) are used for the "which to apply" recommendations, for every slot. Without it, a built-in fallback is used. Either way the missing-enchant and empty-socket detection itself works. ClassCodex also supplies the spec's recommended consumables (Warbandeer's Detail Consumables box) — those have no fallback and appear only when ClassCodex is installed.

Notes

• Bag, bank and warband-bank contents are a last-seen cache: a character's loose gear is only known after you've had that bank/those bags open on the relevant character. Empty gem sockets are likewise recorded per character at login, so a socket you fill on an alt won't clear until that alt logs in again.
• Item level is the only gate, so a genuine sidegrade (e.g. a higher-ilvl piece that breaks a tier-set bonus, or a duplicate unique-equipped item) can still show as an upgrade — use the stat tag and your judgement.
• The class weapon/armour proficiency table is a baseline approximation; a rare spec-only quirk may add or drop a single suggestion.
• There is no window, no settings, and no saved data of its own.