FBHealBox - Healer QOL Addon, Like Healium

Player-made addons and UI configurations.
Qbixibq
Posts: 11

FBHealBox - Healer QOL Addon, Like Healium

Post#1 » Fri Sep 04, 2026 3:07 pm

After playing with Puppeteer for a while (3 days), I decided to port back Healium to WoW Vanilla. Didn't work. Healium was built on FBHealBox so I ported this back instead. But I decided to rework the addon's options menu. You can select spell ranks now, and the entire feature set has been massively overhauled for the 1.12 client.

What is FBHealBox Vanilla?
It is a compact, highly customizable healing interface that places up to 10 spell buttons directly next to your party members. It drastically reduces the need for complex mouseover macros or grid-clicking, giving you a straightforward visual layout for your heals and buffs.

Image

Image

Image


Download & Feedback
You can grab the latest release, check out the full feature list, or report any bugs/feature requests over on GitHub:
https://github.com/QbiXibQ/FBHealBox

Core Features

:arrow: Advanced Spell Selection: A custom-built cascading menu allows you to seamlessly assign specific spells and exact ranks to any button without breaking the Vanilla UI.

:arrow: Universal HealComm Support: Built-in HealComm protocol sync (no external libraries needed). It broadcasts your heals and reads incoming heals from others, making it 100% compatible with major addons like pfUI, Luna Unit Frames, and Puppeteer right out of the box.

:arrow: Smart Heal Prediction: Accurately visualizes incoming direct heals, HoT ticks, and Absorb shields on the health bars. It actively reads the combat log to learn your true +Heal bonus, automatically correcting the inaccurate 1.12 tooltips over time.

:arrow: Flexible Layout: Attach the spell buttons directly to Blizzard's default party frames, or use the addon's own freely movable nameplates.

:arrow: Instant Localization: Switch between English and German directly in the options—no /reload required.
Last edited by Qbixibq on Wed Sep 09, 2026 7:46 am, edited 8 times in total.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#2 » Fri Sep 04, 2026 11:21 pm

Hey

version 1.4.1 is out now.
grab it here: https://github.com/QbiXibQ/FBHealBox/releases

1.4.1 (2026-09-04)

New

- Pets. Every pet in the group (pet, partypet1 to partypet4) gets its own plate with the full set of heal buttons, stacked directly below its owner, indented by 12 px, with a paw icon and a light-blue name to tell it apart. Appears and disappears with UNIT_PET. Option Show pets.
- Mana bar. A 5 px blue bar along the bottom edge of the health bar ("bar in bar"), only for units whose power type is mana. Option Mana bar.
- Button and row spacing. Two sliders, 0 to 20 px each, for the gap between buttons and the gap between plates.
- Test mode. Fills the display with ghost players and pets (health, mana, shield, incoming heal, dispellable debuff, missing buff, out of range) so the layout can be arranged without a group. /fbp test or the checkbox. Not saved.
- Options window with two tabs. Buttons holds the button assignment, the button count and the right-click switch; General holds scale, spacing, all other switches, language and buff watch.
- Right-click spell. Every button can carry a second spell for right click. Off by default and only enabled through the Buttons tab; when on, a second column appears in the assignment and a small corner icon on each button shows the right-click spell. Assignments are kept when the switch is off.
- Click on a plate. Left and right click on a name or health bar target the unit by default. Both are configurable (General tab): Target, Unit menu, Move display, Nothing. Moving the display is now Shift + left drag (or the Move display action).
- Dead / ghost / offline. Shown as text in the bar instead of 0 %, with an empty grey bar and no mana strip.
- Line of sight. An eye badge on the plate's left edge while the unit is out of line of sight: live via the UnitXP client mod, otherwise inferred from the 'not in line of sight' error after your own heal attempt (8 s, cleared when a cast starts or a heal lands). Option Line of sight.
- Debuff icon. The icon of the first debuff your class can remove is shown next to the name, with its stack count. Option Debuff icon.
- Class colours. Names in class colour (client RAID_CLASS_COLORS, fallback table built in). Option Class colours.
- Buff watch. Pick one of your buffs; every plate whose unit is missing it gets an orange border. Group versions count as well, even when cast by another healer (texture check first, tooltip name scan as fallback). Pets are excluded unless Buff watch on pets is on.
- Range fading. Plates including their buttons fade to 50 % when the unit is out of range of your first assigned spell (28 yards without a spell). Option Range fading.
- /fbp config opens the options window; Escape closes it (registered in UISpecialFrames, plus a hook on ToggleGameMenu for clients that ignore that list). /fbp ends with a list of all commands.
- Saved plate position. The player plate keeps its position across reloads; scaling no longer moves it.

