Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

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.1, Season 2). 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: 2.0.0 · Interface: 120100 (Midnight, Season 2, patch 12.1.0)


Installation

Manual

  1. Place the StatPriorityFirst folder in World of Warcraft\_retail_\Interface\AddOns.
  2. Restart the game (or /reload if already in-game).
  3. 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, and 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

  1. Open wowhead.com → DevTools → Console.
  2. Paste tools/browser_scrape.js and wait for spf-wowhead-export.json.
  3. From tools/:
powershell -File update.ps1
  1. 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 (120100)
  • 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 Josh. Built for players who want priorities and BiS without a kitchen-sink UI.


License

All Rights Reserved. Copyright (c) 2026 Josh "Kkthnx" Russell. See LICENSE. You may run the addon in-game for personal use. Copying the source or assets into another project, redistributing, or publishing a modified version is not permitted without written permission.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages