Healpop

## HealPop

One button that fires the strongest self-heal you have right now — spell,
healthstone, potion, trinket, food or bandage — chosen live from what is
actually off cooldown and in your bags.

Built for **Classic Era (1.15.x)** and **TBC Classic / Anniversary (2.5.x)**.

### What it picks

Six categories, in a priority order you control: spells, healthstones,
potions, trinkets, food & tubers, and bandages. Spells, healthstones and
potions are on by default; the rest are a checkbox away.

Within a category, entries sort by how much health they actually restore,
strongest first. Between categories, you set the order — and you can disable
any individual spell or item you would rather save.

**Healing amounts come from the client's own tooltip**, so Improved
Healthstone ranks, Alchemist's Stone effects and anything Blizzard retunes are
picked up automatically. Shipped tables are only a fallback for items whose
tooltip has not been cached yet. Healing consumables in your bags that are not
in the tables get detected and sorted into the right category on their own.

**Items sharing a cooldown collapse to one entry.** Using any healthstone puts
every healthstone down, and all healing potions share the two-minute potion
cooldown, so listing the weaker ones implies a fallback that does not exist.
Only the strongest of each group is shown, with a dim `+N` marking how many it
stands in for.

### Left-click items, right-click spells

WoW locks a button's action the moment you enter combat, so HealPop keeps two
macros pointed at your best currently-usable options and rebuilds them out of
combat.

The split is mechanical, not cosmetic. A spell's global cooldown blocks another
spell, and an item's cooldown blocks another item — but spell into item crosses
tracks and fires both. Keeping them on separate clicks means **neither side can
ever spend two things**. Left-click is the panic button, falling through your
consumables as they run out; right-click spends your free cooldowns.

If you would rather have one button for everything, "One click, may spend
extra" chains the whole list into left-click. Off by default, because spending
a spell and a healthstone on one press is a real cost.

### Spell guard

Healing items fail harmlessly at full health — the game refuses before
anything is consumed. Spells do not: Desperate Prayer will cast at 100%, heal
nothing, and go on cooldown.

Above a threshold you set (default 90%), spell lines are emitted with a
`[combat]` conditional rather than dropped. Dropping them would be worse than
useless, since you are almost always at full health when you pull — the chain
you take into the fight would be the one without your cooldowns in it.

### Everything else

A mouseover panel shows what is next, how much it heals, and what is still
cooling down; pin it open if you prefer. The button is draggable, scalable and
lockable. `/healpop` opens the config, `/hp list` prints the full ranking with
live cooldowns.

Bind a key under **Key Bindings → HealPop → Pop best heal**. Clicking a button
mid-pull is not the point.