Changed

- All UNIT events run through one slot table (FBPartyUnit) instead of five copied handlers; HealBoxAttachMode and FBUpdateNames are loops.
- Spell buttons are created once and only re-assigned afterwards (previously rebuilt on every SPELLS_CHANGED, with random global names like Button3).
- Settings missing in an old saved-variables table are filled in on load (FBHealBox_ApplyDefaults).
- UNIT_MAXHEALTH is handled (was missing).

Fixed

- Documentation named a wrong client version; the addon targets client 1.12.1.
- Tooltip error on a button whose target does not exist.
- Division by zero for offline members (UnitHealthMax = 0).
- Plate position reset on every login.
Last edited by Qbixibq on Wed Sep 09, 2026 7:47 am, edited 2 times in total.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#3 » Sat Sep 05, 2026 6:32 am

Hey yo,

pushed 1.4.2, introducing the raid mode.

Grab it here: https://github.com/QbiXibQ/FBHealBox/releases/tag/1.4.2

----------

Changelog
1.4.2 (2026-09-05)

New: raid mode (module FBHealBox_Raid.lua, on by default, switches in automatically from 11 raid members; Raid view from N players is adjustable)

- Compact grid for 20 and 40 player raids: one cell per member in blocks of five per raid group, blocks arranged in rows (Groups per row). Empty groups collapse, so a 20-player raid is a single row.
- Each cell: name in class colour, health bar with shield and incoming-heal layers, 3 px mana strip, HP percent or deficit, dispel colouring, dead/ghost/offline text, range fading, line-of-sight eye, buff-watch border.
- Up to four mini buttons per cell, wired to Button 1 to N from the Buttons tab (right-click spells included). Click on a cell targets the unit (or unit menu / move / nothing, as configured for plates).
- Own options tab Raid mode with size, spacing, scale, headers, mana strip, HP text mode, title bar, hide-empty-groups and hide-party-plates switches.
- Raid test with 20 or 40 ghosts covering every visual state. /fbp raid, /fbp raidtest 20|40|off, raid line in /fbp.
- Grid position and scale are saved separately from the party plates. Party plates are hidden while the grid is up (switchable).

New: drag and drop. Spells can be dragged from the spellbook onto any heal button, raid mini button or options field. Right mouse button, or Shift held while dropping, fills the right-click side when that option is on. Spells outside the class list are accepted.

Fixed

- Double loading. The .xml included FBHealBox.lua a second time on top of the .toc. Every frame, hook and the options window existed twice. Visible effects: the raid tab was missing (added to the first, overwritten options window), Escape could crash the client (the second hook called itself), and learned absorb values were doubled (two prediction frames counted every absorb line). The .xml no longer loads scripts, and both Lua files refuse to run twice.
- Escape hook stores the original in a local upvalue, is installed at most once, and no longer uses a tail call.
- Learned absorb values above 1.5 times the tooltip are dropped on load; doubled values from earlier versions clean themselves up.

Changed

- Core gained a hook interface (FBHealBox_RegisterHook, FBHealBox_AddOptionsTab) so modules can attach without editing the core. No behaviour change for the party display.
- .toc now loads FBHealBox_Raid.lua after the core; removing that line disables raid mode entirely.
Last edited by Qbixibq on Wed Sep 09, 2026 7:47 am, edited 1 time in total.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#4 » Sat Sep 05, 2026 7:09 pm

Hey, v1.4.3 is available :D

Visit the release page to download: https://github.com/QbiXibQ/FBHealBox/releases/tag/1.4.3


Changelog
1.4.3 (2026-09-05)

New

- Languages. Spanish, French and Italian added to all addon texts (English and German unchanged). The client locale picks the language automatically, the language button lists all five, missing keys fall back to English.

- Mana ticker (module FBHealBox_Ticker.lua, on by default). A spark travels across your own mana strip every 2 seconds in step with the server's regeneration tick; after spending mana it turns orange and runs the five-second rule down, extended to the first tick after the five seconds. Works on the party plate and on your own raid cell, hidden while mana is full. Detection via UNIT_MANA only: grid from observed ticks, re-sync within a tolerance, foreign pulses (totems, Innervate) ignored, potions and runes filtered by size. Own options tab Ticker: master switch, five-second rule, tick tolerance, tick offset, spark width. /fbp ticker toggles, /fbp reports sync state.

