Checked against the Turtle WoW developer class-change posts. Survival is its own melee Hunter spec, Paladins value Spell Power more (new strikes, Holy Shield, Bulwark) and Holy Paladins value armor (Ironclad), Arcane mages value haste more. Removes the Restoration Druid Spirit bonus from 1.5.0 because only Octo's database lists it.
Equip Compare Adv
Gear comparison for Turtle WoW, Octo WoW, Ravencraft and other 1.12.1 servers. Hover any item you could equip and a panel next to the tooltip tells you:
- What you have equipped in that slot: its full tooltip right next to the one you're hovering, like the game's own compare tooltips, plus its score.
- The overall effect of swapping: how much damage per second you'd gain or lose, how much more or less damage you'd take, and what happens to your healing power, health and mana.
- Every stat you'd gain and lose, green and red, with how many score points each one is worth.
- A score for both items, worked out for your class and spec.
- A verdict: big upgrade, upgrade, sidegrade, downgrade or big downgrade, and whether equipping it is recommended.
- A verdict for every role your class can fill: a paladin sees the swap judged for tanking, for healing and for damage.
- Who the item is made for: tank, DPS or healer, the classes and specs that get the most out of it, and how well it fits your own spec.
It also warns you about the things a score can't see: a set bonus you'd break, a Use or proc effect you'd lose, an item you can't equip yet.
The game's own tooltips are never changed, so it works alongside other tooltip addons.
Quick start
- Download the zip from the latest release. Copy the
EquipCompareAdvfolder inside it intoInterface\AddOns\in your game folder, then fully restart the game. Full install steps. - Hover an item in your bags, at a vendor, in the loot window, on the auction house or in a chat link.
- Hold Alt for the detailed view.
- Type
/ecafor the options window.
Found a bug? See Reporting bugs.
Install
With an addon launcher (the Turtle WoW launcher, RavenLaunch and similar): paste this repo's address, https://github.com/notforever-ship-it/EquipCompareAdv, into its GitHub addon installer. The addon files sit at the top level of the repo, which is the layout launchers expect.
By hand:
- Download the zip from the latest release. It contains a ready-made
EquipCompareAdvfolder. (If you use Code → Download ZIP instead, the folder inside is calledEquipCompareAdv-master; rename it toEquipCompareAdvor the game won't load it.) - Copy that folder into
World of Warcraft\Interface\AddOns\. The path should end inInterface\AddOns\EquipCompareAdv\EquipCompareAdv.toc. - Fully restart the game.
/reloaddoesn't pick up newly added addons. - On the character select screen, click AddOns and make sure Equip Compare Adv is ticked.
What the panel shows
Equip Compare Adv Fury
Equipped - Head
Helm of Might score 47.1
Enchant: +8 Stamina
This item score 165.7
Overall if you swap:
Damage +9.8 DPS (+6.1%)
Damage reduction -2.4%
Health -430
Stat by stat:
+3 Strength +6
-43 Stamina -8.6
+2% Crit Chance +64
+2% Hit Chance +60
-7 Defense -1.4
>> BIG UPGRADE +118.6 (+251.8%)
Recommended: equip it.
By role:
Damage BIG UPGRADE +251.8%
Tanking (Protection) DOWNGRADE -12.4%
Biggest gain +2% Crit Chance
Biggest loss -43 Stamina
Careful: your Head is part of Battlegear of Might (3/8 worn)...
Made for: DPS (melee)
Best for: Warrior Arms 100%
Paladin Retribution 98%
Fit for your spec: 100%
- Overall if you swap is the headline, worked out from your character as it stands right now:
- Damage: the change in damage per second. 14 attack power is 1 damage per second, weapon damage counts directly (half in the off hand), and crit, hit and attack speed add their percent on top of your current auto-attack damage. Strength and Agility are turned into attack power and crit first. Hunters get the same for ranged.
- Spell damage: the change in spell damage for the schools your spec casts, and roughly what that is per second of casting (3.5 spell damage is 1 DPS on a full-strength spell).
- Damage reduction: how much less physical damage you'd take, from armor against something your own level (a level 63 boss at 60 in raid mode), dodge, parry and defense. Negative means you'd take more.
- Healing power: the change in bonus healing, and roughly what that is per second of casting.
- Health and Mana, from Stamina and Intellect.
- By role (left out when every role agrees, as with plain armor) gives a second opinion for each role your class can fill: the same swap judged purely as a tank, as a healer and as damage, without the leveling mix. A warrior sees two lines, a paladin three, a druid four; rogues, hunters, mages and warlocks only deal damage, so they get none. Switch it off in
/ecaor with/eca roles. - The equipped item's tooltip sits between the item you hover and the panel, under a "Currently Equipped" tab. Rings, trinkets and weapons can show two. On the auction house the game already shows its own, so the addon leaves those alone and puts the panel on the free side of the tooltip, or under or over it when that fits better.
- The panel follows the game's tooltips, chat links, and the tooltips of the Atlas-CFM (Atlas-TW) and AtlasLoot loot browsers.
- Rings, trinkets and one-handed weapons are compared with both slots, and the panel says which one to swap. The better swap is shown in full and the other in two lines; hold Alt to see both in full.
- Two-handers are compared with your main hand and off hand together. An off-hand weapon's damage counts half, as it does in game.
- Hovering something you're wearing shows its score and your total gear score instead.
- The character window shows your total gear score under your character.
Verdicts
| Verdict | Meaning |
|---|---|
| BIG UPGRADE | 15% or more better than what you have, and enough to move your whole gear score by 2%. Equip it. |
| UPGRADE | 3% to 15% better. Equip it. |
| SLIGHT UPGRADE | Nothing lost and a little gained: more armor and nothing else changed, say. Equip it. |
| SIDEGRADE | Within 3%, with something gained and something lost. Pick the stats you like more. |
| SLIGHT DOWNGRADE | A little lost and nothing gained. |
| DOWNGRADE / BIG DOWNGRADE | Worse. Keep what you have. |
| BETTER THAN NOTHING | The slot is empty, but the item's stats do little for your spec. |
| NOTHING FOR YOUR SPEC | Neither item has a stat your spec counts. Go by the Overall lines, or score for another spec. |
Detail levels
| Level | Shows |
|---|---|
| Compact | Both scores, the overall effect, the verdict and the recommendation. |
| Normal | Plus every stat change, warnings and who the item is made for. |
| Detailed | Plus before and after numbers, unchanged stats, the effect on your total gear score, and where you stand on hit caps. |
Holding Alt shows Detailed at any time.
How the score works
Every spec has a weight for the stats that do the work: attack power, crit, hit, spell damage, healing, health, armor and so on. Strength, Agility, Stamina, Intellect and Spirit are worth what they turn into for your class, using the 1.12 conversion rates:
- A warrior's Strength is 2 attack power; a rogue's is 1.
- Agility is crit and dodge for everyone, attack power for rogues, hunters and cat druids, and 2 ranged attack power for hunters. It takes 20 Agility for 1% crit on a warrior, 29 on a rogue, 53 on a hunter.
- Intellect is 15 mana and spell crit (about 60 Intellect for 1%).
- Spirit is mana regeneration, counted for the share of a fight it really works in.
Below level 60 the percent stats (crit, hit, dodge and so on) are worth less, because 1% of a level 20's damage is a much smaller number than 1% of a level 60's. A point of Agility gives more crit at low level, and the two cancel out, so Agility stays worth about the same all the way up. Numbers you type into the Stat weights window are used exactly as typed.
Melee and hunter scores count in attack power, caster scores in spell damage, healer scores in healing and tank scores in stamina. A score only means something next to another score for the same spec.
Specs: Arms, Fury, Protection · Holy, Protection, Retribution · Hunter, Survival · Rogue · Discipline (a damage spec on Turtle), Holy, Shadow · Elemental, Enhancement, Restoration · Arcane, Fire, Frost · Shadow and Fire warlock · Balance, Cat, Bear, Restoration. Auto follows your talents: the tree with the most points picks the spec. Feral druids get Cat; pick Bear by hand when you tank.
Hit caps. Hit stops helping once you can't miss. The addon adds up the hit on the rest of your gear and the hit talents you've taken (Precision, Surefooted, Nature's Guidance, Elemental Precision, Arcane Focus, Shadow Focus, Suppression), and only counts the part of an item's hit that still does something. Past the cap, hit keeps half its value if you dual wield and none otherwise. Caps are 9% melee and ranged and 16% spell against raid bosses, 5% and 3% against things your own level; Auto uses the raid numbers at level 60. Tanks in raid mode also value defense less past 440.
Leveling healers and tanks still have to kill things. Below level 60 their class's damage spec (Arms, Retribution, Shadow, Enhancement, Cat) is mixed into the score: nearly all of it at level 10, fading to none at 60. The panel header shows "+ leveling" while it applies. Switch it off in /eca or with /eca leveling.
Staying alive while leveling. Below 60 you mostly fight alone, so damage specs and healers get a little extra for health and armor, fading out by 60. Tanks already count them fully.
Leveling casters get a weight for wand damage that fades to nothing by level 60.
Enchants on your gear are counted by default, so you see what really changes the moment you swap. Tick Ignore enchants to compare bare items instead.
Not in the score: set bonuses, Use effects, procs and other special effects. The panel lists them so you can judge them yourself.
"Made for"
The addon looks at how an item's stat budget is spent and checks it against every spec of every class that can equip it (armor type, weapon skills, class restrictions). The spec that wastes the least of the budget is who the item is made for. Stamina is on nearly everything, so it only counts towards tanks. A tank can use Agility or Strength too, but an item only reads as tank gear when it carries tank stats: stamina, defense, dodge, parry, block.
Options
/eca opens the options window:
- Score items for: Auto, or any spec of your class.
- Switches for the comparison, the equipped item's tooltip, Shift-only mode, score points, the "made for" lines, the character window score and ignoring enchants.
- Detail and Hit caps buttons.
- Stat weights: a window listing what every stat is worth to your spec. Type a new number and press Enter to change it; changed stats turn gold. Strength and the other primary stats show what they're worth on the right, and a number typed there is added on top. Your changes are saved per character and per spec. You can also tell the addon about hit you get from somewhere it can't see.
- List my gear: everything you have equipped, with scores, in chat.
Commands
| Command | What it does |
|---|---|
/eca |
Open the options window |
/eca on · /eca off |
Switch the comparison on or off |
/eca spec auto · /eca spec fury |
What to score for |
/eca detail 1 · 2 · 3 |
Compact, normal or detailed |
/eca equipped |
Show or hide the equipped item's tooltip |
/eca shift |
Only show while Shift is held |
/eca caps auto · raid · leveling · off |
How hit caps are judged |
/eca roles |
Show or hide the verdict for each role |
/eca leveling |
Below 60, healers and tanks also count damage stats (on by default) |
/eca enchants |
Count or ignore enchants |
/eca gear |
List your equipped gear with scores |
/eca weights |
List the stat weights |
/eca weight CRIT 30 |
Change one weight; /eca weight reset puts them back |
/eca hit 3 · /eca spellhit 2 |
Extra hit % from buffs or talents the addon can't see |
/eca help |
List the commands in game |
Changes
1.5.1
- Checked against Turtle WoW's own class-change posts (Turtle WoW wiki, one page per class), which Octo follows. Survival is now its own melee Hunter spec (Lightning Reflexes turns Agility into melee attack power), Paladins value Spell Power more (the new Crusader Strike, Holy Strike, Holy Shield and Bulwark of the Righteous scale with it) and Holy Paladins value armor a little (Ironclad), and Arcane mages value haste more (reworked around casting speed). Warriors, Rogues, Shamans and Warlocks needed no change. Turtle's posts are now the only source: the Restoration Druid Spirit bonus added in 1.5.0 came only from Octo's database, which Turtle's posts do not list, so it is removed again.
1.5.0
- Octo/Turtle changes, checked against the OctoWow database. Priest is now Discipline (a damage spec: Chastise, Enlighten) and Holy (healer), where it used to be one "Holy / Discipline" healer. Balance druids value armor more (Moonkin Form raises item armor by 360%), Restoration druids value Spirit more (Tree of Life Form turns 20% of it into party healing), and Protection warriors value block value more (Shield Slam). The other classes' Octo spells fit their existing specs. Talent trees and stat conversions are not in the database and are not checked yet.
1.4.3
/eca debugnow also prints, line by line, the last item tooltip the addon could make nothing of, so a "no panel for this item" report can include exactly what the tooltip said./eca versionsays which version you have.- The slot line is matched after trimming spaces and colour codes, whatever its case.
1.4.2
- Guns, crossbows and wands get a comparison again. On the Turtle client their tooltip line reads just "Gun" (or "Crossbow", "Wand") with no "Ranged" next to it, and the addon only knew the slot by that word.
1.4.1
- Small screens and aux: when the panel has no room next to the tooltip and the game's compare tooltips, it now goes past the compare tooltips like the rest of the row, or under or over the tooltip, and when even that doesn't fit it is drawn shorter (the compact view) instead of being clamped on top of the other frames. Away from the auction house the tooltips of what you're wearing are dropped first, then the panel shortens. Hold Alt for the full panel any time.
- The compare tooltips at aux blink with every list refresh; the panel's place is now decided once per item, so it no longer jumps with them.
1.3.1
- Fixed the panel and equipped tooltips jumping between two spots when the hovered tooltip was near the middle of the screen. The layout is now worked out once per item and kept, and tops line up like the game's own compare tooltips unless that would run off the screen.
- Rings, trinkets and one-handers: the better swap is shown in full and the other in two lines, so the panel is much shorter. Alt shows both in full.
- New verdicts SLIGHT UPGRADE and SLIGHT DOWNGRADE for swaps that only add or only take away, instead of calling plain extra armor a "sidegrade".
- Health and armor count a little more below level 60.
- A red "Two-Hand" (a weapon kind you haven't learned) now shows the "can't use this" warning.
- "Fit for your spec" follows the leveling mix, so it no longer says 0% next to a BIG UPGRADE.
1.3.0
- New By role lines under the verdict: the same swap judged purely for tanking, for healing and for damage, whichever your class can do.
- Auto spec no longer settles on the first talent tree when the game hasn't handed over your talents yet right after a login or /reload; it looks again until they arrive.
1.2.1
- Fixed the Damage line ignoring weapon damage when scoring as a healer.
- Leveling healers and tanks now get their class's damage spec mixed into the score, fading out by level 60, so a better weapon reads as an upgrade on a level 11 Holy paladin. The header shows "+ leveling".
- When neither item has anything your spec counts, the verdict says so instead of "sidegrade".
1.4.0
- No more blinking at the auction house: the panel keeps its place across the list refreshes that hide and refill the tooltip, and only redraws when the item changes. Settles aux and other addons that set the same tooltip several times a second, too.
- No more overlapping when the game's compare tooltips are up: the panel takes the free side, or goes under or over the tooltip only when that really fits.
- Follows the Atlas-CFM (Atlas-TW) and AtlasLoot loot browser tooltips.
- "Dark background behind the panels" is now a switch in
/eca(or/eca dark). Untick it for the game's own tooltip look.
1.2.0
- New Overall if you swap block at the top of every comparison: the change in damage per second, damage reduction, healing power, spell damage, health and mana, worked out from your character's current numbers. Strength, Agility and the rest are already folded in.
- The addon's version shows at the bottom of the detailed view.
1.1.0
- The equipped item's full tooltip now shows next to the item you hover, like the game's own compare tooltips, with the comparison panel after it. Switch it off in
/ecaor with/eca equipped. - The panel and the equipped tooltips have a darker background, so they stay readable over your bags (a switch since 1.4.0).
- Fairer scores while leveling: crit, hit and the other percent stats are worth less below level 60, and Agility no longer gets inflated at low level.
- "Made for" no longer calls plain Agility or Strength items tank gear.
Good to know
- The 1.12 client doesn't tell addons what stats an item has, so the addon reads the tooltip text. It needs the English client.
- Stat weights are a starting point, not gospel. They're tuned for level 60 PvE; if your guild or a class guide uses different numbers, type them into the Stat weights window.
- Servers with custom talents can change what a stat is worth. If a verdict looks wrong for your server, adjust the weight and it stays adjusted.
Reporting bugs
Open an issue and include:
- The item you hovered and what you had equipped.
- Your class, level and the spec shown at the top of the panel.
- What the panel said and what you expected.
- If a red error appeared in chat, type
/eca debugand copy the line it prints.
For developers
- The addon files live at the repo root, which is the layout launchers expect;
tools/is development only and left out of release zips. node tools/check-lua.jsparses every file as Lua 5.0 and flags things the 1.12 client doesn't have.node tools/install.js [path to Interface\AddOns]copies the addon into a game folder.Stats.luareads tooltips,Profiles.luaholds the spec weights and the "made for" judgement,Compare.luascores and compares,Panel.luadraws.
Credits
Made by stealthzi.
License
MIT. See LICENSE.