PriorityHelper

PriorityHelper is a compact combat coach for World of Warcraft 1.12.1. It supports all nine Vanilla classes and all 27 talent trees with spec-aware damage, tank, healing, area-of-effect, target-life, cooldown, and resource logic.

The recommendation window shows:

• the ability to use now, a secondary ready action, and an action worth pooling for;
• the matching action-bar hotkey in a large, high-contrast badge;
• a glow on the matching visible Blizzard or pfUI action button;
• separate interrupt and defensive alerts when the client can detect them;
• the reason for the recommendation; and
• current resources and a rolling target time-to-die estimate.

PriorityHelper never casts spells or automates combat. It only recommends the next action.

Installation

1. Download the latest release ZIP.
2. Extract it into World of Warcraft\Interface\AddOns.
3. Confirm the final path is Interface\AddOns\PriorityHelper\PriorityHelper.toc.
4. Restart WoW or reload the UI.

Usage

Target an enemy for damage or tank priorities. Healing specs can select a friendly target, and HEAL mode falls back to the player when no friendly target is selected.

Combat mode and activity context are independent. AUTO context detects leveling, parties, instances, and raids. LEVEL prioritizes kill-to-kill sustain, DUNGEON uses group-oriented target durability, and RAID assumes long-lived targets and complete maintenance setup.

Use the labeled PH minimap button to open Settings. Right-click it for Help, or drag it around the minimap. When pfUI's Addon Buttons panel is enabled, pfUI automatically places PH in that box.

Commands:

/ph                       Open Settings
/ph help                  Open Help
/ph mode auto             Automatic spec-aware behavior
/ph mode single           Single-target damage
/ph mode aoe              Multi-target damage
/ph mode tank             Threat/tank priority
/ph mode heal             Friendly-target healing
/ph context auto          Detect LEVEL/DUNGEON/RAID automatically
/ph context level         Leveling sustain and dangerous-pull logic
/ph context dungeon       Group and dungeon priorities
/ph context raid          Long-target raid priorities
/ph enemies 3             Expected nearby enemies (1-10)
/ph cds                    Toggle cooldown recommendations
/ph trinkets               Toggle trinket recommendations
/ph queue                  Toggle NOW/NEXT/POOL
/ph glow                   Toggle the visible action-button glow
/ph situational            Toggle interrupt and defensive alerts
/ph training               Toggle conservative training statistics
/ph stats                  Show observed named-cast training statistics
/ph snapshot               Print the current decision state and blockers
/ph disable Spell Name     Never recommend one learned ability
/ph enable Spell Name      Re-enable that ability
/ph lock | unlock          Lock or unlock the main window
/ph reset                  Reset the main window position
/ph rescan                 Rescan spells and talents

Vanilla limitations

WoW 1.12 does not safely expose every condition used by a modern rotation addon. Enemy count is therefore configured by the player. PriorityHelper uses cached action-button state for stance, form, resources, reaction windows, cooldowns, and range when the client exposes it. A learned spell missing from the bars can still be displayed with a NO BAR warning. Healing uses the highest learned rank because identical spell icons do not safely identify down-ranked action buttons.

Target-cast alerts require a target cast bar or a client-provided casting API. Special encounter mechanics, dispels, crowd control, and deliberate heal down-ranking remain manual decisions.

Development

The addon is self-contained in PriorityHelper/. Its Lua avoids post-Vanilla language features and guards optional/backported APIs.