- Smart Healing (off by default). When on, a click casts the lowest rank of the assigned spell whose expected heal covers the target's missing health (minus incoming healing) plus a safety margin (default 20 %). Never above the assigned rank, direct heals only, always the assigned rank below 30 % health. Learned heal values are used where available. Downsides (no crits in the estimate, burst damage, deliberate overhealing) are explained in the tooltip. Options on the Buttons tab; /fbp debug logs each decision, /fbp shows the state.

- Cooldown sweep on buttons, global cooldown excluded. Option Cooldowns on buttons.

- Red border for the attacked member: the plate or raid cell of the unit your hostile target is targeting. Takes precedence over the buff-watch border. Option Mark who is attacked.

- HoT and shield timers on buttons: each spell's button shows the remaining seconds of your own HoT (green) or shield (blue) on that unit; after Power Word: Shield the button shows Weakened Soul in red. Option HoT and shield timers.

- Smart Damage (module FBHealBox_Damage.lua, off by default). Attack spells pressed on any action bar or key binding are cast in the lowest rank that still kills the target, never above the rank on the bar. Target health from the server (real values), MobHealth3, MobInfo-2, or the addon's own per-mob-type estimate learned from combat-log damage and percent drops (highest measurement kept). Minimum damage per rank from the tooltip, raised by observed full hits. Section on the Extras tab (shared with the ticker) with switch, safety margin, live health-source line and spell list; /fbp damage, decisions in /fbp debug.

- Buff icons in the health bar: buffs with a duration that sit on your buttons (Fortitude, Divine Spirit, Fear Ward, Inner Fire) appear as small 8 px icons on the outer left side of the plate. The icon is a clock: it turns black and white clockwise from twelve o'clock as the time runs out (half left = right half grey). Exact on yourself, counted from your own cast on others, fully coloured when cast by someone else. Raid cells show them outside their left edge; the grid reserves the room. Line-of-sight badge moved to the plate's top-left corner. Units are scanned once after login and group changes so existing buffs appear immediately. /fbp buffs for diagnostics. Option Buff icons in the health bar.

- Test-mode ghost Dorn demonstrates the red border and the timers.


Fixed

- Own buffs were only read at login and on group changes: Vanilla fires PLAYER_AURAS_CHANGED for the player instead of UNIT_AURA. The addon now listens to it and re-reads your remaining time on every change, so recasting a buff on yourself resets its clock and cancelling it removes the icon. Also fixes confirmation of your own HoTs and shields on yourself.

- Raid cell names and percentages were hidden behind the health bar since the bar levels became relative; the texts now live on their own layer above the bars.

- Buff icons stack two high left of the plate; elapsed clock quadrants are drawn dark on a layer above the icon so the split shows on every client. Raid cells use a 3 by 4 grid of 6 px icons (twelve slots); the new raid option Show buffs removes icons and strip together. /fbp buffs reports the grey count per icon.

- Test modes extended: party ghost Brynn is dead, pet Bramble carries a disease, Dorn carries six and raid ghost 12 twelve buffs, raid ghost 27 a disease. Up to six buff icons per plate.

- Plate names could sit too low on some rows (the name box grew to two lines internally). Name, paw icon and debuff icon are now vertically centred with a fixed one-line height.

- Tooltip parser took durations ("for 30 min", "again for 15 sec") for direct heal amounts, so buffs such as Power Word: Fortitude and the shield reported a tiny "heal" and Smart Healing downranked them. Durations are ignored now, and Smart Healing only touches spells whose tooltip describes a heal and that carry no absorb.


Changed

- Option tab buttons are 100 px wide (was 110) so that four tabs fit in the window; class icon shrunk so it no longer overlaps the tabs. Checkbox labels have a fixed width and end with an ellipsis when a translation is long; the tooltip carries the full text. The fourth tab is called Extras and holds the ticker and Smart Damage sections.
- Tooltip parser: only hr/hour count as hours; Holy no longer looks like a time unit.
- New core hooks Loaded, Aggro, SpellTimers, Cooldowns for modules.
Last edited by Qbixibq on Wed Sep 09, 2026 7:47 am, edited 1 time in total.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#5 » Sun Sep 06, 2026 7:56 am

1.4.4 is now ready. No new features, because the addon seems feature complete for me.
1.4.4 is packed with performance fixes. Enjoy :)

