Puppeteer

A unit frames addon for World of Warcraft Vanilla 1.12, tailored for healers and useful for any class.

Low-garbage build of OldManAlpha/Puppeteer

This customized fork includes Blizzard Modern health and power textures, optional white numbers, and the existing low-garbage improvements. Puppeteer was formerly known as HealersMate.

Installation

1. Download the repository as a ZIP and extract it.
2. Rename the extracted addon folder to Puppeteer.
3. Place it in World of Warcraft/Interface/AddOns/.
4. Confirm the file structure is Interface/AddOns/Puppeteer/Puppeteer.toc, with no extra nested folder.
5. Restart WoW completely after installing new texture files, then enable Puppeteer at character selection.

When updating, back up your existing addon folder and preserve your WTF folder to keep saved settings.

Type /pt to open the configuration menu.

Features

• Party, raid, pet, target, and supported focus/enemy frames.
• Health, power, incoming healing, aggro, raid marks, PvP status, and relevant buffs/debuffs.
• Mouse, mouse-wheel, and keyboard bindings with Shift, Ctrl, and Alt modifiers.
• Spell tooltips with bound actions and resource costs.
• Role assignments and multiple frame styles.
• Optional client-mod support for enhanced distance checks, line-of-sight indicators, aura timers, and casting.

Blizzard Modern appearance

Open /pt → Customize, then choose the style under Edit Style.

Setting	Selection	Effect
Health Bar Texture	Blizzard Modern	Uses the supplied Blizzard Retail Bar texture.
Health Bar Color	Class	Uses the matching nine-class palette when Blizzard Modern is selected.
Power Bar Texture	Blizzard Modern	Uses colored mana, rage, focus, and energy artwork with an opaque black backing.
Health Numbers Color	White	Makes normal health values and percentages white.
Power Numbers Color	White	Makes power values and percentages white.

Click Reload UI after changing style settings.

Settings are separate for each style. Configuring Default does not configure Small, Very Small, Long, or the other styles. Select each style you use and apply the desired options there.

Choose Use Style Default for either numbers setting to restore the normal gold font color. White numbers work with any bar texture. Existing health hover highlights, debuff indicators, missing-health colors, and status-message colors retain their behavior.

Power artwork follows the unit's current resource, including shapeshifts. Mana uses the rectangular ManaClass texture for every class. Rogue and druid energy use EnergyClass; other resources use the reference's Player-family variants. Enemy bars retain their separate health-color setting.

Saved selections previously named Modern Blizzard automatically migrate to Blizzard Modern.

Other changes in this fork

• Reduced temporary allocations in combat, group updates, target changes, healing, and aura handling. See CHANGELOG-lowgc.md for the existing implementation notes and simulated measurements.
• Puppeteer Flat and Puppeteer Flat Borderless textures.
• Optional owner class colors for pets.
• Move frames with hidden titles by holding Shift+Ctrl+Alt and left-dragging a unit frame, unless frames are locked.
• Shorter Party/Raid title bars.
• Raid/healer mana information in the Raid header, with reporting for raid leaders and officers.
• A Vanilla Shaman Color option for the original pink class color.

Commands

Command	Action
/pt	Open configuration.
/pt help	Show available commands.
/pt testui [count]	Show fake raid members for layout testing; count is 1–40.
/pt reset	Reset frame positions.
/pt toggle	Toggle frame visibility.

Optional client mods

Puppeteer includes support for SuperWoW, UnitXP SP3, and Nampower. Available enhancements depend on the installed provider and version. Check Puppeteer's client-mod information in its settings for detection and available features.

Blizzard Modern textures and white-number settings do not require ShaguTweaks or BetterBlizzFrames at runtime.

Troubleshooting

• Addon does not load: check that the folder is named Puppeteer and that Puppeteer.toc is directly inside it.
• Small or another style still has the old mana color: select that exact style under Customize, set Power Bar Texture to Blizzard Modern, and reload.
• New textures do not appear: exit WoW completely and restart; reloading alone may not discover newly installed assets.
• Power numbers are missing: some styles hide them by default. Change Power Display for that style if you want them visible.
• Focus/enemy frames fail with PerfBoost: the inherited troubleshooting guidance is to disable its Filter GUID Events setting.

Credits and artwork

• OldManAlpha — Puppeteer.
• Richard Truax / i2ichardt — original HealersMate.
• skrymsli — contributions incorporated into this fork.
• Shagu — utility functions and inspiration.
• OEVG — customized fork.
• Blizzard Entertainment — resource artwork.
• Bodify / BetterBlizzFrames — source of the Blizzard Retail Bar health texture.

The health texture and power artwork retain their original rights and attribution; inclusion does not grant new artwork rights. See MODERN-BLIZZARD.txt and MODERN-POWER-NOTICES.md for details.