GearMatic Changelog

[v3.13.0-release] - 06/26/2026

Added

• Trinket auto-equip is now tier-aware. It will swap in a higher-tier trinket even a few item levels lower (the Icy Veins "trinket exception"), scaled by how many tiers better it is and capped at a 13 item-level "big jump" ceiling, instead of refusing any item-level downgrade (AutoEquip.lua _allowTrinketSwap, TRINKET_ILVL_PER_RANK, TRINKET_MAX_ILVL_DROP; Scales/trinket_rank.lua RankForLink, TR.UNRANKED). Off-spec consideration uses the tier signal (Scoring/V2/Compare.lua rankDelta) rather than the honest stat delta, so a ranked bag trinket can replace an unranked equipped one.
• Per-spec "lower tier" and "similar" tooltip lines so no item is ever blank. A trinket that is not your best/2nd on a given spec's list shows lower tier; a near-equal item shows similar; both are decided independently per spec (ItemTooltipHook.lua fallbackTooltipKind, formatFallback, mirrored in /gm bagdump). New locale keys tooltip_lower_tier and tooltip_similar translated into all 12 locales.

Changed

• Weapon "best" is now loadout-aware. An off-hand or wand no longer reads "best" while a two-hander is the winning loadout; a wand competes for the main-hand slot, and an off-hand keeps "best" only when a 1H + off-hand loadout actually beats the best 2H (Scoring/V2/BestItems.lua offHandSuppressed, RANGEDRIGHT/RANGED folded into the main-weapon ranking).
• Tooltips, bags, and comparisons rank against one owned pool, so the same item shows the same best/2nd/percent on the character pane and in bags.

Fixed

