Auto Potion

Smart, always-up-to-date healing macros for Healthstones, healing potions, class/racial self-heals and bandages.

Auto Potion was previously known as Healthstone Auto Macro. The addon automatically maintains one or two macros for you:

AutoPotion – uses your class/racial healing spells, Healthstones and the best available healing potion (and some special healing items).
AutoBandage – optional bandage macro that always uses your strongest bandage, with special handling in battlegrounds.

You never have to edit these macros yourself – Auto Potion keeps them updated as your bags, talents and gear change.

What the addon does

Automatic healing macro: Keeps a /castsequence macro up to date so you can bind a single key for self-heals, Healthstones and healing potions.
Smart priority system:
- Class/racial healing spells (like Renewal, Exhilaration, Desperate Prayer, Gift of the Naaru, etc.).
- Optional support for Heartseeking Health Injector (engineering tinker) on Retail.
- Warlock Healthstones (including classic variants), with an option to lower their priority if you prefer potions first.
- The strongest available healing potion in your bags, including modern and legacy potions (Algari / Invigorating / Dreamwalker's / Withering / Cosmic / Spiritual / etc.).
- Optional Cavedweller's Delight support as a separate, toggleable step.
Smart battleground support:
- Uses the appropriate PvP-only healing draughts and bandages when you are in battlegrounds (e.g. Ashran tonic, Classic draughts and BG bandages).
Bandage macro:
- Maintains an AutoBandage macro that uses the best bandage available for your current game version and content.
Works across versions:
- Retail (The War Within and later), Classic Era, WotLK Classic, Cataclysm Classic and Mists of Pandaria Classic.

Macro maintenance:
- On login, /reload, leaving combat, changing talents, changing equipment, summoning a pet (for certain classes) or when your bags change, the addon:
- Scans your character for supported healing spells, Healthstones, healing potions and special items.
- Builds an ordered list based on your settings.
- Rebuilds the AutoPotion and AutoBandage macros.
Macro content (high level):
- Uses standard macro commands like /cast, /castsequence and /use with [@player] where appropriate.
- Can optionally include /stopcasting at the top of the macro if you enable that in the settings.
- Uses a reset= condition that can factor in the shortest cooldown of your selected healing spells if you enable the CD reset option.
Performance-friendly:
- Bag events are debounced so the macro is not rebuilt excessively when your bags change rapidly.
- Macro updates are postponed while in combat to comply with WoW's secure execution rules.

Install the addon
- Install via CurseForge/Wago or manually drop the AutoPotion folder into your Interface/AddOns directory.
Create the macro
- Create an empty macro called AutoPotion (and optionally AutoBandage) in the standard WoW macro UI.
Place it on your bars
- Drag the AutoPotion macro to your action bar and bind it to a comfortable key.
- If you use the bandage macro, do the same for AutoBandage.
Reload once
- Type /reload to let the addon initialize and populate the macros.
Configure (optional)
- Open the settings via /ap or through the Interface → AddOns → AutoPotion options panel to fine-tune priorities.

After this, just press your keybind whenever you need an emergency heal; Auto Potion will handle the rest according to your configuration.

Open the settings via /ap or Interface → AddOns → AutoPotion. The most important options are:

Class/Racial Spells:
- Choose which supported self-healing spells and racials should be part of the sequence for your class.
Include /stopcasting in the macro:
- Useful for casters; immediately stop your current cast before using a heal.
Include shortest cooldown in reset:
- Optionally include the shortest cooldown of your selected heals in the castsequence reset= condition. Use carefully if you are not familiar with castsequence behavior.
Low Priority Healthstones:
- Let health potions be used before Healthstones (or leave disabled to prefer Healthstones first).
Potion of Withering Vitality / Potion of Withering Dreams:
- Toggle whether these riskier potions are allowed in the rotation.
Cavedweller's Delight:
- Enable/disable Cavedweller's Delight (and its fleeting versions) as a separate step.
Heartseeking Health Injector (tinker):
- Enable support for the engineering tinker on Retail if you have it equipped.
Bandage Priority:
- Dedicated bandage priority display that shows which bandage will be used first (including battleground-specific bandages in Classic).

The UI also shows the current priority order for your heals and bandages so you can easily verify what the macro will do.

Auto Potion is designed to be fully compliant with World of Warcraft's Terms of Use and addon policies:

No automation of gameplay:
- The addon never presses buttons for you and does not trigger abilities automatically.
- You still need to manually press your keybind for the macro to activate any spell or item.
Uses only Blizzard-approved functionality:
- Relies on the normal macro system (/cast, /castsequence, /use, [@player], etc.).
- Respects combat lockdown rules and only edits macros when it is safe and allowed by the client.
No protected actions outside keypresses:
- All healing actions are executed exactly as if you had written the macro yourself – Auto Potion just keeps the macro text up to date.

In short: Auto Potion is a quality-of-life addon, not an automation or botting tool.

If you use the MegaMacro addon, Auto Potion can update your MegaMacro macros instead of the default WoW macro system.

Important setup steps:
- Create a Global macro in MegaMacro named AutoPotion.
- (Optional) Create another Global macro named AutoBandage if you want the bandage macro as well.
- Type /reload in-game.
How it behaves:
- When MegaMacro is installed and loaded, Auto Potion will not create or manage standard WoW macros for these names.
- Instead, it looks for the matching global MegaMacro entries and updates their macro text directly.
Troubleshooting:
- If you see an AutoPotion error about a missing MegaMacro macro:
- Verify that you created a Global (not character-specific) macro.
- Ensure the name is exactly AutoPotion (or AutoBandage for bandages).
- /reload after creating the macro so Auto Potion can detect and update it.

Once configured, you can use your MegaMacro-managed AutoPotion/AutoBandage macros exactly like the standard ones.

Q: Do I still need to press a key to heal?
A: Yes. The addon only updates the macro text. You must press your keybind for any heal, potion, or bandage to be used.
Q: Does this work in all versions of WoW?
A: Yes. Auto Potion supports Retail, Classic Era, WotLK Classic, Cataclysm Classic and Mists of Pandaria Classic, adapting the item and bandage lists to each version.
Q: Can I change which spells are used?
A: Yes. Open the settings (/ap) and toggle your preferred class/racial self-healing spells.
Q: What if I only want potions and Healthstones, no spells?
A: Simply disable all class/racial spells in the settings; the macro will then consist only of items.