HealBotBlue

Original HealBot, while being a staple healing addon in Wrath and later expansions, was in its infancy during Vanilla WoW. It was a memory and CPU hog that ate up resources, featured a clunky UI, and offered limited functions. To fix all of the above while still using it as a base framework, I refactored the entire codebase. The monolithic code structure was split to follow a more modern approach (MVC design pattern), making it more stable and easily editable. Additionally, the inefficient AURA scanning was replaced with lightweight (Observer Pattern) reactive programming. It now updates only what is necessary when a trigger fires, rather than performing clumsy, continuous scans of a 40-man raid. By doing so, I managed to throttle down CPU and memory usage significantly, placing it on par with modern addons. Additional functionalities are being added over time to provide a holistic, healer-centered raid frame.

NOTE: For HealBot to work correctly, the Selfcast feature in WoW options needs to be disabled.

Reporting Errors

Major errors will pop up a frame with error information. Take a screenshot and post comments.

Installation

Unpack the zipped file and place the HealBotBlue folder under Interface/AddOns in your World of Warcraft directory. Default installation path: C:\Program Files\World of Warcraft\Interface\AddOns\HealBotBlue

Chat Commands

/hb - Toggles the main HealBot panel on and off
/hb options - Toggles the HealBot options panel on and off
/hb reset - Resets the contents of the main HealBot panel

Key Features & Current Functionality

MVC & Observer Architecture: High-performance, reactive engine that updates frames dynamically on state changes, drastically reducing CPU and memory overhead compared to traditional polling.
Native Hovercasting (Mouseover): Cast configured spells on hovered unit frames using keybinds directly from your action bars, without losing your current target. (Toggleable in Options -> General).
Blizzard Party Frame Toggle: Toggle to automatically hide Blizzard's default party frames when in a group in favor of HealBot's layouts.
HoT & Buff Tracking: Intelligently track active HoTs and buffs directly on the grid frames with custom icons (e.g., Renew, Rejuvenation, Regrowth, Fear Ward).
Mana Bars for Healers: Enable and position mini-mana status bars next to unit frames, toggleable to display for healer classes only or all classes.
Equipment Bonus Integration: Automatically scans equipped gear (for classes capable of healing) to dynamically scale healing predictions.
Curse & Debuff Warning (CDC): Dynamic visual and audio alerts for cleanable debuffs. Customizable colors based on debuff type (Curse, Poison, Disease, Magic).
Pet & Familiar Frames: Dedicated, toggleable frames for tracking and healing player pets.
Customizable Health Text: Dynamic unit health display (Name Only, Percentage, Real Health, or Health Deficit).
Non-Mana Resource Tracking: Track Rage, Energy, and Focus for non-mana classes.
Highly Customizable Skins: Fully configure dimensions (width, height), row spacing, column layouts, custom textures, opacity, class-colored frames, and outline of fonts.

Known issues

New spell rank bug you may experience lua error spaming your chat frame after learning new healing spells. /reload will clear the issue. To be fixed next release

Change Log

v1.4

Extra Frame support for pets and familiars added: Togglable from healing tab - Extra frames option selected & pets selected from dropdown.
Customizable Health Text: Added a new dropdown in the Healing Options tab that allows users to choose how health text is displayed on unit frames (Name Only, Health Percentage, Real Health, or Health Deficit). Includes a smart truncation algorithm to preserve critical health numbers even if the unit name is too long.
Non-Mana Resource Tracking: Added a new toggle in the General Options tab to track secondary resources (Energy, Rage, Focus) for non-mana classes. Bars are dynamically color-coded based on the resource type.
Dropdown UI Initialization Fix: Resolved a Vanilla API bug where dropdown menus sharing an ID (like the new Health Text dropdown) would temporarily inherit text from previously loaded dropdowns (e.g., "Modern Flat").
Dynamic Modifier Tooltips: Fixed a bug where the spell tooltip would not dynamically update its spells when pressing modifier keys (Shift/Ctrl/Alt) while hovering over a unit frame. Registered the MODIFIER_STATE_CHANGED event to instantly refresh the tooltip.
Global Variable Namespace Refactoring: Executed a codebase-wide refactoring to encapsulate all floating global variables inside the HealBot_ or HEALBOT_ namespace. This prevents HealBot from silently shadowing other addons or the native WoW API, ensuring strict adherence to Vanilla Lua best practices. (Also resolved a namespace collision with InitSpells).
Chat Announcements & Mouseover Casts: Chat announcements are now correctly fired when using native Hovercasting (Mouseover). Additionally, added safety checks to prevent spamming chat announcements when accidentally clicking on a dead player (unless casting a resurrection spell).
New Priest Buff (Enlighten): Added the custom "Enlighten" buff to Priest trackable buffs, complete with the btnholyscriptures icon on unit frames.

1.3.3

Chat Panel Refactor: Completely replaced the spell selection dropdowns in the Chat tab with manual text input boxes, allowing users to type exact spell names (with or without ranks) directly, matching the behavior of the key-bindings configuration. Fixed a string matching bug caused by Vanilla WoW's hidden trailing spaces when comparing spell names, ensuring that both rankless (e.g. Flash Heal) and ranked inputs trigger correctly.
Chat Layout Stack: Restructured the Chat Options XML layout to correctly stack the inputs into neat rows, preventing horizontal overlap and providing more space for typing long announce messages.
UI Persistence Bug Fixes: Fixed a Vanilla WoW API quirk where unchecking the "Show Headers" or "Self Only" (Buffs) checkboxes caused the UI to either visually re-check itself or overwrite the setting with defaults upon a /reload.

1.3.2

UIDropDownMenu Fixes: Resolved native client crash (UIDROPDOWNMENU_OPEN_MENU nil concatenation) when setting values on closed dropdowns.

1.3.1

Hotfix: missing helper function restored Fixed issue with lua error for druids.

v1.3

General Options Layout & Renaming: Relabeled "Healing panel options" to "Mana bar options:", moved the "For Healers Only" checkbox side-by-side with "Show Mana Bars", and renamed "Enable mouse over action bar" to "Hovercasting".
OnShow Empty Panel Bug Fix: Solved the rendering issue where the options panel would load empty initially until another tab was clicked.
Backdrop Alpha Reset Bug Fix: Resolved a WoW API client quirk where showing the HealBot frame would reset the background color and alpha channel back to default white/transparent by calling SetBackdropColor after SetBackdrop.
Default Party Frame Toggle: Added a "Hide Default Party Frames" toggle option (fully localized in English, German, French, and Korean) to hide Blizzard's default party frames. Integrated immediate toggling on joining/leaving groups.
Safety Guards & Crash Prevention: Added safety guards to HidePartyFrame and ShowPartyFrame calls to prevent nil-value crashes when solo.
Checkbox State Initialization Fixes: Fixed options menu bugs where "Hide when Solo", "Show Mana Bars", and "For Healers Only" checkboxes failed to reflect their saved configuration value when opening the menu.
CurrentPanel Nil Comparison Fix: Fixed a startup Lua comparison crash by initializing HealBot_Options_CurrentPanel at the top of the main options file.
Monolithic Code Modularization (Options): Split the massive, single-file options system (HealBot_Options.xml/HealBot_Options.lua) into 7 dedicated, content-named panel subfiles (General, Spells, Healing, CDC, Skins, Buffs, and Chat) to improve codebase modularity and stability.
Core Code Decoupling (MVC & Observer Pattern): Modularized HealBot.lua and HealBot_Action.lua by decoupling them into dedicated service files: Range, Comms, Aura, Spells, Events controllers, and Layout, Tooltip views.
Scope Resolution Fix: Promoted HealBot_Options_ComboButtons_Button to global scope in the base options file to resolve a nil comparison error when loading spell settings.
Global Scoping & Variable Promotion: Promoted CalcEquipBonus, HealBot_EquipChangeTimer, HealValue, InitSpells, and Delay_RecalcParty to global scope in HealBot.lua to ensure cross-module visibility.
CTRA Resurrection Cancel Bug Fix: Fixed a nil table indexing crash in the CTRA RESNO message handler in HealBot_Controller_Comms.lua.
Core Options Layout Correction: Relocated the "Defaults" and "Close" buttons back into the parent options frame's container, ensuring they display consistently at the bottom of all configuration tabs.
UI Layout & Skins Alignment: Reorganized all 13 opacity sliders on the Skins panel into a clean, uniform 2-column grid with explicit width/height sizes (123 x 17) to resolve layout overlaps. Realigned Chat tab buttons to stay within window bounds and corrected Color Picker anchors.
Startup Refresh Optimization: Resolved initial loading lag where action bars would be missing by forcing an immediate UI refresh (HealBot_RecalcSpells()) once spell data loads.
Menu Cleanup: Fixed Options panel checkboxes overlapping due to incorrect vertical spacing offsets.
Target Restoration Fix: Fixed spell interruptions and "You don't have a target" errors when healing by implementing a 0.1-second delayed target restoration using TargetLastEnemy and TargetLastTarget.
Buff Watch Initialization & Options Fix: Fixed a bug where buff watch failed to display missing buffs on login/UI reload when the player had no active buffs. Enabled immediate buff/aura rescanning when modifying options in the Buff watch configuration tab.

v1.2.2

White background fix Fixed issue where white background would persist while alpha channel got changes.
Alpha slider Fixed bug where alpha slider wouldn't apply changes instantly.

v1.2.1

Initialization bug Fixed issue where Action module would get stuck on infinite loop causing stack overflow.

v1.2

Class Colors & Dimming: Frame text now inherits class colors with black outline for better visibility. Missing buffs intelligently dim the class color and turn the text yellow.
Modern Skin Updates: Fixed white background bugs in modern skins and brightened debuff indicators.
Bug Fix (Buff Application): Fixed a Vanilla WoW API bug where applying buffs to a target without having them explicitly selected would trigger auto-self-cast instead.
Bug Fix (Health Block): Fixed a bug where the "Always Heal" option (preventing heals on full HP targets) completely blocked the ability to click frames to apply missing buffs.

v1.1

Native Hovercasting: Added a native Action Bar Hovercasting (Mouseover) engine. You can now cast spells on hovered targets using action bar keybinds without losing your current target. Togglable in Options -> General.
Fear Ward Tracking: Added Fear Ward to the global HoT tracker, which will display the icon directly on the unit frame.
Bug Fix: Fixed Shaman weapon buff tracking (e.g., Rockbiter) failing due to spell ranks in tooltips.
Bug Fix: Fixed missing health bar skin textures by ensuring .tga paths are explicitly resolved.
Bug Fix: Fixed division-by-zero math errors during UI scaling that caused the addon to crash.

v1.0

Buff tracking: Added a submenu for tracking buffs on elements.
HoT tracking with icons: HoTs and DoTs display on player bars.
Incoming heals: Now using a newer protocol.
Chat functionalities: Modified chat functionalities for spellcast announcements.
Mana Bars: Mana bars for healers in the grid added, toggleable from the options menu.