Stat Priority First

PvE (Raid / Mythic+) stat priorities and BiS from Wowhead — clean, hoverable, weekly-updated.

Overview

Stat Priority First is a focused guide addon for Midnight (12.0). It puts Wowhead-sourced stat priority chains, BiS gear picks, and a friendly diminishing returns walkthrough in a small floating panel — plus a compact priority strip above your Character frame.

It does not replace your UI, vault tracker, or weekly checklist. It answers: what should I stack, what gear is BiS, and how hard is DR hitting me right now?

Guide first — class/spec browser, Raid / Mythic+ build pills, Compare.
BiS cards — Weapons, Trinkets, Consumables, and Tier Set with quality borders and Wowhead copy-links.
Live DR — breakpoints, true rating / lost to DR, and a readable bracket meter on secondary-stat hovers.
Character bar — your current-spec priority above PaperDoll (soft-skinned for ElvUI / EllesmereUI when those suites theme the character sheet).
Weekly data — scrape pipeline under tools/ refreshes Data/Priorities.lua from Wowhead.

Current version: 1.0.0 · Interface: 120007 (Midnight / Revelations)

Installation

Manual

Place the StatPriorityFirst folder in World of Warcraft\_retail_\Interface\AddOns.
Restart the game (or /reload if already in-game).
Open with /spf.

No other addons are required. Optional soft skins: ElvUI, EllesmereUI (+ EllesmereUIBlizzardSkin for Character Sheet theming).

Getting Started

Command	Description
`/spf` or `/statpriority`	Toggle the floating panel
`/spf refresh`	Jump to your current class/spec
`/spf status`	Data QA — spec count, scrape time, missing DR / BiS
`/spf <class> <spec>`	Browse a class/spec (e.g. `/spf demonhunter havoc`)
`/spf help`	Slash-command reminder

Panel tabs

Tab	What you get
Priority	Stat chain + BiS rows (Weapons → Trinkets → Consumables → Tier)
How It Works	Short guide for using the panel and gear picks
Diminishing Returns	Breakpoint tables, worked example, live ratings with true/lost

Left-click the minimap button to open the panel; right-click jumps to your current spec. Drag the button around the minimap rim to reposition.

Configuration

Open Esc → Options → AddOns → Stat Priority First.

Option	Description
Hide Minimap Button	Hide the rim button (`/spf` still works)
Lock Panel	Prevent dragging the floating panel
Open to Your Spec	Start on your current spec (off = last browsed)
Hide Character Frame Priority	Hide the strip above PaperDoll
Show true rating on item tooltips	Append `(true N)` on Crit/Haste/Mastery/Vers item lines (off by default)
Panel Scale	Scale the floating panel (75%–150%)

A short About Diminishing Returns blurb sits at the bottom of the settings page.

Features

Floating panel

Class list and spec picker with localized names where Blizzard provides them.
Build pills for Raid / Mythic+ (and extra variants when Wowhead lists them).
Compare to put two builds side by side.
ESC closes the panel (UISpecialFrames).
Class-accent chrome for the browsed class (Character bar won’t stomp the panel accent while it’s open).

BiS gear

Stacked full-width rows: Weapons, Trinkets, Consumables, Tier Set.
Best in Slot | Alternatives when both sides exist; consumables stay BiS-only (no empty Alts column).
Fixed 32px icons, quality-colored borders, item tooltips with bonus IDs when present.
Card ↗ copies the Wowhead guide URL (Consumables uses the enchants-gems page when available). Never calls protected LaunchURL — copy-link popup instead.

Diminishing returns

Guide-tab tables for the first three Midnight breakpoints (same numbers Wowhead / Maxroll list at 90).
Hover Crit / Haste / Mastery / Vers on the Priority tab or Character bar for live compare.
True rating and lost to DR from SimC conversion + % brackets.
Bracket progress as a normal tooltip line + a thin muted meter (no text on neon fill).
Optional item-tooltip true-delta (Settings).

Character bar

Shows only on the Character (PaperDoll) tab — hidden on Reputation / Currency.
Click a chip or empty chrome to open /spf on your spec.
Soft skin when ElvUI Blizzard Character skins are on, or when Ellesmere Character Sheet theming is on. CharacterFrame tabs are left alone.

Minimap button

Sits on the map rim (size-aware; round and square shapes).
Flat SPF chrome; soft ElvUI / Ellesmere button skin when those suites load — no gold tracking border.

Keeping data fresh

Priorities and BiS live in Data/Priorities.lua. Maintainers regenerate them with the tools under tools/.

Quick path

Open wowhead.com → DevTools → Console.
Paste tools/browser_scrape.js and wait for spf-wowhead-export.json.
From tools/:

powershell -File update.ps1

In-game: /reload then /spf status (missingGear / missingDR should trend toward 0).

Details, offline HTML merge, and parse notes are in tools/README.md.

Soft skins & companions

Addon	What SPF does
ElvUI	Character bar + minimap button use ElvUI Transparent / button skins when Blizzard character skins are enabled
EllesmereUI	Character bar + minimap button use EUI panel fill / PP border / fonts when Character Sheet theming is on
LariasWeeklyChecklist (optional)	Not integrated — use it alongside SPF for vault / crests / weekly ops

SPF stays a guide; weekly vault and crest tracking belong in a companion addon.

Contributing

Bug reports and scrape/parse fixes are welcome. When filing an issue, include:

Client build / Interface (120007)
Spec you’re looking at
/spf status output
Whether ElvUI or EllesmereUI is loaded

For data bugs, note whether a fresh browser_scrape.js + import still reproduces it.

Credits

Wowhead — PvE stat priority, BiS, and consumables guide pages (scraped; not affiliated)
SimulationCraft — secondary-stat conversion factors and DR bracket sizes used for true/lost rating
ElvUI / EllesmereUI — public skin helpers for optional Character bar and minimap chrome

Developed by Kkthnx. Built for players who want priorities and BiS without a kitchen-sink UI.

StatPriorityFirst