• A wand in your bags now shows its real downgrade versus your equipped main weapon instead of comparing against itself and showing nothing (Scoring/V2/BestItems.lua CompareBaseline no longer returns the wand's own pool row for INVTYPE_RANGEDRIGHT/INVTYPE_RANGED, so it falls back to the equipped main-hand).
• An off-hand under a two-hander now shows the honest loadout downgrade (your best 1H paired with that off-hand versus your 2H) instead of going blank (Scoring/V2/Compare.lua off-hand branch, BestItems.OffHandLoadoutValue).
• Trinket tier resolution reads the trinket name from the item link, stable under Midnight "secret value" returns from GetItemInfo (Scales/trinket_rank.lua). The displayed percent shows only when the tier ranking and the real stat delta agree in sign, never the synthetic tier score.

[v3.12.0-release] - 06/25/2026

Changed

• The "best / 2nd best" tooltip badge is now scoped to the only equip slots where you wear two of a kind: trinkets, rings, and one-hand weapons when you can dual-wield (Scoring/V2/BestItems.lua RankAppliesToSlot, gated in ItemTooltipHook.lua). All other gear (armor, 2H weapons, shields/off-hands) now shows only the upgrade/downgrade percent chevron, never a best/2nd-best label.
• The forced "best" badge on a currently-equipped two-slot item is now limited to your active spec, so off-spec rows show their genuine rank instead of stamping "best" on every spec (ItemTooltipHook.lua).

Fixed

• A lower item-level copy of a trinket or ring you already have equipped no longer shows as "best" or "2nd best"; it now shows its real downgrade percent. Root cause: the equipped-item fingerprint (linkFingerprint) ignored bonus IDs, so a lower-ilvl bag copy matched the equipped copy and was treated as already equipped, which forced it to "best". The fingerprint now includes item level (ItemTooltipHook.lua).
• The best/2nd-best pool no longer lets the same item occupy both slots; duplicates are de-duplicated by item ID, keeping the higher item-level copy (Scoring/V2/BestItems.lua pushCandidate). A new ilvl-aware duplicate guard (equippedDuplicateOutranks) suppresses both the score-pool badge and the published-BiS "best" badge for a lower-ilvl copy of worn gear.
• Two equipped trinkets no longer both read "best"; they now read one "best" and one "2nd best" on your active spec.

Added

• /gm bagdump debug command (Debug/Score.lua): dumps every bag and equipped two-slot item with its per-spec rank, item level, pool best/second, BiS flag, and the exact badge each tooltip renders, for diagnosing trinket/ring labeling.

[v3.11.0-release] - 06/25/2026

Added

• The gear map window's GearMatic medallion (the emblem in the window header) now opens a right-click context menu, modeled on the CritMatic crit-log window icon (GearMap/Frame.lua). A new attachEmblemMenu helper enables mouse on the LibMatic RosterFrame's win._emblem and binds OnMouseUp: a right-click builds a GearMatic title plus three buttons, Open Settings (ns.Settings.Open), Open Character Browser (ns.Browser.Toggle), Open Changelog (ns.ChangeLogPopUp.Show), passed to a cross-version menu wrapper (MenuUtil.CreateContextMenu on retail 11.0+, EasyMenu + a reused UIDropDownMenuTemplate holder on classic). The emblem also gains a hover tooltip. New L["minimap_menu_settings"], L["minimap_menu_browser"], L["minimap_menu_changelog"], and L["gearmap_emblem_menu_hint"] keys added and translated across all 12 locales.

Changed

• The minimap button (the ring medallion) now opens the gear map on left-click instead of the settings panel, and opens the settings panel on right-click instead of toggling the character browser (Minimap.lua). Left-click routes through a new openGearMap helper that mirrors the /gm gear slash path: it toggles ns.GearMap.Frame when ns.GearMap.IsSupportedFlavor(ns.Compat.Flavor) is true (vanilla/TBC/Mists/retail) and otherwise prints the existing gearmap_unavailable_flavor notice (Wrath/Cata). The hover tooltip and the settings_show_minimap_desc option blurb were updated to the new click behavior.

Removed

• The vendor auto-sell-junk feature no longer caps how many items it sells per visit (VendorAutomation.lua). It previously stopped at NUM_BUYBACK_SLOTS (~12) items and printed a notice telling the player to sell the rest manually, on the rationale that the vendor buyback window only protects that many sales. VA.SellJunk now queues every junk slot in the bags unconditionally; the MAX_AUTO_SELLS constant, the remaining/overflow bookkeeping, the per-visit soldThisVisit counter, and the vendor_sell_cap_notice notice (and its now-dead locale key across all 12 files) were removed. The timed drip and the "auto-sold N junk items for X" summary are unchanged.

In-Game

• The gear map window now has a right-click menu. Right-click the GearMatic medallion in the top-left corner of the gear map window to open Settings, the Character Browser, or the Changelog.
• The minimap button now opens the gear map when you left-click it, and opens settings when you right-click it. Shift-drag still moves it around the minimap.
• Auto-selling junk at a vendor now sells ALL of your grey items in one visit. The old limit that stopped at about a dozen items and asked you to sell the rest by hand is gone.

[v3.10.0-release] - 06/24/2026

Changed

• The gear map's "Show all" checkbox was removed and replaced with a static Legend: [skull] BIS key (GearMap/DifficultyChrome.lua). The checkbox toggled GM.Settings().showAllContent, which defaults to gated and was only ever turned on here, so removing it locks the existing default; the showAllContent reads in GearMap/Engine.lua are untouched and now always evaluate to the default. The replacement is a GameFontHighlightSmall FontString showing L["gearmap_legend_label"] ("Legend") then the same inline skull texture the rows use, then L["gearmap_bis_legend"] ("BIS"). It sits on the left of the header, 25px in from the edge: GearMap/SpecChrome.lua's layoutRow anchors the legend TOPLEFT and shrinks the spec dropdown to fit its text (plus padding) and pins it TOPRIGHT. The legend is still assigned to win._gmDiffButton / win._gmDiffRefresh so the layout coordination and the GearMap/Frame.lua refresh callers keep working. New L["gearmap_bis_legend"] and L["gearmap_legend_label"] keys added across all 12 locales; the now-unused L["gearmap_show_all"] key is left in place.
• The gear map now sorts every row by the upgrade percent it actually shows. The row label uses up.displayDelta (the real-stat percent), but the list comparator in GM.Frame_BuildDisplayList (GearMap/Frame.lua) sorted on up.deltaPct (the weighted gating percent), which differs for nearly every non-trinket item, so the visible green percentages in both the Very Rare and Normal sections read out of order. The comparator's primary key is now displayDelta or deltaPct, so each section runs top to bottom by descending displayed percent. Gating is untouched (rows still qualify on deltaPct upstream in Engine.assembleRows); only the on-screen ordering changed.

Added

• The gear map shows "Equipped" instead of an upgrade percent for an item you already have on. For paired slots (rings, trinkets, one-handers) the baseline is the weaker of the two slots, so an item already worn in the other slot was scored as an upgrade over its sibling and displayed a green "+X%". New Engine.RowIsEquipped(up) (GearMap/Engine.lua), called from onRowUpdate (GearMap/Frame.lua), checks GetInventoryItemID("player", slotID) across C.SlotsForEquipLoc(equipLoc) for the row's item. Because raid items share one base itemID across LFR/Normal/Heroic/Mythic, an itemID match alone wrongly flagged a higher-difficulty record (e.g. the Heroic version) as "Equipped" when you only had the Raid Finder/Normal copy on; the row therefore also compares item level via C_Item.GetDetailedItemLevelInfo and only reports "Equipped" when the worn copy's level is greater than or equal to the listed item's level (an itemID match with no resolvable levels still falls back to "Equipped"). When worn it renders a neutral localized "Equipped" label (preserving the best-in-slot skull) instead of the percent. Detection is live at render against the current character's inventory, so no scoring or cache changes were needed. New L["gearmap_equipped"] key added and translated across all 12 locales. Covered by tools/gearmap-equipped-label-selftest.lua.

Fixed

• The gear map no longer lists a trinket as an upgrade when it is a real stat downgrade for your current spec. The gear map decided whether to list a trinket from its Icy Veins tier rank (eval.delta), so a tier-ranked trinket whose real stats are worse for your spec (e.g. an Agility trinket on a Priest) appeared as a green plus even though the item tooltip's current-spec line showed a minus. The existing trinket guard (Scoring/V2/Compare.lua:322) only demoted a ranked trinket to real stats when its item level was lower than the equipped one, missing the equal/higher-item-level downgrade case. New Engine.RowUpgradeDelta(eval, equipLoc) (GearMap/Engine.lua) returns eval.statDelta for trinkets (falling back to eval.delta only when statDelta is nil, i.e. a pure-proc baseline), and assembleRows now gates the row and sorts on that value. A trinket that is a real downgrade is dropped (the gear map never shows downgrades); the best-in-slot skull and every other slot are untouched, and global eval.delta is unchanged so auto-equip, loot alerts, and the bag overlay keep their behavior. Covered by tools/gearmap-trinket-realstats-selftest.lua. The gear map cache-schema token in Engine.GearMapFingerprint was bumped gm14->gm15 so the persisted GearMaticDB.gearMapCache (which survives /reload) is invalidated and rebuilds with the new scoring instead of serving pre-fix rows; tests/lua/test_gearmap_source_display.lua updated to assert gm15.
• The gear map's spec override (the spec dropdown's off-spec lens) is now stored per character instead of account-wide. Previously specOverride lived in one shared table (GearMaticDB.settings.gearMap), so a spec pinned on one character (e.g. Elemental on a Shaman, specID 262) was the same value every other character read. Cross-class picks were already dropped at score time by specIndexFor (262 never matches a Priest's specs), but same-class characters shared a single override and the value did not persist reliably (the legacy settings table is migrated into the AceDB profile and recreated empty each login, leaving the real value stranded in profiles.Default.gearMap). New GM.SpecOverride/GM.SetSpecOverride (GearMap/GearMap.lua) read/write GearMaticDB.gearMapSpecByChar[charKey], a top-level table Core never nils, so each character keeps and persists its own override. All readers (GearMap/Engine.lua resolveScale/playerCtx/selectScaleAndOwned/Debug, GearMap/SpecChrome.lua dropdown label) and the writer (SpecChrome select) route through the new API. Covered by tools/gearmap-specoverride-percharacter-selftest.lua; tests/lua/test_gearmap_spec_override.lua and test_gearmap_scoring2_match.lua updated to the new setter.

In-Game

• Trinkets in the gear map now match your item tooltip: a trinket that is actually a downgrade for your current spec no longer shows up as a green upgrade. Best-in-slot skulls are unchanged.
• The gear map's spec selector is now remembered per character. A spec you pick for one character no longer carries over to your other characters.
• The gear map now shows a "Legend: [skull] BIS" key in the top-left, so you can tell at a glance what the skull on an item means. The spec selector sits on the right. The old "Show all" checkbox was removed.
• The gear map now lists items in order of the upgrade percent shown on each row, so the biggest upgrades are always at the top.
• A gear map item you already have equipped now reads "Equipped" instead of an upgrade percent. A higher-difficulty version of an item you own (for example the Heroic copy when you wear the Raid Finder one) still shows as a real upgrade, not "Equipped".

[v3.9.0-release] - 06/24/2026

Changed

• Gear map Slot, Raid difficulty, and Dungeon difficulty filters now use a selection model instead of a toggle-off model. Open a dropdown and every option starts unchecked; an empty selection shows everything (button reads "All"), and checking one or more entries shows ONLY those (button reads N/M). Previously every option defaulted to checked and you unchecked to hide. GM.SlotFilter/GM.DifficultyFilter (GearMap/GearMap.lua) no longer seed keys to true. Engine.RecordPassesSlotFilter/RecordPassesDifficultyFilter (GearMap/Engine.lua) pass everything when nothing in their group is selected, otherwise admit only records whose slot/difficulty is checked (an item whose slot is not in the active selection is excluded; difficulty records that cannot be classified stay visible). Dropdown summaries in GearMap/SourceChrome.lua now read "All" at zero selected. A one-time gmFilterSelectV2 migration clears any saved slotFilter/diffFilter so existing users start fresh-unchecked (old "all checked" was functionally identical). Selftests tools/gearmap-slot-filter-selftest.lua and tests/lua/test_gearmap_diff_filter.lua updated to the new model.

In-Game

• The gear map's Slot, Raid, and Dungeon filters now work as a pick-list: open a filter and check the slots or difficulties you want to see. Check nothing to see everything. The filter button reads "All" when nothing is picked, or shows how many you have chosen.

[v3.8.0-release] - 06/24/2026

Added

• Gear map slot filter. A new "Slot" dropdown sits after the Crafted filter and works like the raid difficulty dropdown: a multi-select menu of equipment slots (head, neck, shoulder, back, chest, wrist, hands, waist, legs, feet, finger, trinket, main hand, off hand, and ranged where the flavor has a ranged slot), with an "All" / N/M summary. Selections persist in GearMaticDB.settings.gearMap.slotFilter. New GM.SlotGroups/GM.SlotGroupKey/GM.SlotFilter (GearMap/GearMap.lua), Engine.RecordPassesSlotFilter hooked into GM.Frame_BuildDisplayList, and the dropdown UI in GearMap/SourceChrome.lua. Slot names reuse Blizzard's localized INVTYPE_* globals; one new string gearmap_slot_label. Covered by tools/gearmap-slot-filter-selftest.lua.

Fixed

• Gear map percent now matches the item tooltip percent (e.g. the case where the gear map showed +1% while the tooltip showed +8% for the same item). Root cause: the gear map resolved its scale with SI.GetScaleForSpecIndex (the spec's default scale) while the tooltip uses SI.GetActiveScale (which honors the pinned _active scale), so a pinned/custom scale gave the two surfaces different weights and different scores. selectScaleAndOwned (GearMap/Engine.lua) now uses GetActiveScale for the active spec, falling back to GetScaleForSpecIndex only when a spec override targets a non-active spec, so both surfaces evaluate against the identical scale. Covered by tools/gearmap-scale-parity-selftest.lua.
• Gear map best-in-slot rows now show the upgrade percent on the left and the skull on the right (+X% ☠), using up.displayDelta. Previously the cell showed only the skull and dropped the percent.
• Tooltip best/2nd-best/best-in-slot badge now shows the same upgrade percent as the gear map. The tooltip skipped computing the evaluation whenever the item ranked (ItemTooltipHook.lua), so the badge had no number; it now evaluates unequipped current-character badge rows and appends the statDelta percent. Combined with the scale fix above, the badge number equals the gear map number.
• Boss source + portrait in the gear map tooltip now resolves reliably and is cached so it is ready on the first hover. EJ_GetCreatureInfo returns nil until the Encounter Journal context is set with BOTH EJ_SelectInstance and EJ_SelectEncounter (previously only the instance was selected, so many bosses never resolved). Resolution now does both, caches the display ID + icon per encounter in a persistent GearMaticDB.gearMapBossCache (instant on later hovers and across sessions), and pre-resolves every displayed boss in the background when the gear map opens (prewarmBosses). The portrait paints the journal boss icon when one is available and the creature display otherwise, with no tooltip rebuild and no magenta-placeholder flash. Added a /gm gear bossdebug diagnostic.
• Gear map window size changes now actually take effect. LibMatic-RosterFrame-1.0's New re-applies a saved layout.w/h via SetSize, so bumping the configured size did nothing once a size had been saved. Fixed three ways: build() resets the saved gearMapFrame layout (guarded by gearMapFrameSizeVersion), the configured size is larger (450 wide x 500 tall, up from 360 x 400), and an OnShow hook now forces that size every time the window opens so a stale saved layout can never shrink it again. It re-centers once after the reset.

In-Game

• New "Slot" filter in the gear map: pick which equipment slots to show.
• Best-in-slot items in the gear map now show the upgrade percent on the left with the skull on the right, and the percent in item tooltips now matches the gear map.
• The boss picture and gold ring now show the first time you hover an item in the gear map, instead of only on the second hover.
• The gear map window is taller now. (It re-centers once the first time you open it after this update.)

[v3.7.2-release] - 06/24/2026

Fixed

• Trinkets no longer show as upgrades when swapping to them would lower your item level. At max level a trinket is scored by its Icy Veins tier rank (trinket_rank.lua: 300000 - rank*2000 + ilvl), with unranked trinkets pinned to a 100000 + ilvl floor. When a curated (ranked) trinket was compared against an equipped trinket that is not on the list, the delta was the raw gap between the ranked synthetic score and the unranked floor (e.g. a rank-3 trinket at ilvl 250 read as "+177%" over an unranked stat-stick at ilvl 253), so bag/loot/tooltip markers and /gm score flagged a lower-ilvl trinket as a big upgrade even though it was a downgrade. Auto-equip already refused these swaps via AutoEquip._allowTrinketSwap (candIlvl >= equippedIlvl), but that guard only lived at the equip step. Compare.evaluateImpl now applies the same rule at the shared evaluation source: a trinket candidate whose item level is below the trinket it would replace falls back to the honest stat-based delta (and drops the tier override), so every surface agrees with auto-equip and the in-game tooltip. Tier still wins on equal-or-higher item level. Covered by tools/trinket-ilvl-downgrade-selftest.lua.
• Corrected a stale gear-map dedup selftest (tools/outranks-duplicate-selftest.lua) that still asserted the pre-v3.7.0 "higher-difficulty copy wins" behavior; it now matches the shipped "lowest-difficulty, easiest source wins" collapse that tests/lua/test_gearmap_dedupe.lua enforces.

In-Game

• Trinkets no longer show as an upgrade when equipping them would lower your item level. A lower item-level trinket is now compared on its real stats, matching what the in-game tooltip shows, so the marker and the upgrade percent agree with what you see.

[v3.7.1-release] - 06/24/2026

Fixed

• Quest reward upgrade markers no longer trigger an "attempted to format a negative copper value" error on the current retail client. To read each reward's item link, QuestRewardHook populated a hidden scanner GameTooltip via SetQuestItem/SetQuestLogItem and then read tip:GetItem(), but populating that tooltip drove Blizzard's GameTooltip_OnTooltipAddMoney -> FormatMoney over the item's money line, which produced a garbage negative copper value (-1492067296) and threw through the retail TooltipDataHandler. The hook never used the money line; it only needed the link. It now resolves links with the direct GetQuestItemLink/GetQuestLogItemLink getters (no tooltip, no money processing), keeping the scanner-tooltip path only as a fallback for any flavor that lacks those getters (those use the old tooltip system, which does not have this money bug).

In-Game

• Fixed an error that could appear when you opened a quest's reward list.

[v3.7.0-release] - 06/24/2026

Added

• Baganator support: GearMatic's best-in-slot skull and an upgrade indicator now render inside Baganator bags through Baganator's public corner-widget and upgrade-plugin API (new BaganatorIntegration.lua). It registers gearmatic_bis (the skull as a top-right corner widget) and gearmatic_upgrade (Baganator's upgrade slot), reusing a shared ns.BagOverlay.MarkerVerdict(link) helper so the skull/upgrade rule matches the default Blizzard bags exactly. Markers refresh on equipment change, bag update, active-scale change, and the /gm bistest preview toggle. Baganator's buttons are anonymous and pooled and expose item data via .BGR, so the generic bag-overlay detector never saw them; the corner-widget API is the supported path and survives Baganator's layout rebuilds.

Changed

• Pawn scale selection is now visibility-first. GearMatic mirrors the scales you keep visible in the live Pawn addon: a single visible class scale becomes active even when it has no spec tag (a copied or customized scale), multiple visible scales prefer the current spec and otherwise resolve deterministically by name, and scales you have hidden or deleted in Pawn are pruned from GearMatic on import instead of lingering. Pruning only ever removes Pawn-sourced scales (source == "pawn"); pasted import strings and plugin scales are never touched. The live usePawnWeights path uses the same deterministic single-visible logic.
• An explicit scale choice is now sticky. Picking a scale (the Settings profile list, /gm scale <name>, or a pasted /gm import) sets a per-character pin in GearMaticDB.activeManual[charKey], and Pawn auto-import will not overwrite a pinned, class-valid scale. This fixes the case where a Pawn user's customized Retribution scale (which carried no spec tag) kept being reset to a Holy scale on every login.

Fixed

• Gear map duplicate collapse keeps the easiest-to-obtain source again. When the same item drops at the same score from multiple difficulties, an inverted difficulty comparator in outranksDuplicate (accidentally flipped from cd < hd to cd > hd during the v3.5.0 item-level-aware best-in-slot work) made the harder source win the collapse. Reverted so the lowest-difficulty, easiest source survives, as tests/lua/test_gearmap_dedupe.lua asserts.

[v3.6.1-release] - 06/24/2026

Fixed

• Settings panel crash on the current retail client. The bundled Ace3 (AceConfigDialog rev 1296, 2022) called tooltip:SetText(name, 1, .82, 0, true), but retail's GameTooltip:SetText gained an alpha parameter, so the true (intended as wrap) landed in the numeric alpha slot and threw bad argument #5 to 'SetText' (outside of expected range) whenever you hovered a category or control in the options window. All four affected call sites now pass 1 for alpha (AceConfigDialog 523 + 1518, and both AceGUIContainer-TreeGroup copies), matching the upstream Ace3 rev 1386 fix. Added tools/aceconfig-settext-retail-selftest.lua to lock it.

In-Game

• Fixed a crash that could happen when opening GearMatic's settings and moving your mouse over the options on the current retail patch.

[v3.6.0-release] - 06/23/2026

Added

• Equip emote: a new Social option (social.emote, on by default) performs a /emote carrying the item link whenever you equip a new piece of gear (Social.EmitUpgradeEmote), throttled to once per 25 seconds. It fires on any equip, manual or auto, independent of the auto-equip setting. The toggle is localized in all 12 locales.

Changed

• The equip emote and the existing party/raid/guild broadcasts now also fire when you equip into a previously empty slot. The prior == nil early return in Social.OnEquipChange is removed and broadcastEquip is called with prior ~= nil so the channel broadcast still only fires on a real swap while the emote covers every equip. Social broadcasts and equip alerts run off the raw PLAYER_EQUIPMENT_CHANGED event, so they are not gated by the auto-equip toggle.

Fixed

• Equipping a full set of gear at once (a spec gear swap touching many slots) no longer plays a stack of overlapping alert sounds. Alert.playSound is gated by a 3-second global cooldown (Alert.SoundCooldownPasses).

In-Game

• Equipping a full set of gear at once no longer plays a pile of overlapping alert sounds. They are spaced out now, so a single gear swap does not flood you with noise.

[v3.5.0-release] - 06/23/2026

Changed

• Item-level-aware best-in-slot. The Icy Veins best-in-slot list is no longer an absolute override. Score.ScoreItem now ranks plain best-in-slot gear by its real stat score (item level plus your stat weights decide the slot), and reserves the float override for items whose worth a stat score cannot see: trinkets, tier-set pieces, and Classic class/dungeon set weapons, resolved through the new ns.GMBiSEffect table and BR.IsEffectBiS. The best-in-slot skull is now a marker on the genuinely-best-to-equip piece rather than a forced float.
• Among duplicate copies of one item, the higher difficulty / item level now wins. GearMap/Engine.outranksDuplicate was keeping the lower difficulty (Raid Finder); it now prefers the higher (so a Mythic copy beats its Raid Finder copy).
• Score.ScoreItem resolves three buckets at max level: trinket override, effect-best-in-slot float, then plain best-in-slot real stat score with a bis flag; everything stays gated to max level.

Added

• ns.GMBiSEffect: web-sourced (Wowhead, cross-checked) tier-set and Classic set-bonus piece names per spec for all five versions. 548 effect names across 147 specs, validated against the best-in-slot lists by tools/bis-effect-coverage-selftest.lua.
• Engine.SuppressBeatenBiS: after collapse, a plain best-in-slot skull stands down when a non-best-in-slot piece out-scores it in the same slot (two best-in-slot pieces never suppress each other, so two best-in-slot rings or trinkets both keep their skulls).
• BestItems.IsBestEquippable: best for any slot, second-best only for genuine two-ring / two-trinket slots.

Fixed

• The bag and character-sheet skull stood up on a best-in-slot piece even when a higher-scoring item was already owned (for example a higher-item-level two-hander out-scoring a best-in-slot one-hander). The bag and equipped skull are now gated on BestItems.IsBestEquippable, so the skull marks only the piece you should actually equip. Loot-roll skulls keep the simpler rule, since a roll item is not owned yet.
• Mists of Pandaria Brewmaster monk best-in-slot row was corrupted with Windwalker (damage) tier pieces and a mislabeled glove, leaving the tank with no working set bonus. It now uses the tank set, Shoulderguards / Chestguard / Gauntlets / Legguards of Seven Sacred Seals, for the 2-piece and 4-piece bonus, with the missing wrist slot filled and the dual-wield weapons split into main and off hand.

In-Game

• Item level and your stats now decide the best item in a slot. GearMatic no longer always forces the published best-in-slot item; the best-in-slot skull appears only on the piece that is genuinely your best to equip. It prefers the highest-difficulty version, so a Mythic piece beats its Raid Finder copy, and it steps aside when a higher item-level piece is the bigger upgrade. Set pieces and trinkets still win their slot, because their set bonuses and use effects are worth more than raw stats can show.
• The skull in your bags and on your character sheet now stands down when you already own a better item for that slot, so it marks only the piece you should actually equip.
• Mists of Pandaria: fixed Brewmaster monk gear recommendations that were using the wrong damage set pieces instead of the tank set.

[v3.4.1-release] - 06/23/2026

Changed

• The in-game AddOns-list description (TOC ## Notes) was rewritten to cover per-spec Icy Veins scoring and the best-in-slot skull marker, then localized into all 10 client locales (deDE, esES, esMX, frFR, itIT, koKR, ptBR, ruRU, zhCN, zhTW) via ## Notes-<locale>, reusing the shared LibMatic addon descriptions in their native-accent form.
• Shared LibMatic update: the GearMatic entry in the in-game "More Infinite Loop Alchemist Addons" settings list now reflects its current best-in-slot summary, in all 11 locales.

Fixed

• Upgrade percentages no longer use the internal best-in-slot or trinket ranking number. Score.ScoreItem runs the BiS/trinket override hooks (synthetic ordering scores around 400000 / 300000) for ranking, but those scores were divided directly in percentDelta, so a best-in-slot or trinket item compared against a normally-scored equipped piece showed runaway percentages such as +162411%. Score.StatScore now exposes the real stat score and the evaluation carries a stat-based statDelta used for the displayed percent, while the synthetic score is kept only for ordering. Best-in-slot items render the "best" badge on tooltips and the skull on the Gear Map instead of a number.
• The best-in-slot and trinket-tier overrides are gated to max level via ns.Compat.IsMaxLevel. While leveling, items rank on their real stats, so the endgame best-in-slot list no longer marks a leveling-item-level drop as best.

In-Game

• GearMatic's in-game description now appears in your game's language.
• Upgrade percentages are accurate again. A best-in-slot item shows the skull marker instead of a wildly inflated percentage, and every other item shows its true upgrade percent.
• The best-in-slot skull now appears only at max level, where the best-in-slot list applies. While you are leveling, GearMatic ranks gear by its real stats and points you at the biggest upgrade for your level instead of a max-level piece.

[v3.4.0-release] - 06/22/2026

Added

• Icy Veins best-in-slot override: for every live game version, GearMatic marks the Icy Veins published best-in-slot item for each slot as the best choice, overriding its own stat-weight ranking for those slots (a true BiS pick accounts for set bonuses, trinket effects, and crafted embellishments that a stat score cannot value). Scales/bis_lists.lua embeds the scraped lists keyed by item name (difficulty/ilvl-agnostic, since a piece exists at many ilvls/difficulties under one name); Scales/bis_rank.lua floats a BiS-named item to the top of its slot (above the trinket-tier override), resolving vanilla sub-modes via SpecLogicWeights.ResolveFlavor (Hardcore falls back to Era). Score.ScoreItem runs the BiS hook before the trinket hook. 151 specs: retail 39, mists 34, tbc 26, vanilla/Era 26, vanilla_sod/SoD 26.
• FAQ entry (faq_q_bis/faq_a_bis, all 12 locales) explaining the Icy Veins best-in-slot override and how it is verified.
• Skull marker (Textures/bis-skull.tga) for Icy Veins best-in-slot items: shown instead of the upgrade double-chevron on bag items, on the equipped paperdoll slot, and on the group-loot roll window. BiSMarker.lua drives the equipped + roll overlays via PLAYER_EQUIPMENT_CHANGED, CharacterFrame OnShow, and START_LOOT_ROLL/CANCEL_LOOT_ROLL; detection reuses the BiS engine (ns.BiSRank.IsPlayerBiS), so it covers all five live versions.

Verified

• tools/bis-match-selftest.lua: scores each version's full /gm gearcheck dump and asserts GearMatic's top distinct picks per slot are the Icy Veins best-in-slot items (deduped by name; capped by how many BiS items are in the dump). 569/569 testable slots matched across retail (233), mists (42), tbc (116), vanilla/Era (158), vanilla_sod/SoD (20). All 32 repo selftests green.

In-Game

• GearMatic now marks the Icy Veins best-in-slot item for each slot as the best choice on every live game version, even when another piece looks better on raw stats, because the true best-in-slot pick accounts for set bonuses, trinket effects, and crafted items that stats alone cannot judge.
• A skull icon flags your best-in-slot pieces in your bags, on your character sheet for a piece you already wear, and on the group-loot roll window the moment a best-in-slot item is up for roll, replacing the usual upgrade arrow for those pieces.
• The in-game FAQ has a new entry explaining how the best-in-slot list works and why a lower-stat piece can be marked best.

[v3.3.0-release] - 06/22/2026

Added

• Re-authored Retail (Midnight, patch 12.0.7) and Mists of Pandaria per-spec stat-priority logic as power-map override files (Scales/logic_retail.lua, 39 specs; Scales/logic_mists.lua, 34 specs), loaded after logic.lua like the TBC and Classic blocks. Sourced from a verified Icy Veins crawl that reads the > vs = operator directly from the guide's stat-priority markup (the separator icon class on retail, the ordered <h3> sequence on MoP Classic); text-flattened scraping silently drops = ties, which had turned ~14 retail specs' equal secondaries into strict orders. Equal secondaries now share a weight, removed the hallucinated Elemental masteryrating 86% cap. tools/speclogic-retail-mists-selftest.lua asserts every spec's order and every equality (1498 checks).
• LibMatic-ChangeLog-1.0 (MINOR 5): the changelog popup renders at most spec.maxEntries most-recent versions, default 10, so popups across all addons stay focused on recent releases.

Changed

• The in-game changelog popup combines a release day's player-facing changes into a single entry so same-day releases are not scrolled past. The 3.3.0 popup entry folds in the player-facing changes from 3.1.0, 3.2.0, and 3.2.1; CHANGE_LOG.md keeps the per-version history below.

Fixed

• /gm gearcheck dump now captures full loot coverage regardless of the dumping character's level. The Encounter Journal scan passes allTiers, so it walks every tier instead of only the tiers near the character's level, and allTiers is threaded into the loot cache key so it does not collide with the level-scoped gear-map cache. The offline full-coverage check (tools/gearcheck-offline.lua) now loads logic_retail.lua and logic_mists.lua so it grades the re-authored weights; verified clean (Retail 39/39 specs, Mists 34/34, 0 armor inversions on the full dumps).

In-Game

• Gear recommendations on Retail and Mists of Pandaria are now tuned for each specialization from the latest class guides, including correctly valuing stats the guides rate as equal, such as Elemental Shaman's Haste and Crit. Strike.

[v3.2.1-release] - 06/22/2026 (Hotfix)

Fixed

• Hotfix: auto-equip threw "bad argument #2 to 'tonumber' (base out of range)" when checking a trinket whose required level was above 36. The trinket guard read item level with tonumber(select(4, GetItemInfo(link))); select returns multiple values, so the 5th return (itemMinLevel) was passed as tonumber's base argument and any required level over 36 is an invalid base. Item-level reads now go through AutoEquip._safeItemLevel, which truncates select to the single item-level value, matching the safe pattern used elsewhere in the addon. Regression test added.
• The minimap button now opens GearMatic's settings in the standard Blizzard options panel instead of the separate floating AceConfig window. Settings.Open opens the registered Blizzard category via Settings.OpenToCategory (retail) or InterfaceOptionsFrame_OpenToCategory (classic), captured by the LibMatic panel registration, falling back to the standalone dialog only if neither category API is present.

Changed

• The FAQ question headings now use the GearMatic purple theme color instead of gold.

In-Game

• Fixed an error that could appear in chat when GearMatic checked a trinket while equipping gear automatically.
• Clicking the minimap button now opens GearMatic's settings in the normal options window instead of a separate floating panel.
• The FAQ headings now match GearMatic's purple theme.

[v3.2.0-release] - 06/22/2026

Added

• Trinket tier ranking: trinket slots are ranked by their Icy Veins guide tier for the player's spec instead of by stat score, because a stat score cannot value an on-use or proc effect. Score is 300000 - rank*2000 + ilvl, so the guide tier dominates and item level breaks ties within a tier; unranked trinkets sit below all ranked ones, ordered by item level among themselves. Self-contained in Scales/trinkets.lua (the emitted tier tables) and Scales/trinket_rank.lua (ns.TrinketRank.ScoreItem), hooked into Scoring/V2/Score.lua so every scoring path (tooltip, bag chevron, gear map, auto-equip, gearcheck) uses it. Covers retail, mists, tbc, and vanilla (Classic Era, inherited by Season of Discovery and Hardcore). Wrath and Cata have no tier data yet and fall back to stat scoring. English item-name match only; non-English clients fall back to stat scoring for trinkets.
• FAQ entry explaining trinket ranking, added to the in-game FAQ tab and translated into all twelve locales.

Fixed

• Auto-equip no longer downgrades an equipped trinket's item level when a lower-item-level but higher-tier trinket scores higher (AutoEquip._allowTrinketSwap). Trinket swaps now require equal or higher item level unless the slot is empty.

Changed

• /gm gearcheck reports trinket tier-picks separately from jewelry and cloak stat-picks, since trinkets are now tier-decided rather than stat-decided.

In-Game

• Trinkets are now ranked by their Icy Veins guide tier for your spec instead of by raw stats, so a higher-tier trinket is preferred even at a lower item level, with item level breaking ties inside a tier. Auto-equip will not downgrade a trinket's item level on a tier score. Works on Retail, Mists of Pandaria, Burning Crusade, and Classic Era including Season of Discovery and Hardcore.
• The FAQ tab has a new entry explaining how trinket ranking works.

[v3.1.0-release] - 06/22/2026

Added

• In-game FAQ tab in GearMatic's settings, tailored to the player's live game mode. Content is resolved at open time with the same flavor and season detection the stat logic uses, so the vanilla client splits into Classic Era, Season of Discovery, and Hardcore. Six modes carry mode-specific "how it decides your upgrades" answers (Retail, Mists, Burning Crusade, Classic Era, Season of Discovery, Hardcore); Wrath and Cata show a generic answer. Shared questions cover the honest "do I still need to sim" answer (no invented percentage), why a lower item level can win, role coverage, where the weights come from, and the optional Pawn toggle. New FAQ.lua data file and buildFAQTab() in Settings.lua; all twenty FAQ strings localized in all twelve supported languages.
• Custom Icy Veins stat logic for every Burning Crusade class and spec in Scales/logic_tbc.lua, replacing the previous crawled TBC pool with explicit per-stat power maps plus caps, the same model as the vanilla retune. Adds Retribution Paladin, which the old TBC pool omitted. Validated at full coverage against a 3,802-item dump (14 of 29 specs clean, all remaining inversions verified as legitimate itemization, no ratio bugs).
• Distinct Season of Discovery and Hardcore stat modes for vanilla, selected by C_Seasons.GetActiveSeason. SoD authors the rune-reshaped tanks and Int-led Restoration Shaman; Hardcore applies a Stamina and Intellect survival tilt on the recommended spec per class, falling back to Classic Era elsewhere.
• /gm gearcheck and /gm gearcheck dump: an in-game convergence test that scores GearMatic's own loot tables for every spec of your class and reports item-level inversions, plus a throttled full-table stat dump that feeds an offline checker (tools/gearcheck-offline.lua) so weights can be validated against the full item table beyond the client cache cap.

Changed

• Strength is now counted as two attack power for the classes that get it (Warriors and Retribution Paladins) on Classic Era, Hardcore, and Burning Crusade, fixing strength gear being ranked below raw attack power. Enhancement Shaman values Agility above attack power on vanilla, and is treated as Strength-first on Burning Crusade per the Icy Veins guidance. Hunters are scored on ranged attack power and never melee attack power.
• The spec weapon-type rule is now enforced on the bag upgrade chevron, not just auto-equip. Subtlety Rogue is locked to daggers in both hands. Retail Hunters are blocked from one-handed melee weapons on Beast Mastery and Marksmanship.

Fixed

• Auto-equip now swaps in the best matching weapon from your bags when an equipped weapon violates your spec's weapon-type rule, instead of leaving a higher item-level but illegal weapon equipped (for example, a Subtlety Rogue with a sword in the off hand now gets the best bag dagger equipped).
• Tooltip upgrade scoring uses the live active scale for your current spec, matching the bag chevron, so the two no longer disagree.
• The haste-breakpoint weight is capped so your main stat and weapon outrank haste-to-cap, and a breakpoint stat is no longer force-boosted when its current value cannot be read.
• The gearcheck inversion pool is scoped to each class's armor specialization, and weapons are decided by stats rather than counted as inversions.

In-Game

• GearMatic now has an FAQ tab in its settings, written for your exact game version, answering the common questions in plain language. The honest take on simming: the vast majority of players never need it, only cutting-edge raiders chasing the last percent or two on trinket procs, set bonuses, or near-tie calls benefit from a sim.
• Season of Discovery and Hardcore have their own tuned recommendations. Season of Discovery accounts for rune builds that change a spec's role; Hardcore weights survival stats up so close calls break toward the safer piece.
• Burning Crusade gear scoring is more accurate for every class and spec, with Strength counted as two attack power for Warriors and Retribution Paladins, Hunters scored on ranged attack power, Enhancement Shaman treated as Strength first, and Retribution Paladins now covered.
• The green upgrade marker on your bags now respects your spec's weapon type, Subtlety is kept to daggers in both hands, and auto-equip pulls the best matching dagger from your bags instead of leaving a higher item-level sword equipped. Tooltip upgrade scores now match the bag marker.

[v3.0.0-release] - 06/21/2026

Added

• New per-specialization stat logic derived from the Icy Veins class guides for every spec across Retail, Mists of Pandaria Classic, Classic Era, and The Burning Crusade Classic. Each spec carries its stat priority, hard stat caps, and haste breakpoints. Canonical per-expansion caps are used (Classic Era 9% melee hit / 16% spell hit; TBC 9% / 16% plus 6.5% dps and 14% tank expertise; MoP 7.5% / 15% plus 7.5% dps and 15% tank expertise), routed by role and by caster vs melee, with healers excluded from hit/expertise caps and tank defensive caps (defense, armor) preserved.
• Cap- and breakpoint-aware scoring: a capped stat (hit, expertise, spell hit) is weighted highly until your current character reaches the cap, then drops; a haste breakpoint stat is boosted while under the threshold and demoted once past it, handing priority to the next stat (for example Subtlety Rogue Haste to roughly 700 for Trickster or 1100 for Deathstalker, then Mastery).
• New "Use Pawn weights" option (off by default, under the Pawn settings, only enabled when the Pawn addon is loaded). When on, GearMatic scores your gear with Pawn's live stat weights for your current specialization instead of its built-in Icy Veins guidance. Localized in all twelve supported languages.

Changed

• The primary stat (Strength/Agility/Intellect) and weapon damage are now the dominant scoring weights, so for gear that carries a primary stat (head, chest, weapons, and so on) item level decides: a higher item-level piece wins instead of a lower one with a tidier secondary-stat split. Slots with no primary stat (rings, neck, cloak, trinkets) are still decided by their stats, matching the guidance that jewelry is the exception. This resolves cases where a lower item-level piece was marked or equipped over a clearly higher one.
• On quest rewards where you choose one of several items, only the single best choice for your spec is marked, instead of several options, with an item-level fallback when no stat scale is available.
• GearMatic's built-in (default) gear scoring now follows the Icy Veins guide logic on all four supported game versions, superseding the previous flat stat-priority weights.

Fixed

• Guarded against Midnight (12.0) "secret values": stat reads such as GetCombatRating can return secret values that error when compared in addon code. GearMatic now detects them with issecretvalue and wraps the comparisons, so cap and breakpoint checks degrade safely instead of throwing a Lua error during scoring.

In-Game

• GearMatic's gear ratings are now powered by the Icy Veins class guides, tuned for your exact specialization on every game version and for every role including healers and tanks. It knows your spec's stat caps and breakpoints and weighs your main stat and item level heavily, so a higher item-level piece wins unless a lower one truly has better stats (as with rings and necklaces).
• Examples: Retail Subtlety Rogue values Haste up to your hero talent breakpoint (about 700 for Trickster, 1100 for Deathstalker) then Mastery; Mists reaches your Hit and Expertise caps first; Burning Crusade reaches the hit cap, casters the spell hit cap, melee expertise, and tanks aim to be uncrittable; Classic Era reaches the melee hit cap and caster spell hit cap first.
• On quest rewards where you pick one item from several, only the single best choice for your spec is now marked.
• New option (off by default): if you have Pawn installed, you can switch GearMatic to score with Pawn's weights instead.

[v2.30.1-release] - 06/20/2026

Added

• GearMatic now contributes a sample upgrade alert to the shared alert stack, so its alert can be shown when you preview or arrange your on-screen alerts.

Fixed

• The green upgrade chevron (shown on bag items, quest rewards, and alerts) no longer depends on the loot-specialization tag (C_Item.GetItemSpecInfo) to decide whether an item is off-spec. That tag is a loot recommendation, not a usability restriction, and routinely omits a perfectly valid specialization (for example, a dagger's tag could exclude Subtlety even though Subtlety uses daggers), which wrongly suppressed the chevron on genuine upgrades across many class and spec combinations. The off-spec check now keys solely on an item's explicit specialization/class restriction text, so genuinely restricted items stay unmarked while real upgrades for your current spec are shown. Applies on every game version; on versions without a specialization system there is no off-spec suppression, unchanged.
• A bare "/gm auto" command no longer silently toggles upgrade detection on or off. It now reports the current state, and you change it explicitly with "/gm auto on", "/gm auto off", or "/gm auto toggle". Because all of a player's characters share one settings profile, an accidental bare toggle previously disabled detection on every character at once, which hid every upgrade chevron until it was switched back on.

In-Game

• The green upgrade marker now shows on gear that suits your specialization but was being skipped before. For example, a dagger upgrade for a Subtlety Rogue now correctly gets the marker on quest rewards and bag items. Gear made for a different specialization still stays unmarked.
• Typing "/gm auto" by itself now tells you whether upgrade detection is on or off, instead of switching it. Use "/gm auto on" or "/gm auto off" to change it.
• When you preview or arrange your on-screen alerts, GearMatic now shows a sample upgrade alert.

[v2.30.0-release] - 06/20/2026

Fixed

• Auto-equip now respects each spec's required weapon type and will no longer place a weapon of the wrong type in your main hand. A spec that needs a dagger (such as Assassination Rogue) keeps a dagger instead of being handed a higher item-level sword, and Hunters are matched to the correct ranged or melee weapon for their specialization. The rule is applied during the auto-equip sweep on every game version where the specialization can be read; if no legal weapon is available, your current weapon is left in place.

Changed

• The gear map's source filters (raid, dungeon, crafted) and the per-source difficulty dropdowns are now available at every character level, not only at max level.
• Gear you will be able to use within a few levels is shown at full brightness with its required level, instead of being dimmed to grey.
• The gear map now matches gear to your level band: while leveling it hides max-level gear you cannot use yet, and at max level it hides low-level leveling gear, so the list stays relevant to where you are. Turning on "Show All Content" bypasses this and shows everything.

In-Game

• Auto-equip no longer puts the wrong weapon type in your main hand. If your spec needs a dagger it keeps a dagger instead of swapping in a sword, and Hunters get the right weapon for their spec.
• The gear map's source and difficulty filters now work at every level, not just at max.
• Gear you will be able to use soon is shown normally instead of greyed out.
• The gear map now shows gear that fits your level: leveling gear while you level, and max-level gear once you reach max.

[v2.29.0-release] - 06/18/2026

Added

• 11 new bundled fonts, selectable anywhere GearMatic lets you choose a font: Capital Hill, Capital Hill Monospaced, Extra Thick, Extra Thick Monospaced, Fabled Font, Fabled Font Monospaced, High Birth More Letter Gap, Scrambled Eggs, Scrambled Eggs Bold, Tomorrow Night, and Tomorrow Night Monospaced.

In-Game

• 11 new fonts you can pick anywhere GearMatic lets you choose a font.

[v2.28.1-release] - 06/18/2026

Fixed

• Cosmetic items (appearance-only gear such as transmog backs and shirts) no longer receive GearMatic's score block in their tooltip. Because cosmetics carry no real stats, the iLvl heuristic was producing meaningless 100% downgrade lines for every spec; GearMatic now skips cosmetic items entirely on flavors where the game reports them as cosmetic.

In-Game

• GearMatic no longer adds its upgrade info to cosmetic, appearance-only items, so their tooltips stay clean.

[v2.28.0-release] - 06/17/2026

Added

• Multi-source gear map: the /gm gear map now organizes gear by where it comes from (raid, dungeon, and crafted), with on/off checkboxes for each source. Filtering is applied at display time and never triggers a rescan. Each row shows its source, and crafted rows show the profession and recipe.
• Retail crafted gear: the retail gear map now includes crafted items, resolved at runtime to their real max-quality item level and scored through the same path as drops, so a crafted upgrade actually reads as one. Crafted (aspirational) gear is exempt from the recommended item-level ceiling so chase targets are not hidden. Retail crafted/vendor data is generated from a pinned 12.0.7 wago.tools DB2 extract.
• Retail raid tier set pieces: class tier set pieces now appear on the gear map with real stats. They are collected from the player's class sets, identified by elimination (crafted, PvP, and normal drops excluded), and each piece's item level is resolved by grafting a real raid-difficulty bonus tail so it scores like a raid drop at each difficulty.
• Per-source difficulty filters: raid and dungeon each gain a visible difficulty dropdown (Looking For Raid, Normal, Heroic, Mythic) shown when that source is enabled at max level. Difficulty is a display-time filter; every record carries its own difficulty, so toggling never busts the loot cache or fingerprint.
• Very Rare items are grouped at the top of the list under the Very Rare header and closed off with a gold divider separating them from the normal rows.

Changed

• Classic data rebuild: the Vanilla, TBC, and Mists gear datasets were regenerated to schema v3 with crafted, vendor, and token sources and authoritative raid/dungeon tagging.
• Gear-map rows now show where an item drops and at which difficulty (for example "Raid Heroic", "Dungeon Mythic", or "Looking For Raid") in place of the armor-type label. Looking For Raid rows omit the redundant "Raid" prefix; crafted and vendor rows keep their short source tag.
• The gear map window is raised to HIGH frame strata, marked top-level, and brought to the front when it opens, so it sits above the default UI and comes forward when clicked.
• The gear map window is now a fixed 360x400 size (no longer resizable), and the hover tooltip opens on whichever side of the window has more screen room.
• The Vendor source was removed from the retail map: retail vendor data is entirely PvP currency gear, which is never a PvE upgrade, so the toggle only ever showed an empty list. Vendor records are still tracked internally so tier-set detection can exclude PvP set pieces.
• The gear map's default position for a fresh profile now opens at a center-left spot instead of dead center; existing saved positions are unchanged.

Fixed

• Best-item ranking compared one-handed weapons only within their own slot, so a one-hander could be stamped "best" even when an owned two-handed weapon scored far higher. One- and two-handers are now ranked together for the main-hand slot, so a one-hander behind an owned two-hander correctly reads "2nd best".
• Copying chat with /gmc no longer errors on WoW protected strings; the offending line is skipped and the rest of the buffer still copies.

In-Game

• The gear map now sorts gear by source, raid, dungeon, and crafted, with checkboxes to show or hide each. Crafted gear is included with its real item level.
• Retail raid tier set pieces now show up on the gear map with their real stats.
• You can filter raid and dungeon gear by difficulty (Looking For Raid, Normal, Heroic, and Mythic) using the dropdown next to each source.
• Each item now shows where it drops and on which difficulty, like "Raid Heroic", "Dungeon Mythic", or "Looking For Raid", instead of its armor type.
• Very rare items now sit at the top of the list, set off by a divider.
• The gear map window stays on top of other windows and jumps to the front when you click it.
• Classic gear lists were rebuilt to include crafted and vendor gear.
• Fixed a one-handed weapon being wrongly marked your "best" when a two-handed weapon you own scored higher.

[v2.27.1-release] - 06/16/2026

Changed

• Updated for World of Warcraft retail patch 12.0.7 (Mainline interface 120007). No GearMatic-breaking API changes; the legacy globals it still calls remain available and are already behind the per-flavor compatibility layer.

Fixed

• Gear map (retail): the boss portrait in an item's tooltip no longer flashes a magenta placeholder or vanishes until you re-hover. The boss image was being resolved live from the Encounter Journal on every hover (which fails on a cold journal) and streamed into a visible texture, showing the magenta missing-texture color. It is now resolved once while the journal is loaded during the scan, stored on the record, and painted as a static creature icon. The gear-map cache version was bumped so saved maps regenerate with the new data.
• The "More Infinite Loop Alchemist Addons" section in General options was missing the MailMatic icon; added mailmatic-icon.tga so it renders alongside CritMatic and RepMatic.

[v2.27.0-release] - 06/13/2026

Added

• The /gm gear map now surfaces upcoming gear for leveling characters within a level horizon (current level plus a window, capped at max level), instead of showing an empty list at low level. Gear you cannot equip yet but will be able to soon is listed by its required level.

Changed

• Upcoming and empty-slot gear now shows its required level instead of a fabricated "+100%". A real upgrade percentage is shown only when there is an actual equipped item to compare against; rows that tie on percentage break the tie by item value so the strongest options rank first (matching Pawn's value-ranked behavior for slots with no baseline).
• The leveling item-level ceiling is now derived from the level bracket the gear belongs to rather than a near-zero average item level, so a freshly leveling character is not strangled by an over-tight ceiling. Max-level behavior is unchanged.
• Classic stat scoring parity: per-school spell damage (fire, frost, nature, arcane, shadow, holy), block value (distinct from block rating), flat health and mana, and tooltip-line fallbacks for defense and spell hit/crit/haste rating are now extracted and scored on the Classic flavors. Every stat name was verified per flavor against the live game data.

Fixed

• The gear map item tooltip no longer flickers or vanishes while you hover. The list refresh was dismissing the hovered tooltip on every repaint; it now only dismisses when the hovered row's item actually changes.

[v2.26.0-release] - 06/10/2026

Added

• 36 new bundled default stat scales across Classic flavors from current WoWSims data: Vanilla gains Hunter, Tank Rogue, Warden Shaman, Tank Warlock, and Fury/Arms Warrior; TBC gains Hunter, Smite Holy Priest, and Fury/Arms Warrior; Wrath gains 11 specs including both Death Knight roles, both Feral roles, Protection and Retribution Paladin, Combat Rogue, Enhancement Shaman, and Warrior specs; Cataclysm gains 17 specs including all three Death Knight and Hunter specs, Guardian and Feral DPS Druid, and all Warrior and Rogue specs. Existing bundled weights are unchanged, and Retail weights remain in sync with Pawn's current Ask Mr. Robot data, including the Devourer Demon Hunter spec.
• The default-scale refresh tooling now resolves all current WoWSims data formats, preserves the curated Vanilla/TBC/Mists weight sets, and merges the Retail block automatically, so future refreshes cannot drop specs.

Fixed

• Auto-sell at vendors now stops at the buyback window's 12-item capacity per visit and reports how many junk items remain, so an oversized junk pile can never sell past what buyback can recover; the legacy container-info fallback also reads the correct itemID return.
• Loadout equip plans re-validate bag coordinates before every pickup, expire after 15 seconds instead of resuming with stale coordinates on a later bag change, count a step as applied only when the item verifiably equipped, reserve bag slots so two identical items resolve to distinct copies, and can swap rings, trinkets, and weapons directly between equipped slots.
• Loadout item matching reads enchant, gems, and random-suffix data correctly (the old field splitter mis-indexed every field under Lua 5.1, so different-suffix copies hashed identically); saved loadouts migrate automatically from their stored item links.
• Creating a new loadout with an existing name now warns instead of silently overwriting the saved set.
• Ranged weapons are no longer offered as main-hand candidates in the loadout slot flyout on Classic flavors, and a failed flyout equip returns the item safely instead of stranding it on the cursor.
• The Suggest Loadout On Spec Change toggle now works, matching loadouts by name against the new spec.
• Cataclysm Classic: the ranged slot is tracked, scored, and durability-checked again; ranged weapons no longer score against or auto-equip into the main-hand slot.
• The off-spec gate uses the item spec API first and localized tooltip patterns as fallback, so spec-restricted items are filtered correctly in all 12 supported languages instead of only English.
• Weapon speed parsing handles comma decimals on European locales.
• Empty gem sockets are no longer double-counted when both the stats API and the tooltip report them, which inflated socketed-item scores.
• Glyph scanning unpacks the correct values on Cataclysm and Mists Classic, and the talent fallback reads the correct selected value with the proper spec-group argument.
• Imported scales match your class regardless of letter case, the explicitly activated scale always wins over same-spec alternatives in deterministic order, two-prefix Pawn exports parse their real names and class metadata instead of importing as one scale named Pawn, and malformed default-scale entries are skipped instead of erroring.
• Pawn scale auto-import classifies Demon Hunter scales correctly and no longer detects classes inside unrelated words.
• Auto-equip: main-hand-only weapons are never sent to the off-hand slot (which previously retried forever), two copies of the same weapon can be planned for dual wield, and the minimum-upgrade threshold works correctly when scores are negative.
• Alt comparisons no longer read the logged-in character's off-hand or equipped items when scoring another character's gear.
• Tooltip upgrade arrows use GearMatic's own textures instead of Pawn's, fixing broken icons when Pawn is not installed; the green upgrade border resets when a chat-link tooltip switches to a different item; the border now has its own settings toggle and declared default.
• Two identical equipped rings or trinkets form their own upgrade baseline instead of comparing new candidates against a weaker third copy from bags or sets.
• Loot upgrade chevrons follow loot-window pages on Classic, work on the modern Retail loot window, and re-decorate when item data for uncached drops arrives.
• The Loadout browser no longer triggers blocked-action errors from keyboard input during combat on Retail.
• Addon messages from other players are sanitized before display (length caps, escape codes stripped from loadout names and version strings), your own version ping no longer registers you as a peer, and group equip announcements are rate-limited per channel.
• The icon picker unavailable diagnostic prints its message correctly, and a dead spec-detection branch was removed.

Changed

• Bag overlay refreshes are coalesced and event-driven: the once-per-second full-UI frame scan is gone, discovered bag buttons are cached in a registry, per-item verdicts are cached with size caps, and disabling the overlay hides existing chevrons immediately.
• Best-item pools and the stat-extraction cache are no longer wiped on every item pickup or merchant refresh; invalidation now rides bag and equipment change events.
• Spec-restriction lookups are memoized per item, removing a hidden tooltip scan from every evaluation.
• Item tooltips reuse the active-scale evaluation for the border decision and cache the equipped-item fingerprint set, removing a redundant full evaluation and 19 inventory queries per tooltip.
• Quest reward decoration and character rescans are coalesced behind single pending timers, and item-info events only trigger rescans for items actually awaited.
• Auto-equip sweeps evaluate only the bags that changed and skip the weapon planner when no weapon changed and equipment is unchanged.
• The loadout sidebar hover highlight is driven by enter/leave events instead of per-frame polling, and the sidebar template probe no longer creates a duplicate frame.
• Alert frames are pooled and fully reused instead of permanently allocating a new frame, font string, and animation groups per alert; loadout keybind buttons are pooled by ordinal across renames; the armor cache is size-capped; profile switches refresh minimap, keybinds, and overlays immediately; the per-character seen-items list stores timestamps and prunes entries older than 180 days.

In-Game

• Auto-sell now stops at 12 items per vendor visit, exactly what the vendor's buyback tab can hold, and tells you how many junk items are left, so nothing can ever be sold beyond what you can buy back.
• Loadouts are far more reliable: swapping two rings or trinkets between their slots works, two copies of the same item equip correctly, the result message reports what actually equipped, and a stuck swap times out safely instead of grabbing the wrong item later.
• Creating a new loadout with a name you already use warns you instead of silently overwriting the old set.
• Hunters on Cataclysm Classic: your ranged weapon is tracked, scored, and durability-checked properly again.
• Playing in any supported language: items restricted to another specialization are now filtered out correctly, and weapon speeds with comma decimals are read properly.
• Upgrade arrows in tooltips display correctly without the Pawn addon installed, and loot window upgrade markers now work on Retail and follow page turns on Classic.
• Pasted and imported stat scales are honored properly: your chosen scale stays active, imports keep their real names, and Demon Hunter scales import for the right class.
• Smoother play: looting, opening bags, and mousing over items do far less hidden work, and long sessions no longer slowly grow memory from alerts.
• The green tooltip border for upgrades now has its own on/off setting.

[v2.25.0-release] - 06/09/2026

Added

• Use shared LibMatic alert position option, on by default: alerts from all Infinite Loop Alchemist addons anchor to one shared screen position and merge into a single stack, newest on top. Turning it off restores this addon's own alert position and stacking.
• Max Shared Alerts option, default 5: caps how many alerts the shared stack shows at once across all addons combined.
• The shared position and limit stay in sync across addons and persist through reloads; setting them from any one addon applies to all.
• Both new options are fully localized across every supported language.

In-Game

• New option: alerts from all Infinite Loop Alchemist addons can share one position on screen and stack neatly together, newest on top. On by default; turn it off in the alert settings to keep this addon's own alert position.
• New Max Shared Alerts setting controls how many alerts can be on screen at once in the shared stack, 5 by default.
• Drag the alert position in any one addon and every addon using the shared position follows.

[v2.24.0-release] - 06/08/2026

Added

• Bounce Style selector on the Alert Messages settings, choosing between Bounce and Classic Bounce for the gear alert animation (default Classic Bounce), driven by the shared LibMatic-CombatTextBounce styles.
• Preview buttons on the Alert Messages settings fire a sample upgrade/downgrade alert so you can test your look.
• Reset buttons on the Alert Font and Alert Messages settings restore those sections to their defaults.
• Picking a sound in the Sound settings now plays it immediately so you can preview each option (LibMatic-Settings play-on-select).

Changed

• Gear upgrades now default to the Level Up sound and gear downgrades to Zombie Attack.
• Mute All Sounds now defaults to off, so gear alerts make sound out of the box.
• Cleaned up the shared LibMatic sound pack: removed duplicate dropdown entries, renamed a couple of sounds for clarity, and re-normalized the custom alert sounds louder.
• Resetting a profile now prompts for confirmation. LibMatic-Settings injects an AceConfig confirm onto the AceDBOptions Reset Profile control, so the Profiles tab asks before wiping a profile.

Fixed

• Corrected the Wrath of the Lich King Classic TOC interface (was 38001, a non-existent client tagged on CurseForge as 3.80.1; now 30405 for Wrath Classic 3.4.5), so the Wrath build is matched to the right client.
• Change-log popups from different Infinite Loop Alchemist addons are now independent. LibMatic-ChangeLog tracks each open window in a set and cascades them instead of sharing one frame, so closing one addon's popup no longer dismisses the others.

In-Game

• New Bounce Style option lets you pick how gear alerts animate (Bounce or Classic Bounce), with Preview buttons to test your look and Reset buttons to restore the Font and Messages settings.
• Gear upgrades play the Level Up sound and downgrades play Zombie Attack by default, and gear alerts make sound out of the box.
• Picking a sound in settings now plays it, the sound list is cleaner and louder, and resetting a profile now asks you to confirm first.
• Fixed the Wrath Classic build so it installs on the correct game version.

[v2.23.1-release] - 06/08/2026

Changed

• The General settings page now shows a short, localized description under each addon in the More Infinite Loop Alchemist Addons section, sourced from LibMatic-Settings.

[v2.23.0-release] - 06/07/2026

Added

• Alert text and the gear icon now use a shared adjustable drop shadow from LibMatic-AlertShadow, with a Shadow strength slider on the Alert Font settings to set how dark the shadow is.
• Alerts now defer under native full-screen popups (renown, level-up, cinematics) via LibMatic-OverlayGuard, so a gear alert landing during one shows right after the screen clears.
• /gm test levelup, /gm test renown, and /gm test cinematic fire the sample gear alert behind a look-alike of that native screen, so you can preview the held-then-pop deferral without leveling. Plain /gm test is unchanged.

Fixed

• The alert sound now plays together with the alert. When an alert is held under a native screen, the sound waits and plays when the alert appears instead of during the screen.
• An empty gear slot is now treated as a fillable upgrade target, so equipping into an empty slot registers as an upgrade.

In-Game

• New Shadow strength slider makes gear alerts easier to read. Turn it down for a lighter shadow or to 0 for none.
• Gear alerts no longer get hidden behind the game's renown, level-up, and cinematic screens. They show right after, and the sound now plays with the alert instead of during the screen.
• Equipping gear into an empty slot now shows as an upgrade.

[v2.22.0-release] - 06/06/2026

Added

• 15 new alert sounds available from the shared LibMatic sound pack: Alarm Clock, Anima Cast, Artifact Unlock, Banshee, Deathwing Wound, Epic Loot Toast, Icy Touch, Legendary Toast, LFG Denied, Mission Complete, Shop, Shop 2, Ten, Titan Light, and World Quest Complete.

Changed

• The alert "Start delay" control is now sourced from LibMatic-Settings' shared BuildCountUpControls instead of a hand-rolled option. No change in behavior.

[v2.21.3-release] - 06/06/2026

Fixed

• Off-hands and shields showed a false +100% upgrade when a two-handed weapon was equipped. With a 2H weapon in the main hand the off-hand slot is empty but blocked, you cannot equip an off-hand or shield without dropping the 2H. GearMatic was comparing the candidate against the empty off-hand slot (baseline 0) and reporting +100%. It now suppresses off-hand/shield evaluation entirely while a 2H is equipped.
• Items showed a false +100% upgrade for an alt whose gear GearMatic had never recorded for that slot. For an alt a missing slot means "unknown," not "empty." GearMatic now treats a missing alt baseline as not-comparable and shows no line, instead of assuming an empty slot and claiming a +100% gain.
• The character gear browser failed to open on retail 12.0 because ItemButtonTemplate did not resolve. The slot buttons now fall back to a plain icon button when the template is unavailable, so the browser opens on every flavor. Also fixed a footerText nil crash that fired on durability updates when the browser was closed or only half-built.

Changed

• The other-characters lines on an item tooltip now show only characters the item is an upgrade for (at least a 1% gain), not downgrades. A character appears only when the item is actually worth sending to them.
• Weapons are now filtered by class proficiency, not just armor. An item is no longer shown as an upgrade for a character whose class cannot equip that weapon type (for example a two-handed weapon or staff for a Rogue, a sword for a Priest). Backed by a per-class weapon-type table verified against current-retail sources.

In-Game

• Off-hands and shields no longer show a false upgrade when you have a two-handed weapon equipped.
• Items no longer show a false upgrade for one of your other characters until GearMatic has actually seen that character's gear.
• The character gear browser opens reliably again.
• On an item's tooltip, your other characters now appear only when the item is an upgrade they can actually use, the right class for the weapon and a real gain.

[v2.21.2-release] - 06/05/2026

Fixed

• Upgrade/downgrade alert percentages are now fully colored. The alert colored only the digits; the trailing % sign sat after the color reset and stayed the item's rarity color. The whole token (the +/-, the number, and the %) is now colored green for a gain and red for a loss, while the item name keeps its quality color. Fixed in both the static render and the roll-up count animation (LibMatic-CountUp bumped to MINOR 6).
• Bag upgrade arrow and auto-equip ignored items the game did not loot-tag for the current spec. The current-character gate rejected any item whose C_Item.GetItemSpecInfo list did not include the active spec, so usable upgrades (for example certain trinkets not loot-tagged for a healer spec) showed +X% on the tooltip but got no bag arrow and were skipped by auto-equip. The gate no longer trusts the loot-spec tag for usability; it relies on GearMatic's own scoring and keeps only the hard "For X specialization." tooltip restriction.
• Items your class cannot wear no longer show any GearMatic per-spec lines. Armor proficiency is class-wide, so an item you cannot equip in your main spec cannot be equipped in any spec. The tooltip previously still showed off-spec "best/2nd best" badges for unwearable armor (for example mail on a cloth class) because the wear check only gated the upgrade/downgrade rows, not the badges.

In-Game

• Upgrade and downgrade alert percentages are now fully colored: green for a gain, red for a loss.
• The bag upgrade arrow and auto-equip no longer skip items your spec can use when the game does not label them for your specialization, such as some trinkets.
• Items your class cannot wear no longer show GearMatic spec lines on their tooltip.

[v2.21.1-release] - 06/05/2026

Fixed

• Buyback tooltips showed no GearMatic upgrade lines. The SetBuybackItem hook resolved the item link via tooltip:GetItem(), which does not populate for a buyback tooltip on retail (and the modern TooltipDataProcessor callback does not supply a buyback link either), so no link reached the scorer. The hook now resolves the link via the dedicated GetBuybackItemLink(slot) API (the slot index is passed to the SetBuybackItem hook), with the old GetItem path kept as a fallback.

In-Game

• GearMatic's upgrade and downgrade lines now show on items in the merchant Buyback tab.

[v2.21.0-release] - 06/05/2026

Added

• Off-spec set building in tooltips. The lines for your other specs now score against gear you own anywhere, including loose items in your bags/reagent bag, not just what is equipped or in a saved Equipment Set. A new owned-item pool (BestItems.GetOwnedPool = equipped + equipment sets + bags) is used for off-spec evaluation only; the current spec still compares against equipped/sets as before. So while you are Discipline, the Holy and Shadow lines reflect the off-spec set you are collecting and show "best"/"2nd best" when an item belongs in it.
• Colored alert numbers. Gear upgrade/downgrade alerts now tint the rolling number and its +/- sign green for a gain and red for a loss, while the item name keeps its quality color. Powered by a new optional numberColor in LibMatic-CountUp-1.0 (MINOR 5), with a matching path for the non-animated number.

Changed

• AutoEquip also refuses Warband-until-equipped gear. The bind guard now treats bindType == 9 (Warband-until-equipped, which soulbinds to the character on equip) the same as Bind-on-Equip: skipped from bags unless already bound. An unknown/uncached bind type is now treated as "could bind" (safe skip) rather than "safe to equip".

In-Game

• When you hover gear, the lines for your other specs now count gear sitting in your bags, so you can build a set for your off-spec and see whether an item improves it.
• Gear upgrade and downgrade alerts now color the number green when it is a gain and red when it is a loss. The item name keeps its quality color.
• GearMatic will not auto-equip Warband-until-equipped gear from your bags either, since equipping it binds it to this character. Gear that is already bound still gets equipped automatically.

[v2.20.3-release] - 06/05/2026

Fixed

• Two-slot gear (trinkets, rings, weapons) showed a false upgrade for an item you already wear. The two-slot baseline compared a candidate against the WEAKER of your two equipped slots, so a lower-item-level copy of a trinket/ring you already have equipped (or a different item in the same unique limit-category) was flagged as beating your other slot, even though the game won't let you equip a second one. Compare now detects when the candidate's item ID is already equipped in the slot group (or its C_Item.GetItemUniqueness limit-category is at cap) and baselines against the equipped copy it would actually replace. Single-slot gear and genuine free-slot upgrades are unaffected. Covered by tools/conflict-baseline-selftest.lua.

In-Game

• Fixed trinkets, rings, and weapons showing a false upgrade arrow when you already have a better copy of the same item equipped (you can't wear two). GearMatic now compares against the copy you are already wearing instead of your other slot.

[v2.20.2-release] - 06/05/2026

Fixed

• Item tooltip upgrade/downgrade percentages were wrong for gear with bonus/upgrade IDs. On retail, the tooltip hook scored a base item link (item ID only, missing the bonus/upgrade/crafting IDs) handed to it by TooltipDataProcessor, so crafted and Bind-on-Equip gear read base-template stats and showed wildly wrong verdicts (a real upgrade could display as a ~90% downgrade). appendUpgradeLinesImpl now prefers the rendered tooltip:GetItem() link, which carries the full bonus/upgrade/crafting IDs. The bag overlay, auto-equip, quest-reward, and loot scorers already used full links (GetContainerItemLink/GetLootSlotLink/GetItem) and were unaffected.

In-Game

• Fixed gear upgrade and downgrade percentages in item tooltips that could show wildly wrong values (often a big downgrade) for crafted and Bind-on-Equip gear. Tooltips now read the item's real stats.

[v2.20.1-release] - 06/05/2026

Fixed

• AutoEquip never binds a Bind-on-Equip item. The bag-upgrade sweep previously swapped any wearable upgrade into its slot via EquipCursorItem without checking bind type, so a Bind-on-Equip item that scored as an upgrade got bound to the character permanently. A new Compat.WouldBindOnEquip check (item bindType == 2 plus C_Item.IsBound on the bag slot) now gates the armor sweep, the weapon candidate gathering, and the weapon equip step. Items that are already soulbound, Bind-on-Pickup, or no-bind are still equipped normally. Covered by tools/autoequip-boe-selftest.lua.

In-Game

• GearMatic no longer auto-equips Bind-on-Equip gear from your bags, so it can't bind something you were keeping to sell or trade. Gear that is already Soulbound still gets equipped automatically, just like before.

[v2.20.0-release] - 06/04/2026

Added

• Roll-up number animation on upgrade/downgrade alerts (default on). When an alert shows a gear-score change, the number rolls up to its value instead of appearing instantly. A toggle restores the instant number.
• Settings Profiles tab. Generic settings tabs were rebuilt on LibMatic-Settings and a Profiles tab added; settings are now backed by an AceDB profile with a one-time migration that preserves existing settings, tracked characters, and scales.
• Full-name command help, with the help text localized into every shipped locale.

Changed

• Moved to LibMatic shared modules. Options-panel registration routes through LibMatic's RegisterPanel/OpenPanel, the in-game changelog popup renders via LibMatic-ChangeLog with shared styling, the login banner uses the shared startup banner, and alert sounds come from LibMatic-SoundPack. LibMatic is consumed as an in-repo symlink and bundled as a packager external.
• Removed the alert test-position button from the options.

Fixed

• No error on login. ns.db is now guarded before reading profile.showLoginNag, so a login-timing path no longer errors.
• Changelog popup toggle is bound to the showChangeLogPopup key, so the General-settings toggle controls the popup correctly.

In-Game

• Gear upgrade and downgrade alert numbers now roll up when they appear. Prefer the instant number? Turn off the roll-up animation in the options.
• New Profiles tab in the settings. Save your GearMatic settings as profiles and switch between them; your existing settings carry over automatically.
• Fixed an error that could appear at login.

[v2.19.0-release] - 06/02/2026

Changed

• Pawn auto-import now defaults OFF (pawnAutoImport = false in DEFAULT_SETTINGS). New profiles use GearMatic's bundled scales unless the user enables Pawn import in the options. Existing profiles keep their saved value (ApplyDefaults only fills unset keys).
• GearMatic_Mists.toc interface bumped to 50504 for Mists of Pandaria Classic 5.5.4.

Added

• Discord icon in the General Support group (discord.tga), wired through the shared LibMatic-Settings discordIcon hook.
• "More Infinite Loop Alchemist Addons" group in General options, linking CritMatic and RepMatic with their icons and copy-CurseForge-link boxes (new critmatic-icon.tga / repmatic-icon.tga in Textures/). New locale key settings_group_more_addons.

[v2.18.0-release] - 05/31/2026

In-Game

• Items you can equip now show the correct upgrade again. A higher item-level piece sitting in your bags was making genuine upgrades look like big downgrades.
• When GearMatic posts your gear upgrades to guild chat, it now spaces them out to about one per minute, so a batch of auto-equips no longer spams the guild.

Fixed

• Best-owned baseline no longer raw-scans loose bag items. Scoring/V2/BestItems.lua rebuild had a for bag = 0, NumBagSlots() loop that pushed every bag item into the pool, so a high-ilvl item stashed in bags became the pool best and genuine upgrades scored as large downgrades (real case: ilvl171 feet showed -81% vs an unequipped bag boot, identical across all three specs). Restored to equipped + equipment-sets only, matching v2.16.0. Commit e952d17.

Added

• Guild broadcast cooldown: gear-upgrade chat broadcasts to the GUILD channel are throttled to one per 60s in Social.lua (GetTime gate, matching CritMatic). Party/raid/instance channels stay unthrottled, so AutoEquip sweeps no longer flood guild chat. Commit df36ee2.

[v2.17.2-release] - 05/31/2026

In-Game

• The gear-upgrade chat broadcast now leads with a skull icon instead of a star, and the icon shows correctly in every game language.

Changed

• Social broadcast marker changed from {rt1} (star) to {rt8} (skull) in Social.lua, and the matching settings_social_desc help text updated across all 12 locales. The numeric {rtN} raid-target token is locale-independent, so the skull renders on every client (the {skull} keyword would only work on enUS).

[v2.17.1-release] - 05/31/2026

In-Game

• The interface is now fully translated in every supported language (German, French, Spanish, Italian, Portuguese, Russian, Korean, and Chinese).

Changed

• Localization: filled the 38 keys that every non-English locale (and enGB) was missing, so they no longer fall back to English. Covers loadout slot-action hints, the Pawn and vendor settings, the changelog-popup toggle, current_spec_marker, tooltip_best/tooltip_second_best, and the load splash. Translated for deDE, esES, esMX, frFR, itIT, koKR, ptBR, ruRU, zhCN, zhTW (plus enGB), matching each file's existing diacritic/style convention; all %d/%s format specifiers and |cff...|r color codes preserved. Each locale now covers the full 239-key enUS set (0 missing, 0 duplicates, all pass luac -p).

[v2.17.0-release] - 05/31/2026

In-Game

• Item tooltips now show your upgrade chance for every spec you have, with your active spec listed first and marked (current).
• One-handed weapons in your bags no longer show a false upgrade arrow when your class can't dual-wield them.
• The gear-slot swap window now correctly lists the items you can put in that slot.
• Upgrade markers for your other characters now show up correctly again.
• The character browser no longer blocks your keyboard while it is open.

Added

• Per-spec upgrade rows in item tooltips lead with the active spec, promoted to the top of the list and tagged with a (current) marker via the new SI.GetActiveSpecIndex() (resolved from C_SpecializationInfo.GetSpecialization).

Fixed

• Compare.EvaluateForChar ran the current character's can-wear / off-spec gate (ShouldEvaluateForCurrentChar) for ALL characters, so alt upgrade rows (tooltip alt lines, BestAltUpgrade feeding the bag/loot/quest overlays) were suppressed for any item the logged-in character couldn't use. The gate now only applies when scoring the current character; alts are class-filtered by their own callers.
• One-hand weapon baseline (BestItems.CompareBaseline) and best/2nd-best assignment (assignOneHandedBestItems) treated non-dual-wield classes as dual-wielders, so a 1H weapon was compared against the off-hand frill and inferior weapons read as upgrades (false bag chevron) or as a spurious "2nd best" badge. Both paths are now gated on CanDualWield().
• GetItemInfoInstant equipLoc was destructured at return position 9 (the GetItemInfo layout) instead of position 4 in Loadouts/SlotFlyout.lua and Loadouts/Equip.lua, so the slot-swap candidate grid was always empty and the 2H unequip-first step never fired.
• Pawn scale import derived specID from trailing digits of the scale name instead of the scale's real SpecID field, and the Resilience stat alias mapped to a misspelled key (resilienceitrating), dropping resilience weight from every score. Both corrected (alias and export map now use resilience; import reads pawnScale.SpecID first).
• The full character scan never cleared a slot that is now genuinely empty, so an unequipped item lingered in saved data and inflated the tracked average item level. Empty slots are now cleared.
• Durability helpers (CountLowDurability, MinDurabilityPct) could divide a nil durability from legacy saved rows; the loop now guards on slot.durability.
• Auto-equip's combat guard checked only UnitAffectingCombat; it now also returns true on InCombatLockdown() so it won't attempt a protected weapon swap during the combat-lockdown tail.
• The character browser frame enabled keyboard capture without SetPropagateKeyboardInput, trapping every keystroke (movement, action bars, chat) while the window was open. It now consumes only LEFT/RIGHT/ESCAPE and passes everything else through.

Changed

• Removed an unreachable duplicate export slash subcommand.

[v2.16.0-release] - 05/30/2026

In-Game

• AutoEquip no longer loops swapping your weapons during combat, and now picks the best weapon setup for your spec, a two-hander or dual-wielding two one-handers, whichever scores higher.

Fixed

• AutoEquip thrash loop. Equipping a weapon fires BAG_UPDATE_DELAYED, which re-ran the sweep; the just-removed weapon (now in bags) re-qualified because a 2H-blocked off-hand slot (score 0) was treated as a free "empty" slot, so any 1H was force-equipped into it, kicking out the 2H, then the 2H beat the lone 1H and re-equipped, looping every 0.5s and broadcasting each swap to guild chat. Added self-retrigger suppression (ignores the BAG_UPDATE_DELAYED an auto-equip itself causes for 1.5s), an anti-oscillation guard (won't re-equip an item it just displaced for 10s), and 2H-occupancy awareness (a blocked off-hand is no longer treated as a free slot).

Changed

• AutoEquip now solves for the optimal weapon configuration instead of greedily filling the weakest slot. Each sweep scores every weapon (equipped + bags) with the active stat weights and picks the highest-scoring valid config: best two-hander alone, best two one-handers (dual-wield, gated on CanDualWield()), best one-hander + off-hand/shield, or main-hand alone, then equips toward it only when it beats the current weapons by the min-delta threshold. The decision is a fixed point, so it converges and stops. Planner and guards are covered by a unit test.

[v2.15.6-release] - 05/30/2026

In-Game

• GearMatic's bag upgrade markers no longer break your cast bar or spam errors during combat in dungeons, raids, and arenas.

Fixed

• v2.15.5 wrapped scanFrame/scanContainer in pcall to swallow the secret-boolean error, but pcall catches the error without stopping taint propagation: execution stayed tainted-by-GearMatic and the taint spread to Blizzard's secure CastingBarFrame (and was misattributed to other addons, e.g. "execution tainted by 'RepMatic'"). Confirmed via taint.log: BagOverlay.lua:135 boolean-tested a secret IsShown() ~130,000 times in an instance, poisoning the global ON_BAR_HIGHLIGHT_MARKS and the cast bar's animation tables. Real fix: scanFrame now skips forbidden frames and frames carrying any secret aspect (IsForbidden() / HasAnySecretAspect(), both SimpleFrameScriptObjectAPI base methods verified via the wow-api MCP) BEFORE the boolean test, so the secret value is never tested and no taint is generated. The full EnumerateFrames walk still runs, so third-party bag overlays (Bagnon, AdiBags, BetterBags, ElvUI, ArkInventory, Bagshui) keep working; only secret/forbidden frames are skipped.

[v2.15.5-release] - 05/29/2026

In-Game

• GearMatic's bag upgrade markers no longer cause errors in dungeons, raids, and arenas.

Fixed

• BagOverlay.refreshAll walks the whole frame tree via EnumerateFrames to find bag item buttons (retail bag buttons are matched by their methods, not fixed names, so this scan runs everywhere including instances). On retail 12.0 (Midnight) it reached secret-value frames such as the cooldown viewer and aura frames, where frame:IsShown() returns a secret boolean; boolean-testing it at line 140 threw attempt to perform boolean test on a secret boolean value (execution tainted by 'GearMatic'), once per such frame per scan tick (the reported 100x). Secret values only activate in instanced/combat content, which is why it only fired in dungeons, raids, and arenas. Wrapped each foreign-frame probe (scanFrame/scanContainer) in pcall, so any error from inspecting a frame GearMatic does not own (secret IsShown/IsVisible/IsObjectType, the earlier non-string GetName, or anything future) is caught and that frame is skipped, while the sweep continues and real bag buttons are still decorated. BagOverlay only colors its own overlay textures and calls no protected functions, so the brief secret-read taint is inert (no blocked actions). Closes the whole "poke a foreign frame on the secret-values API" class for the bag scan.

[v2.15.4-release] - 05/29/2026

In-Game

• GearMatic no longer causes errors while WoW's built-in damage meter is open.

Fixed

• BagOverlay.refreshAll walks the entire frame tree via EnumerateFrames (once per second on a poll, plus on bag events) and ran looksLikeBagItemButton on the retail damage meter's DamageMeterEntry rows. For those ScrollBoxListView buttons frame:GetName() returns a non-string (a FontString), so line 95's n:find("ContainerFrame") threw attempt to call a nil value (method 'find'), spamming once per meter row per update (the reported 113x). Guarded with type(n) == "string" before any string method, so meter rows are correctly rejected and real bag buttons (Blizzard ContainerFrame*, Bagnon, AdiBags, BetterBags, ElvUI, ArkInventory, Bagshui) are still detected. Hardened the same GetName()-assumed-string pattern in BagOverlay.decorateContainerFrame and in ItemTooltipHook (addLineBold, alreadyAdded), which concatenate the name into a _G[...] lookup, so no sibling variant can surface. Behavior is unchanged for valid names; only non-string returns now bail instead of crashing.

[v2.15.3-release] - 05/29/2026

In-Game

• GearMatic no longer interferes with unit tooltips in dungeons, raids, and arenas.

Fixed

• UnitTooltipHook.appendUnitInfo threw bad argument #1 to 'UnitIsPlayer' ... Secret values are only allowed during untainted execution on retail 12.0 (Midnight). tooltip:GetUnit() returns a secret unit token whenever the hovered unit's identity is sealed (combat against non-player/pet units, and dungeon/raid/arena instances), and passing that token to UnitIsPlayer (then UnitName) crashed during tainted addon execution via the TooltipDataProcessor.AddTooltipPostCall(Enum.TooltipDataType.Unit) path. Added an isSecretValue helper (nil-safe wrapper around the Mainline issecretvalue global) and now bail before any Unit API call when the unit token, or the resolved name/realm, is secret. Classic flavors are unaffected (issecretvalue is nil there, so the guard returns false and the legacy OnTooltipSetUnit path is unchanged). The mouseover summary only ever matched the player's own stored characters, so suppressing sealed units removes no working functionality, it only replaces the error with graceful silence in the contexts where the line could never resolve anyway.

[v2.15.2-release] - 05/28/2026

In-Game

• Item tooltips were listing each of your class specs twice. Every spec now appears once.
• Your equipped weapons now rank the way rings and trinkets do. With two one-hand weapons, one shows best and the other second best instead of both showing best. A two-handed weapon shows best.

Fixed

• ScaleImport.GetScalesForClass deduped class scales by specID when present and by name otherwise. A Pawn-imported scale (specID = spec index, name Pawn:...) and the bundled default for the same spec (specID = nil, name = spec) therefore never collided, so both rendered and every spec showed twice. The v2.15.0 retail default pool made this fire for any class that had both a Pawn import and a bundled default. Dedup now keys on the normalized spec name (falling back to specID, then name) so the two sources collapse to one row, with the user/Pawn scale winning. Bundled scales also get a resolved specID via GetSpecializationInfoForClassID so the rows sort in stable spec order.
• BestItems.GetRank for INVTYPE_WEAPON checked secondStripped fields that assignOneHandedBestItems never populates (it splits the two one-hand weapons into separate main-hand / off-hand rows that each carry only best), so a weapon could only ever return best or nil, never second, unlike trinkets and rings. GetRank now maps the main-hand row to best and the off-hand row to second, trusting the placement assignOneHandedBestItems already computed. On a tie the off-hand item wins the top slot (slot 16 is scanned before slot 17, so the later equal-scoring weapon wins the >= swap), so two equal-scoring weapons no longer both show best.

[v2.15.1-release] - 05/28/2026

In-Game

• The upgrade arrow on quest reward items now reflects your current spec only. An item that is only an upgrade for one of your off-specs no longer shows the arrow when it is not an upgrade for the spec you are actually playing.

Fixed

• QuestRewardHook.evaluateOne dropped its off-spec fallback for the current character. The reward-button chevron now fires only when the active (current-spec) scale delta is >= 0.5%; previously it looped over every class spec and lit the chevron if ANY spec cleared the threshold, so a Discipline priest saw the arrow on an item that was only a Holy/Shadow upgrade. The now-unused scalesForCurrentClass helper was removed. BagOverlay and LootHook were already current-spec-only (EvaluateForChar), verified unchanged.

[v2.15.0-release] - 05/28/2026

In-Game

• Retail gear scoring now uses real per-spec stat weights for all 39 modern specs. Every item now shows an accurate, distinct upgrade value for each spec instead of the same number for every item.
• Items that rank as your best or 2nd best for a slot now show the best / 2nd best badge in tooltips even when they sit in your bags or are offered as a quest reward, not only when already equipped. Bag or quest copies of the item you are already wearing still stay unmarked.

Changed

• tools/gm_emit_retail.py rewritten to parse references/pawn/AskMrRobot.lua (real differentiated per-spec weights) instead of ScaleTemplates.lua (the uniform primary=1 / every secondary=0.5 starter templates). Maps the 15 AMR stat names to GearMatic extractor keys (HasteRating->hasterating, CritRating->critrating, Versatility->versatility, MaxDamage->maxdamage, MovementSpeed->speed, Indestructible->indestructible, etc). Spec display names are read from the source's inline comments so newly added specs (e.g. the third Demon Hunter spec) need no map update.
• Scales/defaults.lua ["retail"] block regenerated: 40 specs across all 13 classes, each with its own differentiated weights. Replaces the prior placeholder stub block where every spec and every secondary stat shared identical weights, which made all items score the same.

Fixed

• ItemTooltipHook.lua: the per-spec tooltip rows no longer drop a spec when a non-equipped item ranks best or 2nd best in that scale's pool. BestItems.GetRank is now consulted for non-equipped items too; a badge renders unless the item shares its itemID with the item already equipped in that slot (preserving the v2.13.1 duplicate-suppression). Previously such items showed neither a badge (badges were equipped-only) nor a chevron (suppressed by the best/2nd guard), so the row vanished.

[v2.14.1-release] - 05/27/2026

In-Game

• Item tooltips show one row per spec for your class even when you have only imported a scale for one of them. A priest with only a Discipline scale now also sees Holy and Shadow rows, populated from the bundled defaults.
• Equipped items show the best / 2nd best badge again in tooltips, including the comparison tooltip that pops up when you hover a quest reward or a bag item. The previous fix that stopped duplicate badges on bag copies was over-tightened and accidentally suppressed the badge on the real equipped slot.

Fixed

• ScaleImport.GetScalesForClass now backfills ns.DefaultScales[flavor] entries for the character's class on top of the user-imported saved scales. Dedupes by specID (and by name as a fallback) so the same spec never renders twice. Restores the v2.13.0 multi-spec tooltip promise when the user only imported a subset of class specs.
• ItemTooltipHook.isCurrentlyEquippedLink now uses a fingerprint fallback (itemID:enchant:gem1:gem2:gem3:gem4:suffix) after the strict link match, with %d* (zero-or-more digits) on every field so Mists Classic 5.5.x links that serialize empty fields as :: (instead of :0: like older clients) still match. Equipped detection works again in compare tooltips, standalone equipped tooltips, and quest-reward shopping tooltips, while bag duplicates with different enchant/gem fragments still fail the fingerprint (so v2.13.1's duplicate-badge protection is preserved).

[v2.14.0-release] - 05/27/2026

In-Game

• Equip and upgrade alerts now color the item name by its actual rarity (green for uncommon, blue for rare, purple for epic, orange for legendary) instead of always purple.

Changed

• Alert.ShowGearEquipped and Alert.ShowGearUpgrade now derive the alert text color from the item's quality via C_Item.GetItemQualityColor, falling back to the user-configured fontColor when quality is unknown (uncached GetItemInfo). Alert.ShowGearDowngrade continues to use fontColorLoss (red) so the loss indicator stays distinct from rarity. itemIconAndName now also returns the quality alongside icon and name.

[v2.13.1-release] - 05/27/2026

In-Game

• Quest reward and bag duplicates of items you already have equipped no longer get a misleading best badge. Only the actual item in the equipped slot gets the badge.

Fixed

• isCurrentlyEquippedLink reverted to strict full-link match. The itemID-fallback added in 2.12.0 returned true for any item whose itemID matched something in an equipped slot — including quest-reward copies and bag duplicates. Strict link-match avoids the false positive; the rare link-format-differs case now falls through to the chevron path, where a 0% delta self-comparison suppresses the line cleanly.
• Badge gate in appendUpgradeLinesImpl requires equipped == true. BestItems.GetRank's stripped-link match also fired for duplicates (since strip ignores enchant, two copies of the same item with no enchants have identical stripped links). Just tightening isCurrentlyEquippedLink wasn't enough — GetRank had to be gated behind the equipped check too. Equipped items still get the correct best/2nd-best rank from GetRank, defaulting to "best" if GetRank returns nil (link-format edge cases).

[v2.13.0-release] - 05/27/2026

In-Game

• Item tooltips now show one line per spec for your class. Hover any item and you'll see a separate best / 2nd best / +X% upgrade / -X% downgrade line for each spec you have a scale for (Elemental, Enhancement, Restoration, etc), each with its own spec icon.
• Switching specs in-game now auto-updates which scale is treated as current. Swap from Restoration to Elemental and the chevron/badge follows; no need to run a slash command after every spec change.
• Auto-equip still respects only the current spec, never your off-spec lines.

Added

• SI.GetScalesForClass(charKey) in ScaleImport.lua. Returns every scale in GearMaticDB.scales[charKey] whose class field matches the character's class, sorted by specID ascending. Filters out the _active sentinel key.
• iconForSpec(class, specIndex) helper in ItemTooltipHook.lua resolves any spec's tooltip icon through GetSpecializationInfoForClassID(classID, specIndex) via a local CLASS_NAME_TO_ID map (WARRIOR=1 .. EVOKER=13). Falls back to the class-circles icon when the API doesn't return a per-spec result.
• Per-spec tooltip rows. appendUpgradeLinesImpl now loops over SI.GetScalesForClass(currentKey) instead of evaluating only the active scale. Each scale gets its own row: kind = "badge" (best / 2nd best) when BestItems.GetRank returns non-nil OR the item is currently equipped, otherwise kind = "chevron" from EvaluateAgainstScale with the threshold |delta| >= 0.5%. Rows pushed to the existing rows table and rendered with the same render loop that previously handled chevron-only rows.

Fixed

• SI.GetActiveScale ordering inverted. Previous order: bag._active → spec match → any class match. New order: spec match → bag._active → any class match. The old order meant swapping specs left _active pointing at the previous spec's scale, so the chevron/badge stayed on the wrong spec. The new order detects the current spec via getCurrentSpecIndex() and returns the matching scale first; _active is now a fallback for cases where no per-spec scale exists.
• Off-spec rows on the same character no longer show Charname (Spec): parens. formatLine and formatBadge now select the row icon from eval.scale.specID / scale.specID when available, so the spec icon comes from the scale, not from "is this the current spec?" The isCurrent flag is now strictly "same character" — current-spec AND off-spec on the player's own char both set isCurrent = true and use the no-name format; only different-character rows (multi-char tooltip) get the alt format.
• Green border on upgrades still works under multi-spec render. The old code referenced a single currentEval variable that no longer exists; replaced with a fresh EvaluateForChar lookup right before the border check (current spec only, by design).

[v2.12.0-release] - 05/27/2026

In-Game

• Currently-equipped items now show a best or 2nd best badge on the tooltip instead of the +X% upgrade / -X% downgrade percentage. Trinkets included. Bag items still show the percentage chevron as before. PvP and PvE gear treated the same way once equipped.

Added

• BestItems.GetRank(scale, equipLoc, itemLink) in Scoring/V2/BestItems.lua. Returns "best" / "second" / nil by stripping the candidate's enchant and comparing against row.bestStripped / row.secondStripped in the pool. Special-cases INVTYPE_WEAPON to check both INVTYPE_WEAPONMAINHAND and INVTYPE_WEAPONOFFHAND rows (one-handed weapons can sit in either slot). General path covers single-slot and the rest of TWO_SLOT_LOCS.
• Trinkets are now tracked in the BestItems pool. Removed INVTYPE_TRINKET from SKIP_EQUIPLOCS and added to TWO_SLOT_LOCS (two trinket slots, slot 13 + 14). Equipped trinkets now get the best / 2nd best badge.
• formatBadge(scale, rank, isCurrent) in ItemTooltipHook.lua. Renders the badge line with the active spec name (class-colored) plus the rank text from new L["tooltip_best"] = "%s: |cff8ec3e6best|r" / L["tooltip_second_best"] = "%s: |cff8ec3e62nd best|r" (light-blue badge color, distinct from the chevron's green/red).

Fixed

• appendUpgradeLinesImpl always shows a badge on equipped items. Rank comes from BestItems.GetRank when the pool has the item indexed; if the item is currently equipped but GetRank returned nil (link-format mismatch, brand-new item the pool hasn't seen yet, etc), rank defaults to "best" so the slot is never blank. Old isCurrentlyEquippedLink early-return now only fires AFTER the badge gate, which means it never actually triggers — equipped items always have a rank one way or another.
• isCurrentlyEquippedLink now matches by itemID as a fallback. Full-link == comparison can fail when tooltip:GetItem()'s link format differs slightly from GetInventoryItemLink("player", slot)'s format (enchant slot ordering, bonus IDs, upgrade tags). Fallback parses item:(%-?%d+) from both links and compares the integer itemID; matches if either path agrees.
• assignOneHandedBestItems preserves bestStripped when rewriting pool["INVTYPE_WEAPON"] into pool["INVTYPE_WEAPONMAINHAND"] and pool["INVTYPE_WEAPONOFFHAND"]. Previously only best and bestLink were carried over, so GetRank's row.bestStripped == stripped check always failed for one-handed weapons and the equipped weapon never matched as "best". secondStripped carried over too where applicable.

[v2.11.0-release] - 05/26/2026

In-Game

• Weapons now correctly factor their damage range into upgrade scoring. Previously only damage-per-second contributed; daggers, swords, and other weapons looked far worse than they actually were. DPS specs see the biggest swing — a weapon's mainline +Min/+Max damage now feeds the scale weights the same way Intellect, Agility, etc do.
• New /gm audit slash command: hover any item and run it to see exactly how each stat in your active scale contributes to the score, which stats are weighted but not extracted from the item, and which stats are extracted but ignored by your scale.
• Healer items from Vanilla / TBC / Wrath now parse the +Healing and +Spell Damage tooltip lines instead of dropping them.

Added

• /gm audit [link|itemID] slash subcommand. New Debug.AuditItem in Debug/Score.lua. Resolves item via hover cache, GameTooltip, ItemRefTooltip, ShoppingTooltip, or inline arg. Walks the active scale's weights table alphabetically; for each weight, prints key w=<weight> v=<extracted> contrib=<weight*value> or yellow-flags as GAP when weighted-but-zero. Suppresses contribution display for -1000000 ignore-sentinel weights. After the weighted-stats section, lists extracted-but-not-in-scale orphans. Final two lines print the audit total alongside Score.ScoreItem result so any divergence (socket potential, AP redirect, Wrathion bonus) is visible. Appends raw tooltip lines at the end for diagnosing remaining extraction gaps.
• Weapon damage range tooltip extraction. New Norm.ExtractDamageRange(text) in Scoring/V2/StatNormalize.lua parses "N - N Damage" lines via three patterns with progressively looser anchors (^%s*...%s*$, ^%s*..., no anchors). Returns (minDmg, maxDmg) as two numeric returns. Wired into Extract.ReadViaTooltip to push stats.mindamage and stats.maxdamage. Pawn-style scales weight mindamage = maxdamage heavily on weapons; previously these were always 0 in the extracted stats table, undervaluing every weapon vs scoring.
• Vanilla/TBC healing + spell-damage tooltip extraction. Norm.ExtractHealing(text) matches +N Healing plus Equip: Increases healing done by spells and effects by up to N and Equip: Increases healing done by magical spells and effects by up to N. Norm.ExtractSpellDamage(text) matches the equivalent damage-side patterns. Both wired into ReadViaTooltip. ITEM_MOD_SPELL_HEALING_DONE_SHORT API mapping flipped to healingpower (matches PawnIntegration's Hp/HealPower alias canonical key) so API and tooltip paths converge on the same key.

Fixed

• Extract.Read now uses API path as source of truth. Previously on retail the merge logic preferred ReadViaTooltip whenever it returned a non-empty table, which silently dropped every API-only stat (Versatility, Avoidance, Leech, Speed, Indestructible were all missed pre-2.10.0 because of this). Now Extract.Read always starts with the full API result, then supplements only for TOOLTIP_ONLY_KEYS = {weaponspeed, mindamage, maxdamage, redsocket, yellowsocket, bluesocket, metasocket, prismaticsocket, cogwheelsocket, shatouchedsocket, indestructible}. Any other tooltip-extracted key only fills in when the API didn't provide it (Classic flavors where API may be sparser). Adding a new class scale now Just Works because the API path knows every stat on every item for every class on every flavor; no per-stat pattern audit needed.
• Multi-return-value collapse bug in Extract.ReadViaTooltip. The previous wiring local minDmg, maxDmg = S2.Normalize.ExtractDamageRange and S2.Normalize.ExtractDamageRange(line) collapsed Lua's two-return value to one because the and operator only forwards a single value. ExtractDamageRange correctly returned (4, 8) for "4 - 8 Damage" but maxDmg was always nil, the if minDmg and maxDmg guard always failed, and weapon damage was never pushed to the stats table. Replaced with explicit if X then local a, b = X(line) blocks.
• StatNormalize tooltip patterns for modern tertiaries (Versatility, Avoidance, Leech, Indestructible, movement Speed) shipped in 2.10.0 stay in place but are now mostly defensive — the API path covers these on retail, and the tooltip patterns serve as fallback for any flavor where the API path doesn't (Classic Era resists, etc).

[v2.10.0-release] - 05/26/2026

In-Game

• Auto-sell junk (grey-quality items) at vendors. Defaults on. Toggle in /gm settings -> General -> Vendor automation.
• Auto-repair at vendors. Uses guild bank funds first if your rank allows and the withdrawal limit covers the cost; otherwise spends personal gold. Defaults on. Toggle in the same panel.
• Mark any non-grey item as junk so it sells alongside grey-quality items. Two ways: SHIFT+RIGHT-CLICK the item in your bag, or /gm junk add <link> / /gm junk remove <link> / /gm junk list / /gm junk clear.
• Items with Versatility, Avoidance, Leech, Indestructible, or movement Speed now score correctly. Previously these stats were being dropped from item evaluation, making some items look like bigger downgrades than they actually were (e.g. a dagger with +4 Versatility was being scored as if it had none).
• Fixed an error message that appeared on retail every time you mouseovered another player.

Added

• Vendor automation module (VendorAutomation.lua). New CreateFrame "GearMaticVendorAutomationFrame" registers MERCHANT_SHOW and MERCHANT_CLOSED. On show, fires VA.AutoRepair() then VA.SellJunk(). On close, cancels any in-flight sell queue.
• Throttled auto-sell. VA.SellJunk walks bags 0-4 once, queues every slot with quality == 0 OR VA.IsJunk(itemID) true, then drains the queue via C_Timer.NewTicker(SELL_INTERVAL=0.2) calling C_Container.UseContainerItem. The 0.2s spacing stays under WoW's per-second action throttle. Re-reads container info before each sell so items moved/equipped mid-queue are skipped. Prints "auto-sold N junk items for Xg Ys Zc" summary on completion.
• Guild-bank-first auto-repair. VA.AutoRepair checks CanMerchantRepair, then CanGuildBankRepair + GetGuildBankWithdrawMoney (with IsInGuild guard). Calls RepairAllItems(1) to draw from guild funds when both allowed and the bank limit (or -1 = unlimited) covers GetRepairAllCost(); otherwise RepairAllItems() for personal funds. Prints "auto-repaired for X (guild/personal funds)" summary, or "auto-repair skipped: need X, have Y" when personal funds short.
• Per-character junk-list rules. GearMaticDB.junkRules[charKey] is an itemID set. VA.MarkJunk(itemID), VA.UnmarkJunk(itemID), VA.IsJunk(itemID), VA.ListJunk(), VA.ClearJunk() manage entries. Sell loop checks quality == 0 OR VA.IsJunk(itemID) so flagged whites sell alongside greys.
• /gm junk slash subcommand. /gm junk add <link|itemID>, /gm junk remove <link|itemID> (alias rm), /gm junk list, /gm junk clear. Item link parsing extracts itemID from the item:N substring, or accepts a bare numeric ID.
• SHIFT+RIGHT-CLICK on bag items toggles junk status. hooksecurefunc("ContainerFrameItemButton_OnModifiedClick", ...) fires only when the global exists (Classic + Retail both have it). Resolves bag/slot via button:GetBagID() / button:GetID() with fallbacks to button.bag / button.slot / button:GetParent():GetID(). No conflict with default WoW behavior (no native action on that combo for bag items).
• GUI toggles in General tab. New "Vendor automation" inline group at order=25 holds autoSellJunk and autoRepair toggles, both full-width. Both default true in DEFAULT_SETTINGS.

Fixed

• Tooltip parser missed Versatility, Avoidance, Leech, Indestructible, and movement Speed. Scoring/V2/StatNormalize.lua LINE_PATTERNS built patterns only for classic-era secondaries. On retail Extract.Read prefers ReadViaTooltip when non-empty, so these stats were silently dropped even though ReadViaAPI had them. Symptom: weapons with Versatility scored ~5 points per stack lower than they should have. Added five add(withValue(ITEM_MOD_*), key) calls plus one add(bare(...)) for Indestructible. Falls back to English literals when the ITEM_MOD_* global doesn't exist on a flavor.
• OnTooltipSetUnit HookScript error on retail Dragonflight+. UnitTooltipHook.lua now detects TooltipDataProcessor.AddTooltipPostCall + Enum.TooltipDataType.Unit and uses the modern API on 10.0+; pcall-falls-back to HookScript("OnTooltipSetUnit") on Classic flavors. The legacy handler was removed from GameTooltip in 10.0 and was throwing "Doesn't have a OnTooltipSetUnit script" on every retail login.
• release.sh was nuking install-dir symlinks. The post-package sync did unconditional rm -rf "$target"; cp -R "$STAGED_DIR" "$target" on every flavor dir, replacing any pre-existing symlink with a copy of the packaged build. Now skips the copy when [ -L "$target" ] (target is already a symlink), preserving live-edit setups while still copying for flavors that don't have a symlink.

[v2.9.0-release] - 05/26/2026

In-Game

• Weapons that grant raw +Attack Power (older expansion gear, heirlooms) now contribute to your DPS-spec scoring correctly on retail. Previously the value was being silently dropped.
• New /gm export scale <name> command outputs a portable stat-weight string you can share with other players or paste into other stat-weight tools.
• Fixed an error that appeared when mousing over players on retail.

Added

• Public addon API for plugin scales. Three new functions on the GearMatic global: AddPluginScale(providerName, scaleName, classID, specID, weights) registers a class/spec-tagged stat-weight scale at runtime; RemovePluginScale(providerName, scaleName) clears it; ListPluginScales([providerName]) enumerates current-character plugin scales. Plugin scales persist in GearMaticDB.scales[charKey] under <provider>:<scale> with source = "plugin:<provider>", coexisting with Pawn-imported and user-pasted scales. Weights accept either lowercase canonical keys or Pawn-style CapitalCase via the existing normalisePawnKey path.
• /gm export scale <name> slash command. Pawn.ExportScale serializes a stored GearMatic scale back to standard Pawn import-string format. Reverse-maps canonical lowercase keys to Pawn CapitalCase via a static table, with a live PawnCommon.Scales[name].Values probe overriding when Pawn is loaded so re-exports preserve the original key spelling. -1000000 weights export as =X (Pawn's PawnIgnoreStatValue sentinel). Class= and Spec= lines emitted from the scale's stored class/specID. Embedded double-quotes in the scale name get stripped because Pawn's parser regex can't handle them; the slash output prints a note documenting the rename.
• AP→max(STR, AGI) redirect on retail. Scoring/V2/Score.lua:113-121 routes any attackpower-keyed weight through whichever of strength or agility carries the larger weight in the active scale. Scoring/V2/StatExtract.lua adds AP_SKIP_KEYS_RETAIL = {attackpower, rangedattackpower, feralattackpower} and skips those keys in ReadViaAPI so synthesized retail AP doesn't double-count when the redirect applies. Merge guard at lines 162-167 only fires when the API path wins so real +N Attack Power tooltip text on legacy gear is preserved.

Fixed

• OnTooltipSetUnit HookScript error on retail. UnitTooltipHook.lua now detects TooltipDataProcessor.AddTooltipPostCall + Enum.TooltipDataType.Unit and uses the modern API on Dragonflight+ (10.0+); falls back to the legacy HookScript("OnTooltipSetUnit") on Classic flavors via pcall. The legacy script handler was removed from GameTooltip in 10.0 and was throwing "Doesn't have a OnTooltipSetUnit script" on every retail login.

[v2.8.0-release] - 05/25/2026

In-Game

• Wands now correctly show an upgrade line and score on Mists Classic. They were silently skipped on flavors where the old ranged slot doesn't exist.
• Items that are an upgrade for your current spec now show with a green tooltip border, a quick visual cue to help you spot upgrades at a glance.
• Items with empty sockets factor those sockets into the upgrade calculation. A socketable piece now correctly outranks an identical socketless one.
• On Mists Classic, items eligible for the legendary cloak quest line get a bonus socket factored into scoring.
• Repeated hovers of the same item feel snappier; an internal cache speeds up the second look.
• Bag changes, vendor sells, and spec swaps refresh stale scoring automatically.

Added

• Wrathion PrismaticSocket bonus on Mists Classic. New Scales/wrathion_items_mists.lua carries ~179 itemIDs from Heart of Fear, Terrace of Endless Spring, Throne of Thunder, and BS-craftable epics, exposed as ns.WrathionUpgradeableItemIDs. Scoring/V2/Sockets.lua adds Sockets.WrathionAdjustedStats(stats, itemLink) which returns a shallow copy with prismaticsocket = (existing or 0) + 1 when the itemID is eligible. Score.ScoreItem consults this right after Extract.Read.
• Basic socket potential scoring. Sockets.PotentialFor(stats, scale) now returns empty * gemAmount * bestGemmableWeight instead of the prior stub 0. Counts empty red/yellow/blue/prismatic sockets (meta is excluded; metasocketeffect carries its own weight). gemAmount per flavor: Mists=320, Cata=240, Wrath=60, TBC=12; 0 elsewhere. Best stat is the max weight across strength, agility, intellect, spirit, stamina, critrating, hasterating, masteryrating, hitrating, expertiserating, dodgerating, parryrating, spellhitrating, spellpower, attackpower.
• 200-entry FIFO item-parse cache. New cacheGet / cachePut / cacheClear helpers in Scoring/V2/StatExtract.lua cap at CACHE_MAX = 200, keyed on itemLink. FIFO eviction via table.remove(order, 1). Extract.Read returns the cached table on hit (skipping both ReadViaAPI and ReadViaTooltip) and inserts the result on miss. Measured 0.90ms miss vs 0.001ms hit on a Mists epic. ns.StatExtract_ClearCache() exposed for external invalidation.
• Green tooltip border on upgrades. ItemTooltipHook.lua adds setTooltipBorderUpgrade / resetTooltipBorder helpers. setTooltipBorderUpgrade tries tooltip.NineSlice:SetBorderColor(0, 1, 0, 1) first, falls back to tooltip:SetBackdropBorderColor(0, 1, 0, 1). Triggered when the CURRENT character's eval delta is >= 0.5 percent; alt rows don't trigger border. Reset via OnHide HookScript on GameTooltip, ItemRefTooltip, ShoppingTooltip1, ShoppingTooltip2. Gated by GearMaticDB.settings.colorTooltipBorder (defaults true).
• Three more BestItems invalidation events. Scoring/V2/BestItems.lua registers ITEM_LOCKED, MERCHANT_UPDATE, PLAYER_SPECIALIZATION_CHANGED (Mists+), and ACTIVE_TALENT_GROUP_CHANGED (Wrath/Cata). Latter two are pcall-protected via pcall(refreshFrame.RegisterEvent, refreshFrame, ...) for flavors that don't support them.
• /gm wrathion <itemID> diagnostic. Mists-only slash subcommand prints listed=, with=, without=, diff= for the supplied itemID, toggling ns.WrathionUpgradeableItemIDs temporarily to compare scores with and without the Wrathion bonus.

Fixed

• Wand-slot bug on Mists+ flavors. Compat.SlotsForEquipLoc("INVTYPE_RANGEDRIGHT") and ("INVTYPE_RANGED") now return { 16 } on flavors where HasRangedSlot is false (Mists 5.0+, retail). Previously the function returned nil, EvaluateForChar got no slot, and wands silently dropped out of the tooltip upgrade pipeline. Wand of the San'layn and other WotLK-era wands report INVTYPE_RANGEDRIGHT from GetItemInfo even on Mists Classic where the game equips them into slot 16.
• Quest reward overlay threshold parity. QuestRewardHook.lua evaluateOne threshold lowered from >= 1 to >= 0.5 percent for both the current-spec eval and the multi-scale fallback, matching the tooltip-upgrade-line threshold.
• Pawn scale converter rejected scales with any zero weight. PawnIntegration.convertPawnScale now accepts a Pawn scale as long as at least one weight is positive; previously, a scale with Stamina = 0.1 and other strong positives was passed through but any scale with even one zero-or-negative weight returned nil.
• Compare.lua baseline now uses BestItems pool for current char. baselineForCurrentChar calls S2.BestItems.CompareBaseline(scale, equipLoc) first when the character is the player's current character, falling back to the worst-equipped-slot lookup otherwise. This matches the broader pattern of comparing against your single best-in-slot baseline.
• Self-comparison early-out in evaluateImpl. Compare.evaluateImpl early-returns nil when the candidate is already the best or second-best for that slot, preventing the item-vs-itself baseline from generating misleading positive deltas.

Changed

• Wrathion bonus is now copy-on-apply. Replaced Sockets.ApplyWrathionBonus(stats, itemLink) (in-place mutator) with Sockets.WrathionAdjustedStats(stats, itemLink) (returns either the input table or a shallow copy with prismaticsocket+1). Required so the LRU-cached raw stats table from Extract.Read isn't mutated on each scored hover; the cache stays clean.
• StatExtract cache cleared alongside BestItems cache. BestItems.Invalidate now also calls ns.StatExtract_ClearCache() so equipment / bag / vendor / spec events flush both caches together.

Diagnostics

• /gm wrathion <itemID> prints whether an itemID is Wrathion-eligible plus a with/without score comparison.

[v2.7.0-release] - 05/25/2026

In-Game

• Items your class can't equip (a wand on a Warrior, a 2H mace on a Rogue, a polearm on a Mage, etc) no longer falsely score as upgrades.
• On retail, the GearMatic upgrade line now appears on bag item tooltips and the green up-arrow now appears on bag item icons. Both were missing on the new combined bag UI.
• Auto-equip is smarter: it won't try to swap your shield for a 1H weapon when your spec can't dual-wield, and it won't claim it equipped something when the game silently blocked the swap. Duplicate "equipped X" toasts on /reload are gone.
• Removed the login pop-up nag on retail. Retail scoring runs on GearMatic's own bundled stat weights.

Added

• Class weapon-proficiency gate. New Scales/weapon_proficiency.lua carries a per-class banned-subclass table keyed by Blizzard subClassID integers (0..19 from Enum.ItemWeaponSubclass). Score.ScoreItem consults the gate via C_Item.GetItemInfoInstant for classID == 2 items and short-circuits to (0, false) when the class can't wield that subclass. Runtime patch adds [0] Axe1H to ROGUE's banned set on Classic / TBC.
• Right-hand tooltip text extraction. StatExtract.readTooltipLinesViaDataAPI and readTooltipLinesViaFrame now walk both leftText and rightText (and TextRight<N> font strings) per line. StatNormalize adds a ^STAT_SPEED %s+(N.NN)$ pattern that captures weapon attack speed into stats.weaponspeed. Score.ScoreItem applies the SpeedBaseline subtraction when the active scale defines speedBaseline. Dormant on every bundled scale today, ready for future SpeedBaseline scales.
• Per-method hooksecurefunc fan-out on retail. ItemTooltipHook.lua now hooks 21 named GameTooltip:Set* methods (SetBagItem, SetInventoryItem, SetHyperlink, SetItemByID, SetBuybackItem, SetMerchantItem, SetLootItem, SetLootRollItem, SetQuestItem, SetQuestLogItem, SetSendMailItem, SetInboxItem, SetTradePlayerItem, SetTradeTargetItem, SetTradeSkillItem, SetGuildBankItem, SetHeirloomByItemID, SetRecipeResultItem, SetVoidItem, SetVoidDepositItem, SetVoidWithdrawalItem) plus ItemRefTooltip:SetHyperlink, :SetItemByID, and ShoppingTooltip1/2:SetHyperlink, in addition to the existing TooltipDataProcessor.AddTooltipPostCall(Enum.TooltipDataType.Item, ...) path. Bag tooltips on retail 11.0+'s combined bag UI do not route through TooltipDataProcessor for the candidate-side tooltip, so the line was missing pre-2.7. Per-method hooks resolve the link from the call args and dispatch to the same appendUpgradeLines flow. Re-entrancy guarded by tooltip.__gmInUse + alreadyAdded.

Fixed

• Bag overlay missing on retail combined bag. BagOverlay.looksLikeBagItemButton and getButtonItemLink now recognize the modern ItemButton mixin via :GetBagID() and :GetSlotAndBagID(), on top of the legacy .bag / .info.hyperlink checks. Retail 11.0+ ContainerFrameCombinedBagsSlot<N> buttons now get the green up-chevron overlay.
• Tooltip line hanging outside the tooltip border on retail. appendUpgradeLinesImpl now calls tooltip:Show() on every flavor after addLineBold, not only on Classic. Per-method hooksecurefunc on GameTooltip:SetBagItem fires after the tooltip finished its layout pass; without an explicit Show() the backdrop did not grow to wrap the new line.
• Auto-equip toast printing even when the equip silently failed. AutoEquip.RunSweep now compares GetInventoryItemLink(targetSlot) before vs after EquipCursorItem and only counts the equip + prints the toast when the slot's item id flipped to the candidate's id. EquipCursorItem clears the cursor even on a silent rejection (item-class restriction, ilvl gate), so the prior if CursorHasItem() then ... else equipped+1 check produced false positives.
• Auto-equip targeting the shield slot for a 1H weapon. New slotHoldsShieldOrHoldable(17) guard in findBestSwapForLink restricts INVTYPE_WEAPON candidates to {16} when the off-hand currently holds an INVTYPE_SHIELD or INVTYPE_HOLDABLE. The lower-score-wins picker was choosing slot 17 (shield) for a 1H weapon on Resto Shaman because Resto's intellect-heavy scale rates shields lower than 1H weapons; the resulting EquipCursorItem(17) silently failed because Resto can't dual-wield.
• Duplicate auto-equip toast on /reload. New sweepPending / sweepInProgress flags in the OnEvent handler ensure only one sweep is scheduled or running at a time. BAG_UPDATE_DELAYED + PLAYER_ENTERING_WORLD both schedule a sweep on /reload, and the new combined bag's BAG_UPDATE_DELAYED can fire multiple times in quick succession; racing sweeps were each finding the same upgrade in flight and printing the toast twice.
• /gm score silent on retail. Debug/Score.lua installHooks was calling GameTooltip:HookScript("OnTooltipSetItem", ...) at file load time; retail 10.0.2+ removed the OnTooltipSetItem script handler, the HookScript threw, file load aborted, and ns.Debug.Score.RunForHoveredItem was never assigned. Every HookScript is now pcall-guarded and a TooltipDataProcessor.AddTooltipPostCall(Enum.TooltipDataType.Item, ...) parallel registration keeps the link-cache working on retail.

Changed

• Bag overlay chevron now sits 5px inside the item's top-right corner (was 1px outside) for visual breathing room against the new bag UI's slot icons.
• Removed the retail login nag that prompted players to install a third-party scoring addon. Retail bundled scales (39 specs across 13 classes) drive scoring directly. Removed L["nag_retail_pawn"] from every locale and dropped the C_Timer.After(5, function() print(...) end) block in Core.lua:OnPlayerLogin.

Diagnostics

• /gm score dumps S2.Extract.Read, Extract.ReadViaAPI, and Extract.ReadViaTooltip results per item so the stat pipeline can be inspected end-to-end.
• /gm score prints the tooltip-line gate states (autoEnabled, Compat.CanWearItem, isCurrentlyEquipped, minLevel / playerLevel / equipLoc / classID / subclassID) so a missing GearMatic line can be localised to a specific gate.

[v2.6.0-release] - 05/25/2026

In-Game

• Quest reward items now show a green chevron on every icon that's an upgrade for any of your character's specs. If the item is wearable only by another character on your account, the chevron shows yellow instead.
• Tooltip upgrade line is cleaner: a single arrow instead of doubled, and duplicate lines from refresh cycles no longer stack.
• Auto-equip is now ON by default for new characters. You can still turn it off in Settings.
• Two unused toggles were removed from the Stat Import tab in Settings.

Added

• Quest reward overlay rewrite (Pawn-aligned). QuestRewardHook.lua now hooks QuestInfo_Display with a template.elements filter for QuestInfo_ShowRewards, mirrors Pawn's positional indexing (choices first 1..N, statics N+1..N+M), iterates both GetNumQuestChoices and GetNumQuestRewards, supports the quest-log pane via GetNumQuestLogRewards / GetNumQuestLogChoices / SetQuestLogItem, and uses a hidden scanner tooltip's SetQuestItem / SetQuestLogItem + :GetItem() to bypass the 9.0+ GetQuestItemLink bug. Buttons resolved via QuestInfo_GetRewardButton(QuestInfoFrame.rewardsFrame, idx) with _G name fallback for classic.
• Multi-spec quest reward evaluation. New Compare.EvaluateAgainstScale(scale) and S2.EvaluateAgainstScale bypass the off-spec gate so an item that's an upgrade for any of your class's scales (current spec, alt specs, bundled defaults) gets the overlay - not just the active spec.

Fixed

• Tooltip duplicate-line dedup. appendUpgradeLines now skips appending if a "GearMatic" header is already present in the tooltip; prevents TooltipDataProcessor refresh cycles from stacking duplicate upgrade lines on the same hover.
• Quest reward overlay was only marking ONE "best winner". Dropped the priority/armor-tie-break filter; every wearable upgrade now gets the green chevron, matching the Pawn UX.
• Quest reward overlay missed static-only rewards. The old code's if count <= 1 then return end killed decoration whenever there were no choice items - many quests give all rewards as static and got nothing.

Changed

• Tooltip chevron uses a single up/down arrow (was doubled) to match Pawn's tooltip visual.
• Quest reward chevron overlay anchor shifted from -2, -2 to -7, -2 so the icon sits 5px further inside the button's right edge.
• Tooltip chevron texture has a -5 inline offset so the arrow sits flush against the spec text instead of leaving a gap.
• autoEquipUpgrades default flipped from false to true. New characters opt into the auto-equip behavior by default; existing characters keep whatever value is already in SavedVariables.
• Removed GearMaticDB.settings.deferToPawn (Settings row, Core default, and the BagOverlay guard that consulted it). The bag-overlay path now always evaluates via our own scoring, no Pawn-defer wrapper.
• Removed GearMaticDB.settings.preferPawnWeights (Settings row, Core default, and the ScaleImport.GetActiveScale branch that auto-picked a Pawn scale when both addons were loaded). Active scale now always comes from the character's own bag (_active first, then any class-matching scale, then bundled defaults). The bestPawnScaleFor helper is removed as it had no remaining callers.

[v2.5.0] - 05/25/2026

In-Game

• Retail (The War Within) is supported. Every modern spec across all 13 classes ships with bundled stat weights. Hover an item and the GearMatic line shows the upgrade % for your current spec.
• Items restricted to a different spec (the "For X specialization" line in the tooltip) no longer score as an upgrade for your current spec.
• The upgrade line in the tooltip is now compact and easier to scan: bold text, your spec name in your class color, the colon in your class color, and an up/down arrow showing direction.
• Sidegrades (0% lines) are no longer shown. The tooltip only adds a line when the item is meaningfully better or worse.
• Paste a stat-weight string from Raidbots or Wowhead with /gm import ( ... ). Works on every flavor.
• Revert to the bundled defaults with /gm reset, or just drop a pasted scale with /gm clear pasted.
• New /gmc slash command opens a copyable window with the last 200 chat lines, for getting chat output out of WoW.

Added

• Retail flavor TOC. GearMatic_Mainline.toc (Interface 120005) wired into the BigWigs packager so retail builds populate alongside Classic flavors.
• Bundled Pawn-parity weights for all 39 modern retail specs, including Evoker (Devastation / Preservation / Augmentation) and Demon Hunter (Havoc / Vengeance). Generated from Pawn's ScaleTemplates.lua via tools/gm_emit_retail.py with verified zero weight drift across all 39 specs.
• Tertiary stat extraction: leech, speed, avoidance are now read from item tooltips and scored if the active scale weights them.
• Universal Pawn-format import (( Pawn: v1: Name=...: stat=value, ... )) handled on every flavor. Pasted scales tagged with source = "pasted" so the companion-program skull rule still distinguishes them from gearmatic-sim scales.
• Reset / clear slash commands: /gm clear pasted drops the current character's pasted scale and reverts to the bundled default. /gm reset clears every imported / sim / pasted scale on the current character.
• /gm copychat / /gmc opens a scrollable EditBox with the last 200 chat lines, color codes stripped, highlight-all preselected.

Fixed

• Retail tooltip line wasn't rendering at all because GameTooltip:GetItem() returns nil on 10.0.2+. Switched the retail hook path to TooltipDataProcessor.AddTooltipPostCall(Enum.TooltipDataType.Item, ...) with re-entrancy guarding to stop the recursion loop that froze the client.
• Retail stat extraction now uses C_TooltipInfo.GetHyperlink as the primary source (matches what Pawn reads) with the legacy frame scanner as a Classic fallback. The previous mix of GetItemStats + frame scanner produced inflated numbers because it counted hidden API-only stats that Pawn never sees.
• Off-spec items: gate consults C_Item.GetItemSpecInfo first and falls back to a tooltip-text scan ("For X specialization") for low-level quest rewards that ship without spec metadata.
• Baseline math: the worst-equipped slot scan now skips empty slots and clamps near-zero baselines via an epsilon, so a single low-armor off-hand can't blow the upgrade % up into the hundreds.
• 1H weapon comparison: when the off-hand currently holds a shield or holdable, the baseline scan excludes slot 17 so a 1H weapon is compared against the main-hand baseline alone (matches Pawn's UnusableStats = { "IsOffHand" } shape).
• Pawn-import alias keys: import paths map resiliencerating -> resilience, armorpenrating -> armorpen, and route ranged / feral attack power into their dedicated extractor keys instead of collapsing into the generic attackpower bucket.

Changed

• Tooltip line format: spec icon + class-colored spec name + class-colored colon + double up/down arrow + bold pct text. Drops the prior wordy "for current" phrasing in favor of the compact <icon> <Spec>: >>+X% upgrade shape.
• references/pawn/ checked into the repo as the canonical reference for parity work (Pawn 2.13.11 source).

[v2.4.7-release] - 05/24/2026

In-Game

• The upgrade % shown in the tooltip is now more accurate on Anniversary, Era, SoD, Classic and TBC characters.
• Druid Feral DPS and Feral Tank now have their own bundled stat weights on Anniversary, Era, SoD, Classic and TBC (previously only Balance and Restoration shipped).

Fixed

• Full Pawn parity for the bundled TBC and Vanilla (Anniversary / Era / SoD) scales. The prior blocks used import-alias stat keys (resiliencerating, armorpenrating) that never matched the keys GearMatic's stat extractor actually produces (resilience, armorpen), so those weights silently scored zero. Ranged AP and Feral AP were stored under attackpower instead of the extractor's rangedattackpower / feralattackpower. Vanilla armor-penetration weights were stored as the raw Pawn coefficient instead of the rating-per-percent expanded value (e.g. Arms armorpen was 1.1 instead of 3.75 * 1.1 = 4.125). Regenerated both blocks verbatim from Pawn's ClassicHawsJon templates with the correct extractor keys, added the tie-breaker stats Pawn ships (per-school resists, hp5, mana, defenserating, dodgerating, parryrating, metasocketeffect, allresist), and added the missing Druid Feral DPS + Feral Tank specs. Verified 0 weight drift against Pawn across all 28 TBC + 28 Vanilla + 34 Mists specs.

[v2.4.6-release] - 05/19/2026

Changed

• Excluded *.png source image files from the packaged .zip via .pkgmeta ignore. WoW only loads .tga at runtime; the PNGs (Logo.png 2.7 MB, Textures/GearMatic-Medallion.png 2.2 MB) were source-only and added ~5 MB of dead weight to every download.

[v2.4.5-release] - 05/19/2026

In-Game

• Your spec now shows up correctly on Mists Classic (Disc Priest, Resto Druid, Prot Warrior, etc). The loadout window header, the /gm browser, and stat-weight matching all read the right spec again.
• Discord link in General Settings now points at the shared GearMatic / CritMatic / RepMatic Discord server.

Fixed

• Spec detection on Mists Classic 5.5.x (_classic_ flavor). Blizzard moved every spec / talent global into the new C_SpecializationInfo namespace; the legacy GetSpecialization / GetSpecializationInfo globals return nil unless the player runs /console loadDeprecationFallbacks 1. Scanner.detectSpecName now probes C_SpecializationInfo.GetSpecialization first and falls through to the unqualified globals for Cata / Wrath / Vanilla. Without this, the GearMatic Loadout window and SavedVariables for Mists Classic characters lost their spec label even when the character clearly had an active spec in-game. v2.3.1 added the pcall wrap; v2.4.5 adds the actual namespace path that returns the spec name.

Added

• Talent + glyph capture in SavedVariables. Scanner.detectTalents now reads the player's active spec group + the selected tier/column picks (via C_SpecializationInfo.GetTalentInfo on Mists Classic, GetTalentInfo on Cata/Wrath, falling back to the 3-tab GetTalentTabInfo model on TBC/Vanilla). Scanner.detectGlyphs reads enabled glyph sockets via GetGlyphSocketInfo. Both persist into GearMaticDB.chars[charKey].talents / .glyphs on every scan and on Scanner.RefreshSpec, ready for downstream features.

[v2.4.1-release] - 05/18/2026

In-Game

• Fixed a game freeze when trying to log out or exit. Quitting WoW with GearMatic enabled used to throw an "action blocked" error and lock the exit dialog. The exit flow is clean now.

Fixed

• Critical: ADDON_ACTION_FORBIDDEN blocking game exit. Two files contained StaticPopupDialogs = StaticPopupDialogs or {} (Loadouts/Sidebar.lua and Loadouts/SpecHook.lua). Even though or short-circuits to the existing Blizzard table, the assignment writes the global, which marks _G.StaticPopupDialogs as having been written by GearMatic. WoW's taint system then propagated that flag through every subsequent secure read of the table, including Blizzard_StaticPopup's lookup of FORCE_QUIT.OnAccept during the exit dialog, which forbade the protected ForceQuit() call. Removed both fallback assignments; entries are now added with direct key writes (StaticPopupDialogs["GEARMATIC_..."] = { ... }), which mutate keys without writing the global itself.

[v2.4.0-release] - 05/18/2026

In-Game

• Loadouts launched on Vanilla and TBC. Save named gear sets per character and swap between them with one click.
• Sidebar lives on the Character window. Toggle it with the new chestplate button next to the close X.
• Double-click a loadout to equip it; drag it onto an action bar to make a one-click macro; right-click for Rename, Change Icon, Save Current, Export, Delete.
• Alt-hover any equipment slot for a per-slot menu: Ignore Slot, Place In Bags, or pick a replacement from a grid of candidates in your bags.
• Built-in icon picker with search and Items / Spells filtering.
• Party / raid / guild GearMatic users see your loadout swaps in chat (toggleable in Settings; never SAY/YELL).
• Spec change prompts a non-intrusive "switch to loadout X?" popup. Never auto-swaps gear. "Don't ask again" supported per character.
• New /gm subcommands: loadouts, save, load, rename, delete, export, import, unequip, icon.
• Loadouts tab in Settings on Vanilla and TBC. Wrath / Cata / Mists keep using Blizzard's built-in Equipment Manager.
• Loadout strings export with a new GMLOv2 format. Old GMLO:01 codes prompt you to save and re-export.
• Full translations for every new string in all 12 supported locales.

Added

• Loadouts (Vanilla and TBC only): save and switch named gear sets per character with full Gears-parity UX.
• PaperDoll-attached sidebar with toggle button on the character frame title strip.
• Double-click a loadout row to equip; drag onto an action bar; right-click for context menu (Rename / Change Icon / Save Current / Export / Delete).
• Alt-hover any equipment slot for a per-slot flyout: Ignore Slot, Place In Bags, and a grid of candidate replacement items from bags (one-click swap).
• Built-in icon picker (uses Blizzard's IconDataProviderMixin) with search and All/Items/Spells filter.
• AceComm peer broadcast of loadout swaps to party/raid/guild GearMatic users, with a 5-second per-sender throttle. Only fires on real swaps; never SAY/YELL; toggleable in Settings.
• Drag-to-action-bar via per-character macros, auto-recreated on rename. Macro slot cap honors MAX_CHARACTER_MACROS.
• Non-modal spec-change suggest popup; per-character "don't ask" list. Never auto-swaps.
• New /gm subcommands: loadouts, save, load, rename, delete, export, import, unequip, icon.
• Settings tab "Loadouts" appears only on Vanilla and TBC.
• Loadout strings export as GMLOv2:.... Legacy GMLO:01: exports prompt the user to save and re-export.
• Translations for every new key into all 12 supported locales (enUS, enGB, deDE, esES, esMX, frFR, itIT, koKR, ptBR, ruRU, zhCN, zhTW).
• Wrath / Cata / Mists are intentionally not supported, those clients have Blizzard's built-in Equipment Manager.
• Sidebar title icon: silver portrait ring (BlueMenuRing desaturated + cool tint) with the new GearMatic-Medallion brand artwork, parked on the CharacterFrame title bar over the X close button. Ring + medallion show/hide together with the sidebar.
• Sidebar visibility is now persisted per character in GearMaticDB.settings.loadoutSidebarShown. Toggling off via the paperdoll button (or the sidebar X) stays off across /reload and CharacterFrame re-opens; default is on for fresh installs.
• Sidebar title bar reanchored to fill the full width: TopLeftCorner switched to the clean UI-Frame-TopCornerLeft texcoords and TopBorder + LeftBorder reanchored off the new corner so the gold strip no longer cuts off where the old portrait socket used to overhang.
• "Add new loadout" row renders "ADD" in Anton 18pt next to the green plus icon.

[v2.3.1-release] - 05/16/2026

In-Game

• Fixed /gm scan and the /gm browser on Mists Classic 5.5.3. Previously the browser showed mostly empty slot squares despite your character having a full gear set, and /gm scan appeared to do nothing.
• Slot icons no longer go blank right after login. Item icons are cached when scanning so the browser fills in immediately.
• Equipping or swapping an item never wipes the previous slot data, even if WoW's item info isn't loaded yet.

Fixed

• Critical: MoP Classic 5.5.3 scan abort. Scanner.detectSpecName called GetNumTalentTabs / GetTalentTabInfo after a type(...) == "function" check. Blizzard kept the function symbols but now throws "Script_GetNumTalentTabs: API unsupported in this version of World of Warcraft." on call, which aborted both Scanner.RefreshSpec and Scanner.ScanCurrentCharacter silently (no chat error unless /console scriptErrors 1 was set). Symptoms on MoP Classic: /gm scan appeared to do nothing, the /gm browser showed mostly empty slot squares despite full gear, and saved-vars drifted down to a handful of stale slots. Fix: every legacy talent-API call (and the modern GetSpecialization calls, defense in depth) is now pcall-wrapped; on failure detectSpecName returns nil and the caller falls through to the prior entry.spec value so the rest of the scan completes normally.
• Slot grid icons rendering blank against cold item-info cache. The /gm browser called GetItemIcon(itemLink) live at paint time, which returns nil for items WoW has evicted from its per-item cache (common right after login for items the player has not interacted with). With no GET_ITEM_INFO_RECEIVED repaint hook, those slots stayed blank until the cache warmed up. Fix: Scanner.readSlot now captures the icon at scan time (from GetItemInfo's 10th return, falling back to GetItemIcon), persists it on the saved slot entry, and the browser's paintSlot prefers slotData.icon before the live lookups.
• Slot data wiped on cold-cache reads. Scanner.ScanCurrentCharacter and Scanner.RescanSlot both overwrote a slot with nil whenever readSlot returned no link AND no id, even when the slot had real data from a previous session. On a fresh login this could persist a 19-slot character with only 4 surviving slots once cache warmed too slowly. Fix: when readSlot reports nil for a slot we already had data for, treat as ambiguous (cold cache, not a real unequip) and trigger a retry instead of wiping. RescanSlot gains a per-call retry counter so PLAYER_EQUIPMENT_CHANGED firing before item info loads no longer destroys saved data. Initial-scan retry budget bumped from 5 to 10 (2.5s -> 5s).
• AutoEquip wrote partial slot entries. After equipping, AutoEquip.refreshSlotInData set entry.slots[slotID] = { itemLink = link } and nothing else. itemID, itemLevel, rarity, name, classID, durability all stayed nil on the affected slot. Compat.AverageItemLevel silently skipped the partial slot when computing iLvl, and the browser had nothing to display beyond the link. Fix: after capturing the link, run GetItemInfo once and persist the full slot shape (itemID, itemLevel, rarity, name, icon, classID, durability, durabilityMax), matching Scanner.readSlot. Also stops wiping the slot on transient nil link reads right after EquipCursorItem, which the API can return for a frame on Classic clients.

Static syntax check (luac -p) clean across every Lua module before tagging.

[v2.3.0-release] - 05/16/2026

In-Game

• On-screen alert banner pops every time you equip a piece. Big icon, a colored arrow (double green = upgrade, single green = side / first-fill, red = downgrade), and a percent number for the score change. Upgrades chime, downgrades play the raid-warning sound.
• Settings panel rebuilt into seven cleaner tabs (General, Detection, Alert Font, Sound, Social, Stat Import, Change Log).
• Nineteen new sounds bundled (LevelUp, Solid-Alert, Heroism Cast, Magic Beam, Jedi Beam, Batman Punch, Blue / Green Portal, Thunder, Whoop, Codec, Clamps, Blast, Coin, Shotgun, Boop, Combo Breaker, Done, Heaven) and selectable for the upgrade chime.
• Smarter scoring for low-level alts: every new piece is scored correctly from level 1, even before you pick a spec.
• Wrong armor type is now heavily penalized so leather on a warrior or mail on a mage stops looking like an upgrade.
• Heirlooms get a small score bump and are protected from being recommended as a swap target.
• Quest items and a built-in locked-item list (fishing poles, specialty pieces) are protected from auto-equip and from upgrade recommendations.
• Fix: stopped showing "+100% upgrade" on every white item.
• Twelve-locale translation coverage for every new string.

Added

• On-screen gear alert. Equip any piece and a banner pops with the item icon, a coloured chevron, and a score-delta percent. Upgrades show a double green chevron with a "Level Up" chime; downgrades show a red chevron with the WoW raid-warning sound; sidegrades and first-fills get a single green chevron. Sound only plays the first time you ever equip a given item on that character so repeat swaps stay quiet. Banner position, font (LibSharedMedia), colours, format strings, max stacked messages, start delay, fade time, and uppercase treatment are all configurable in the new Alert Font sub-tab. Manual previews via /gm test (upgrade) and /gm test2 (downrank).
• Settings panel restructure into seven tabs. General (alert toggle, chat toggle, minimap, changelog popup, Support, About), Detection (the old tracking + smart-detect + auto-equip controls), Alert Font (sub-tabs for General, Notification format, Font), Sound (Upgrade sound on top, Downrank sound, Mute all), Social (unchanged), Stat Import (unchanged), Change Log (toggle + Open Now button).
• Bundled sound library. Nineteen OGGs ship with the addon (LevelUp, Solid-Alert, Heroism_Cast, MagicBeam, JediBeam, BatmanPunch, BluePortal, GreenPortal, Thunder, Whoop, Codec, Clamps, Blast, Coin, Shotgun, Boop, COMBO-BREAKER, Done, Heaven) all registered with LibSharedMedia so they appear in every LSM-aware dropdown across your UI. Plus Raid Warning registered against Blizzard's built-in chime as the default Downrank sound.
• Class-default stat weights for low-level alts. Spec-less characters (level 1-9 with no talent points) now fall back to a class-wide weight set instead of the rarity-and-ilvl heuristic, so a fresh hunter scores every quest reward correctly from level 1. The bundled wowsims defaults still take over the moment a spec is detected.
• Armor proficiency penalty in scoring. Cloth on a level-50 warrior, leather on a level-50 hunter, and similar wrong-tier pieces get heavy score multipliers so they stop showing as upgrades over the proper armor type. Soft 10-percent penalty inside a ten-level grace window, hard 50-percent past it. Foreign armor types your class can't wear at all (e.g. mail on a mage) score at five percent.
• Stat overcap halving. When your current hit, spell-hit, or expertise rating is already past the soft cap, GearMatic halves that stat's weight when scoring new pieces so it doesn't recommend you stack what you already cap.
• Heirloom score bias. Heirloom-quality items get a 10 percent score boost so they don't lose to slightly higher-ilvl quest greens. Heirlooms are also protected against being recommended as swap targets when the equipped piece is also an heirloom.
• Quest / locked-item protection. Quest-bound items are never flagged as upgrade swaps or picked up by auto-equip. A built-in locked-ID list shields fishing poles and specialty gear loadouts from being clobbered by a regular weapon recommendation.
• Implicit armor weight. Stat-weighted scoring now also credits the raw armor value of a piece at the minimum positive weight times 0.1, so an armor-rich piece doesn't lose to a stat-equal but armor-light piece when the scale doesn't explicitly weight ARMOR.
• Branded chat output helper. New ns:Print() prefixes every chat line GearMatic emits with the purple brand color. Load message moved off ADDON_LOADED onto a delayed C_Timer.After on PLAYER_LOGIN (8 seconds if ElvUI is loaded, 4 seconds otherwise) so it lands after the chat-frame splash instead of being hidden under it.
• Twelve-locale coverage for every new string. Fifty-four new keys translated into enGB, deDE, esES, esMX, frFR, itIT, koKR, ptBR, ruRU, zhCN, zhTW. Slot names in the alert chat-line now read from the WoW client's localized INVTYPE_* globals.

Fixed

• "+100% upgrade for current spec" bug on every white item. Scoring now reads live GetInventoryItemLink("player", slotID) for the logged-in character instead of trusting the saved-vars snapshot, and refuses to claim +100% when the equipped slot has an item we just couldn't score yet (returns nil so the tooltip line is suppressed entirely rather than lying). Truly empty slots still get a +100% correctly. Alts whose gear has never been scanned are also suppressed so the tooltip doesn't spam fake upgrades for every untracked alt.
• GetItemStats guarded for Vanilla. Wrapped the call so the absent-on-Classic-Era API falls cleanly into the fallback path instead of hard-erroring.

Changed

• All print() and chat output routed through localization. slash_auto_*, slash_clear_usage, slash_equip_none, slash_scan_done, autoequip_in_combat, autoequip_missing_api, autoequip_cursor_abort, comm_no_peers, scaleimport_no_profiles, pawn_not_loaded, nag_retail_pawn, settings_libs_missing, and alert_chat_equipped all flow through ns.L[] now.
• Every Lua comment stripped from the project. Cleaner codebase; behavior unchanged. TOC ## directives are not comments and stay.

Static syntax check (luac -p) clean across every Lua module before tagging.

[v2.2.0-release] - 05/15/2026

In-Game

• X / Twitter row added to the About section in Settings, under the Infinite Loop Alchemist profile name.

Added

• X / Twitter row in the About section. New Textures/x-logo.tga (128x128 RGBA, bottom-left origin, matches the existing Buy Me A Coffee asset) plus an X icon and copyable https://x.com/infiniteloopalc input rendered directly under the "Infinite Loop Alchemist" profile name. Strings localized in all 12 locales via settings_about_x.

Static syntax check (luac -p) clean across every Lua module before tagging.

[v2.1.0-release] - 05/10/2026

Added

• GearMatic-to-GearMatic version ping over AceComm-3.0. New Comm.lua module registers the addon-message prefix GearMatic and broadcasts VER:<x.y.z> once on PLAYER_LOGIN to GUILD plus the appropriate group channel (INSTANCE_CHAT in instances, else RAID, else PARTY). Peers' versions are silently collected into ns.Comm.peers. New /gm peers slash subcommand prints which guildmates / party / raid members are running GearMatic this session, so the channel is testable without a UI. Plumbing only at this stage; no loot-drop or upgrade-broadcast wiring yet.

Changed

• TOC Interface numbers refreshed to current live Classic builds so the addon stops reporting "Out of Date" on launch:
  • GearMatic_Mists.toc: 50500 -> 50503 (MoP Classic 5.5.3)
  • GearMatic_Wrath.toc: 30403 -> 38001 (Wrath / Titan Reforged)
  • GearMatic_Vanilla.toc: 11508 (unchanged, Classic Era 1.15.8)
  • GearMatic_TBC.toc: 20505 (unchanged, TBC Anniversary 2.5.5)
  • GearMatic_Cata.toc: 40402 (unchanged)

Removed

• GearMatic_Mainline.toc deleted; retail / Mainline is no longer a supported flavor. Two reasons stack here:

  1. wowsims (https://wowsims.github.io/) does not target retail, so the Pawn-format scoring weights GearMatic relies on don't exist for Midnight specs. The addon's core "is this an upgrade for my spec" decision has nothing to read against on retail.
  2. Blizzard's patch 12.0 ("Midnight") combat-addon block, which the Ace3 maintainer summarized as "Blizzard blocked the ability to use the COMBAT_LOG_EVENT_UNFILTERED event", knocks out the broader ecosystem this addon was designed to live in.

  Will be reconsidered if/when wowsims publishes retail weights and Blizzard relaxes the addon API restrictions.

Static syntax check (luac -p) clean across every Lua module before tagging.

[v2.0.1-release] - 05/09/2026

Fixed

• Auto-equip no longer ping-pongs items in and out of the same slot when the addon's slot snapshot is briefly empty. Scanner.readSlot used to wipe a slot whenever GetInventoryItemLink returned nil, which it does for a frame on Classic / Anniversary right after EquipCursorItem and during the inventory-loading window on login. A wiped slot looked "empty" to the next sweep and triggered a "+100% over empty" stomp, kicking off Frayed Shoes / Thug Boots back-and-forth swaps even when the player already had the better piece equipped. Scanner now treats a nil link with a present GetInventoryItemID as needs-retry instead of empty, so valid slot data is never erased by a transient API hiccup.
• AutoEquip cross-checks the live inventory before trusting an empty DB slot. Belt-and-suspenders for the Scanner fix: even if the DB says slot 8 is empty, AutoEquip now calls GetInventoryItemLink("player", targetSlot) once before the safety check; if the live API reports an item, it syncs the DB back to that link and rescores so we never equip "+100% over empty" against a real piece.

Changed

• Changelog popup now uses the same parchment + wood-border look as CritMatic. Switched from the Blizzard Tooltip (dark) backdrop to Blizzard Parchment 2 background with a Blizzard Achievement Wood border at edge size 15. Body text is now MoK 15pt in dark grey (0.2, 0.2, 0.2) so it reads cleanly on the parchment, with Anton kept as a fallback if MoK is unavailable. Same CritMatic palette, same warm "old paper" feel.

[v2.0.0-release] - 05/09/2026

Removed (breaking)

• Send to /say toggle and the SAY broadcast path are gone. /say is muted in instances by Blizzard, and on Classic / Anniversary the post-EquipCursorItem timing made the broadcast unreliable in practice. Removing the option entirely is cleaner than continuing to ship a half-working channel. Group channels (PARTY / RAID / INSTANCE_CHAT) and GUILD remain. Existing GearMaticDB.settings.social.sendToSay = true saved-vars are now silently ignored.

Changed

• Social channel selection rewritten in the Questie style. Modeled on Questie's _QuestieAnnounce.GetChatMessageChannel: a single group-context channel is picked based on where the player is (battleground -> INSTANCE_CHAT, raid -> RAID or INSTANCE_CHAT for LFG, party -> PARTY or INSTANCE_CHAT for LFG), and GUILD is added as an additional simulcast when toggled and you're in a guild. No more "blast to SAY + GUILD + PARTY all at once" - one group channel, plus guild.
• Brand color is now purple #9212d5 everywhere. Replaced the old soft-blue #7777ff across chat lines, tooltip score header, minimap button tooltip, Loadout window title, the new in-game popup, and the load message so the addon reads consistently in chat.

Added

• In-game changelog popup, modeled on CritMatic's. Shows automatically on first login after a version bump (gated on a new General-tab toggle "Show changelog popup on update", default on), with the same AceGUI Frame + ScrollFrame layout, grey body text, and Anton font as CritMatic. Manual open with /gm changelog (or /gm log). Capped at the latest 3 release entries plus a pointer to the full CHANGE_LOG.md on GitHub or CurseForge.
• /gmhelp slash command alias that prints the full slash-command help directly, matching CritMatic's /cmhelp. The original /gm help still works.
• Branded multi-color load message, modeled on CritMatic's: GearMatic: v X.Y.Z Loaded! - Use /gm for options - /gmhelp for all slash commands, with the addon name and slash commands in purple and the body text grey.
• Login chat is quieter. The "GearMatic: smart upgrade detection is on. Type /gm auto off to disable." hint and the "GearMatic: registered config under Interface > AddOns > GearMatic (or just type /gm)." line are removed. The branded load message is now the only chat output on login.

Fixed

• Auto-equip no longer stomps a just-equipped upgrade with a worse bag item in the same sweep. When two candidates for the same slot lived in your bags (e.g. Frayed Shoes + Thug Boots in feet), the sweep equipped the first one, then on the very next iteration still saw the slot as empty/weak in its in-memory snapshot, scored the second item as "+100% over empty", and equipped it over the first. Both items would show "+100%" in chat and you'd end up with the worse one equipped and the better one back in your bag. The sweep now refreshes the in-memory equipped snapshot from the known bag link after each successful equip, rather than calling GetInventoryItemLink (which can return nil for a frame on Classic / Anniversary right after EquipCursorItem and would erase the snapshot we just wrote). Subsequent candidates always compare against what was just equipped.
• Auto-equip weapon swaps no longer leave a ghost off-hand/main-hand entry in the in-memory snapshot. Equipping a two-hander correctly clears slot 17 (the displaced off-hand) from the snapshot, and equipping a shield / off-hand / holdable into slot 17 over a two-hander correctly clears slot 16. Prevents stale weapon-slot entries from biasing later iterations of the same sweep and from showing the wrong off-hand in the loadout window until the next full scan.
• /say (and other Social) broadcasts no longer drop on auto-equip swaps. The Social handler used GetInventoryItemLink to read the just-equipped item, but on Classic / Anniversary that API can return nil for one frame right after EquipCursorItem, which made Social.OnEquipChange bail at if not id then return end and never reach SendChatMessage. AutoEquip now hands Social the known bag link directly via a new Social.RecordEquip path, which broadcasts immediately and updates the lastEquipped cache. The PLAYER_EQUIPMENT_CHANGED handler still services player-driven (drag-drop, EquipmentManager) equips, with a 1-second post-RecordEquip guard that ignores nil-link timing glitches without breaking real unequip detection.
• Scoring.ScoreItem no longer returns nil for armor-only items. On Classic, low-level gear like Frayed Shoes or Thug Boots may have GetItemStats return nil because they only carry an armor value. The previous code returned nil in that case, which downstream code read as a score of 0 and produced phantom "+100% over equipped" deltas during a sweep. ScoreItem now falls back to ilvl-rarity scoring (with the fallback flag set, so the auto-equip occupied-slot safety hardening still requires a real stat-weighted scale before swapping).
• Fallback score now reads the actual armor value from the item tooltip and weights it heavily. Without this, low-level Vanilla gear scored only on ilvl * rarity_multiplier, so a higher-rarity / equal-ilvl piece with zero armor could outscore a lower-rarity piece with 5+ armor and auto-equip would pick the worse one. Scoring now opens a hidden tooltip frame, reads the "X Armor" line, caches the result by item ID, and folds armor into the fallback score at 10x weight (ilvl * rarity_mult + armor * 10) so armor is the dominant signal for armor pieces. Frayed Shoes (5 armor) now reliably beats Thug Boots (0 armor) on score alone.
• Auto-equip safety hardening relaxed for armor-piece upgrades in fallback mode. The v1.0.8 hardening required a real stat-weighted scale (Pawn) before it would swap into an occupied slot. That was correct for stat-driven items where ilvl alone can mislead, but it blocked obvious armor upgrades on leveling characters with no Pawn scale. AutoEquip now allows the swap into an occupied armor slot when the candidate has strictly more armor than the equipped item (read from the live tooltip, same scanner the score uses). Applies only to true armor slots (head, shoulder, chest, waist, legs, feet, wrist, hand, cloak, shield). Non-armor slots (rings, trinkets, weapons, ranged) keep the strict v1.0.8 rule because their value is in stats, not armor. Combined with the cursor-flow hardening, the worst case is still "wrong stat priority for casters in fallback" - never a destroyed item.

Changed

• Auto-equip success line stays branded "GearMatic" (no rename). Local chat-frame line continues to be |cff7777ffGearMatic|r equipped X (+N%). It is suppressed only when /say will actually carry the announcement (SAY toggle on, not in an instance, slot was occupied). Other Social toggles (party / raid / guild / bg) do not suppress the local print, so you always have a personal record when /say cannot fire.

Added

• Bundled the same Anton font CritMatic uses for its alerts. Registered with LibSharedMedia as Anton. Loadout window title, header, and footer now render in Anton with an outline so the two addons share a visual identity. Falls back to Blizzard fonts if the file is missing.

Changed

• Loadout slot textures now show clearly. Empty slot art renders at the same size as the item icon (both at full slot extent with 7%/7% texture-coord trim to remove the dark border that comes baked into Blizzard's slot art), and a dark slot background is laid behind so the slot is visible against the loadout window backdrop. Each slot uses its specific Blizzard art: Head, Neck, Shoulder, Back, Chest, Shirt, Tabard, Wrists, Hands, Waist, Legs, Feet, Finger, Trinket, MainHand, SecondaryHand, Ranged.
• Loadout prev/next buttons are now greyed out at the boundaries: prev disabled on the first character, next disabled on the last, both disabled when only one character is tracked. The cycle no longer wraps around past the last alt.
• Tooltip and quest/loot indicators no longer show the red downgrade chevron for sidegrades. Items in the -1% to +1% range get a clean line with no chevron prefix; only true downgrades (delta <= -1) get the red chevron.

[v1.0.8-release] - 05/09/2026

Added

• New General-tab toggle: "Prefer Pawn weights for scoring" (default on, disabled when Pawn is not installed). When on, GearMatic auto-picks the Pawn-imported scale that matches your class (and spec when possible) and uses those weights for every scoring path (tooltip, quest reward, loot, bag overlay, browser, auto-equip). No manual "Set Active" click needed. When off, GearMatic falls back to your manually selected profile or its bundled defaults.

• Renamed the cross-character browser to Loadout. Window title now reads "GearMatic Loadout". New slash command /gm loadout (the old /gm browser, /gm browse, /gm chars aliases still work).

• New keybinding in General settings: "Open loadout". Bind any key to instantly open the Loadout window. Reapplied on login.

• Quest reward chevron now uses armor value as a third tiebreaker after armor-type priority and delta. When two leather pieces tie at +100% for a Rogue, the one with more armor wins. Helps when an empty slot gives both items the same delta but one is objectively better-protected.

• New "Run auto-equip sweep now" button in the Auto-equip group on the General tab. Triggers a single sweep on demand, even with the master toggle off. Same hardened safety path applies.

• Auto-equip cursor flow can no longer lose an item. ClearCursor() removed entirely from the swap path. New flow: pick up the bag item → EquipCursorItem(slot) → if anything left on cursor, drop it back into the bag slot we just picked from (which is empty by definition) → if even that fails, abort with a chat message telling the user "item is on your cursor, drop it manually, nothing was lost." Worst case is the new item stays in the bag and the previously-equipped item stays equipped. There is no path to a destroyed/lost item.

• Critical auto-equip safety hardening. Auto-equip will no longer swap into an occupied slot when GearMatic cannot make a real comparison. Specifically: an upgrade is only auto-equipped over an existing item when (a) a real stat-weight scale is active (not the iLvl fallback), (b) both the candidate and currently-equipped item produced positive non-fallback scores, and (c) the raw stat-weighted delta clears the user's minimum percent. Filling a genuinely empty slot still works as before. This closes the path where a missing spec / not-yet-cached scoring caused the equipped item to read as score=0 and any bag item to read as a "+100% upgrade", which on a fragile cursor swap could lose the previously-equipped item.

• Auto-equip swap is now atomic via EquipCursorItem instead of PickupContainerItem + PickupInventoryItem + ClearCursor. Same pattern EquipmentManager and Pawn use. Eliminates the edge case where the previously-equipped item could fall off the cursor when its origin slot was already occupied. Falls back to the old path on clients without EquipCursorItem.

• Auto-equip now triggers on PLAYER_ENTERING_WORLD (login / /reload / zone change) too, not just on bag updates and combat-end. If you enable the toggle while items are already in your bags, a /reload is now enough; you no longer have to wait for a bag update or combat-end event before existing upgrades get equipped.

• /gm equip prints a sweep summary: sweep done, considered N upgrade(s), equipped M. Helps debug "why didn't anything equip".

• "Cannot auto-equip in combat" message no longer spams the chat for automatic sweeps; it only prints when you ran /gm equip manually while in combat.

• Loadout window redesigned as a paperdoll. Real WoW slot textures and item icons, two-column gear layout matching the Blizzard character pane, weapon row at the bottom. Per-slot durability bar colored green/yellow/red. Hover any slot for the full item tooltip with durability percent. Header shows class-colored character name, race, class, level, spec. Footer shows iLvl, lowest-slot durability, and (N/total) position. Prev / Next buttons at the bottom corners cycle through every alt on the realm; left/right arrow keys also navigate while focused.

[v1.0.7-release] - 05/09/2026

Changed

• Stat Import tab help text now explicitly mentions both wowsims.github.io exports and the Pawn addon as sources, with both names highlighted, so users understand the single paste box accepts strings from either.

[v1.0.6-release] - 05/09/2026

Added

• LICENSE file at the repo root: All Rights Reserved. Embedded third-party libraries (Ace3, LibStub, etc.) keep their own original licenses.
• Every TOC now declares ## X-License: All Rights Reserved.

[v1.0.5-release] - 05/09/2026

Added

• New General-tab toggle: "Defer to Pawn for tooltip and bag overlay". When Pawn is loaded and the toggle is on, GearMatic hides its current-spec tooltip line and green bag chevron so they do not duplicate Pawn's display. Yellow alt-aware chevrons, quest reward chevron, loot chevron, cross-character browser, durability nag, auto-equip, and social broadcasts stay live (Pawn does not provide those). Disabled-grey when Pawn is not installed. Default off.

[v1.0.4-release] - 05/09/2026

Added

• Saved profiles list now shows a blue [Pawn] tag next to scales that were auto-imported from the Pawn addon, so you can tell at a glance which profile came from where.
• One-time login warning on retail when Pawn is not loaded: GearMatic does not bundle retail stat weights, so on Mainline you need Pawn installed for accurate scoring. Without Pawn (or a manually pasted scale), GearMatic on retail falls back to item-level only.

Notes

• Retail requires Pawn. Bundled wowsims weights only cover Vanilla through Mists. On retail, install Pawn with your usual scales and GearMatic will auto-import them.

[v1.0.3-release] - 05/09/2026

Added

• Retail / Mainline support, backed by Pawn. GearMatic_Mainline.toc is back (Interface 110005). Spec auto-detect now uses GetSpecialization() first on retail, then falls through to the classic talent API. GearMatic does not bundle retail wowsims weights, so on retail the recommended path is: install Pawn with your usual scales and let GearMatic auto-import them on login (or paste your own scale via /gm import).

[v1.0.2-release] - 05/09/2026

Added

• Real Pawn integration. If the Pawn addon is loaded, GearMatic now imports every non-hidden Pawn scale into your saved profiles automatically on login. Toggle in General settings ("Auto-import scales from Pawn"), or run on demand with the new "Sync Pawn scales now" button or /gm pawn slash command.

Changed

• Replaced the dead ## OptionalDeps: Pawn declaration in every TOC with a real runtime integration. The TOC line was previously a no-op that implied an integration we did not actually deliver.

[v1.0.1-release] - 05/08/2026

Removed

• Dropped Retail / Mainline support. The addon was never actually compatible with retail (no retail spec API, no retail wowsims weights bundled). Removing the broken GearMatic_Mainline.toc so users on Dragonflight / War Within do not install something that silently fails.

[v1.0.0-release] - 05/08/2026

Initial public release.

Added

• Cross-character equipped gear tracker with login durability nag.
• Smart upgrade detection driven by Pawn-format stat weights.
• Bundled wowsims default scales for Vanilla, TBC, Wrath, Cata, Mists (57 specs).
• Auto-detect spec from talents.
• Tooltip overlay on bag, vendor, AH, group loot, and mail items.
• Quest reward window chevron for the best reward for your spec, with class armor priority (Plate > Mail > Leather > Cloth).
• Loot window chevron on upgrades.
• Bag overlay chevron on bag items, compatible with Bagnon and most bag addons.
• Yellow chevron variant for items the current character cannot wear but at least one alt can.
• Auto-equip toggle for out-of-combat upgrade swaps. Manual sweep with /gm equip.
• Cross-character browser at /gm browser showing iLvl, lowest durability, and per-slot scores.
• Stat profiles tab in settings: paste, save, switch active scale, per-profile keybinds, and a cycle keybind.
• Social tab broadcasts equip changes to /say (skipped in instances), /party, /raid, /guild, and /battleground.
• Minimap button (off by default).
• Sidebar settings layout via Ace3 with General, Stat Import, and Social tabs.