-> https://github.com/QbiXibQ/FBHealBox/releases/tag/1.4.4


Changelog
1.4.4 (2026-09-06)

Performance pass. No feature was added or changed; every visible behaviour is meant to be identical. A simulated five-second raid fight (40 players, aura and health events, mana changes, combat log, 60 frames per second) went from about 63,900 API and widget calls to about 14,450, a reduction of 77 %.

Changed (internals)

- Button states centralised. The up to 260 heal buttons (10 plates x 10, 40 raid cells x 4) no longer carry their own SPELL_UPDATE_USABLE / SPELL_UPDATE_COOLDOWN handlers. One pass over the visible buttons queries usability and cooldown once per spell id and range once per button, and sets colours and cooldown sweeps only when the state changes. Several such events within one frame are merged into one pass.

- Display caches. Health text, bar maxima, bar values, bar colour and mana strip visibility are only written when they change. Dispellable debuffs are searched on UNIT_AURA only; UNIT_HEALTH and the prediction tick reuse the last result.

Aura scans shared. A unit's buff textures are read once per frame and shared between the heal prediction and the buff watch. Buff names resolved through tooltip scans are remembered per texture, so a unit missing the watched buff no longer costs up to 32 tooltip scans per aura event. Raid units are only scanned when something depends on them (own cast pending, tracked HoT or shield, or a visible cell).

- Cheaper ticks. Spell timers use precomputed base spell names instead of string parsing per button per tick and skip units without tracked HoTs or shields. Buff icons reuse their work tables, iterate a presorted list instead of sorting per tick, and update on change or once a second instead of five times a second. The attacked-member check skips entirely while there is no hostile target and nothing is marked, and compares names before calling UnitIsUnit.

- Event bursts coalesced. PARTY_MEMBERS_CHANGED, UNIT_PET and RAID_ROSTER_UPDATE set a flag that is processed once in the next frame instead of rebuilding plates and grid for every event of a burst.

- Mana ticker. Enabled/mana/full checks moved from every frame to mana events and option changes; the spark is re-anchored only when it has moved at least half a pixel; sizes and visibility are cached.

- Combat log. Heal patterns run only for buff events, the absorb pattern only for hit events that contain the word absorbed. Smart Damage parses damage lines only while enabled and while there is a target being measured or an own cast waiting; its live target line is refreshed only while the options window is open.

- Raid test ghost animation frame is hidden outside the raid test instead of running an empty update every frame.

- Client API compatibility. IsSpellInRange and IsUsableSpell do not exist in the 1.12 client (they came with 2.0). All range and usability checks now go through wrappers that use them when a client offers them and otherwise fall back to 1.12 means: spell range from the tooltip against UnitXP("distanceBetween") where available, else CheckInteractDistance (28 m, beyond that undecided rather than red); mana cost from the tooltip against your current mana. Because clients differ (2.0 style (id, "spell", unit) versus the Turtle client's (name, unit)), the addon probes both signatures once at login with pcall and uses the one the client understands; a function that keeps throwing is switched off in favour of the fallback. /fbp reports the detected form. Without this the new central button pass crashed at login.


Fixed

- The old per-button event handler declared this, event and arg1 as parameters, which shadowed the 1.12 globals; range colouring and cooldown sweeps on the buttons never worked in the game. They do now.
Last edited by Qbixibq on Wed Sep 09, 2026 7:47 am, edited 1 time in total.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#6 » Sun Sep 06, 2026 10:33 am

Hey!

Small update is out, adding missing spells.

-> https://github.com/QbiXibQ/FBHealBox/re ... ag/1.4.4.1

Changelog
1.4.4.1 (2026-09-06)

Buff tracking & class spells update. Fixes buff clock icons (Divine Spirit, etc.) not appearing next to the health bar, adds group buff alternate matching, and completes the spell selection lists across all healer classes with buffs, utility and rez spells.

Fixed

- Buff tracking & Tooltip scanning. In Vanilla 1.12.1, ClearLines() on the hidden scan tooltip (FBHealBoxScanTip) does not clear hidden text lines. Because FBPredict_TooltipText did not check fs:IsShown(), leftover lines from previously scanned heal spells (e.g. "Heals a friendly target...") lingered and were read when inspecting buff tooltips like Divine Spirit. This erroneously flagged info.isHeal = true, skipping buff duration detection (info.buff) and causing Divine Spirit not to display its clock icon and timer in the plate UI.

- Group buff alternate detection. FBPredict_BuildWatch and FBPredict_ScanUnit now track group buff variants (altTex). When a group buff is applied or present (Prayer of Fortitude, Prayer of Spirit, Gift of the Wild, Greater Blessings), the addon correctly recognises the aura, confirms pending casts, and displays the buff clock icon.

- Buff watch textures. FBLoadSpellData now flags all spells in FBBuffWatchSpells as addon spells (isHealBoxSpell = true), ensuring their textures and ranks are gathered and monitored even if they are not yet assigned to a heal button.

- Drag & drop instant sync. Dropping a spell onto a button now immediately calls FBPredict_BuildWatch(), updating tracked buffs and predictions without requiring a /reload.


New & Changed

- Expanded class spell lists. Greatly expanded Spell.Name for all classes so that all relevant buffs, utility spells, dispels, and resurrections appear in the cascading spell menus:

Priest: Added Power Word: Fortitude, Prayer of Fortitude, Divine Spirit, Prayer of Spirit, Shadow Protection, Prayer of Shadow Protection, Fear Ward, Power Infusion, Resurrection.

Druid: Added Mark of the Wild, Gift of the Wild, Thorns, Tranquility, Innervate, Rebirth, Cure Poison.

Paladin: Added all normal and Greater Blessings (Wisdom, Might, Kings, Salvation, Light, Sanctuary), Blessing of Freedom, Blessing of Sacrifice, Redemption, Divine Intervention.

Shaman: Added Ancestral Spirit, Purge, Water Walking, Water Breathing, Water Shield.

- Added optional support for Mage (Remove Lesser Curse, Arcane Intellect, Arcane Brilliance, Dampen Magic, Amplify Magic) and Warlock (Unending Breath, Detect Invisibility).

- Fear Ward in Buff Watch. Added Fear Ward to FBBuffWatchSpells for Priests.
Last edited by Qbixibq on Wed Sep 09, 2026 7:47 am, edited 1 time in total.

Ginjaninja
Posts: 2

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#7 » Mon Sep 07, 2026 6:22 am

Yo. This is sick and I tried to install it. Followed what I thought I did right with changing file name. But on the launcher it's sitting on "not versioned". Any help? Thanks.

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#8 » Mon Sep 07, 2026 10:49 am

Hi Ginjaninja,

All you need to do is Download the latest Release, unpack the ZIP file (folder "FBHealBox") into your Addons folder.

Should look like this:
Image

Launcher "Not versioned" is normal - I am waiting for my octowow git account to be unlocked, after this has happened I can fix this.

Image

Additionally I will condense the huge AddonDescription in 1.4.4.2.


Please share your feedback regarding the Addon here. ♥️

Qbixibq
Posts: 11

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#9 » Mon Sep 07, 2026 12:29 pm

Yo whats up?

New Version, just small adjustments.

https://github.com/QbiXibQ/FBHealBox/tag/1.4.4.2


Changelog
1.4.4.2 (2026-09-07)

Buff duration display update & bugfix. Replaces the 4-quadrant clock division for buff icons with a 32-step vertical duration wipe, offering much finer timer resolution, and fixes an syntax error when loading.

New & Changed

- 32-step buff icon duration display. The buff icons left of the health bar previously divided the remaining duration into 4 coarse quadrants (quarters). They now transition in 32 fine vertical steps (FBBUFFICON_STEPS = 32) from top to bottom. As a buff expires, the top portion is progressively desaturated and darkened in 32 increments. For a 30-minute buff like Power Word: Fortitude or Divine Spirit, the visual display now updates approximately every 56 seconds rather than once every 7.5 minutes.

- Optimised texture usage. Replaced the 4 quadrant textures and 4 wash textures per buff icon with a single dynamically cropped desaturated overlay (ic.qTex) and dark wash (ic.wTex), reducing texture objects by 75 % per buff icon while increasing visual granularity eightfold.

- Shortened addon notes. Better display in WoW-Launcher addon managers.
Last edited by Qbixibq on Wed Sep 09, 2026 7:48 am, edited 1 time in total.

Ginjaninja
Posts: 2

Re: FBHealBox - Healer QOL Addon, Like Healium

Post#10 » Tue Sep 08, 2026 6:43 am

Hey, thanks for responding. I reinstalled and it looks just like your ss. But it doesn't show the info on launcher like yours and still isn't working. It's not related to the client update/ddos is it?
Thanks.

Who is online

Users browsing this forum: No registered users and 1 guest