QbiXibQHeal Box Vanilla
ADDON DOCUMENTATION · VERSION 1.4 · CLIENT 1.12 / 1.21.1
Party and self heal display with quick-cast buttons for healers. One name plate with a health bar per group slot, and next to it up to ten freely assignable spell buttons. On top of that a complete heal prediction — direct heals, remaining HoT ticks and absorb shields — that corrects itself from the combat log and shares its numbers with other healers in the HealComm format. The interface is available in English and German, switchable in the options window.
The short version: click the minimap button → options window → pick a spell for each button → done. Everything else happens on its own. /fbp tells you at any time what the prediction currently believes.
---
Installation
Download zip, unpack into your Addons folder.
The folder under Interface\\AddOns is called FBHealBox and holds three files:
| File | Contents |
|---|---|
FBHealBox.toc |
Metadata, load order, saved variables |
FBHealBox.lua |
The entire addon code |
FBHealBox.xml |
Only the event frame that calls FBHealBox\_OnLoad and FBHealBox\_OnEvent |
The folder name must match the name of the .toc file — otherwise the addon never starts. If you want to rename the folder, also change the FBADDON\_FOLDER constant near the top of FBHealBox.lua, because the ADDON\_LOADED check depends on it. The display name lives separately in FBADDON\_NAME and can be changed freely.
Optional: SuperWoW. When detected, the addon prints \[SuperWoW detected] at login and casts directly on the group member without touching your current target. Without SuperWoW it briefly switches target for the cast and restores the previous one afterwards.
No libraries required. No Ace, no HealComm, no RosterLib. The addon speaks the HealComm protocol directly, see HealComm sync.
---
The display
Five name plates: FBHealBox1 is always the player, FBHealBox2 through FBHealBox5 are party1 through party4. Each shows name, health percentage and a layered bar. To move them: drag your own plate with the left mouse button — the others are anchored to it and follow.
Bar layers
Three status bars sit exactly on top of each other, ordered by fixed frame levels (FBHealBox\_SetBarStrata). Health is on top and opaque, the shield below it, the heal prediction at the bottom:
| Layer | Colour | Meaning |
|---|---|---|
| Health | green / yellow / red, opaque | Current HP. Green above 60 %, yellow 30–60 %, red below |
| Shield | light blue, 50 % | Remaining absorb, directly behind the current HP |
| Prediction | light green, 50 % | Incoming healing, behind the shield segment |
Everything is clipped at the end of the bar: a shield exceeding maximum HP stays invisible and the scale stays true to the unit's health.
Dispel colouring
If someone carries a debuff your class can remove, their health bar takes the debuff colour instead of the HP colour:
| Class | Types detected |
|---|---|
| Priest | Magic (blue), Disease (brown) |
| Paladin | Magic, Poison (green), Disease |
| Shaman | Poison, Disease |
| Druid | Curse (purple), Poison |
The thresholds for the HP colours are LowHP (0.6) and VeryLowHP (0.3) near the top of the file.
---
The spell buttons
Up to ten buttons sit next to each plate, each showing its spell's icon. A left click casts that spell on exactly this group member — no matter who you currently have targeted.
The icon tints to show the state:
| Icon | State |
|---|---|
| Normal | Spell is castable |
| Bluish | Not enough mana |
| Dark grey | Not castable (cooldown, missing requirement) |
| Reddish | Target out of range |
Hovering shows the full spell tooltip plus the line Heal Box Vanilla Target: <name>, so it is always clear who this button serves.
---
Options window
Opened through the minimap button:
| Input | Effect |
|---|---|
| Left click | Toggle the options window |
| Shift + left click | Show/hide the entire display |
| Hold right and drag | Move the minimap button |
Inside the window:
Button 1 to 10 — one field each with icon and spell name. Clicking opens the spell menu (see below). The assignment is saved per character.
Show N buttons — how many of the ten buttons actually appear (0–10). Assigned but hidden buttons keep their spell.
Frame scale — scales the plates from 0.6 to 1.5. Has no effect in party-frame mode.
Default party frames — instead of the addon's own plates, the buttons attach to Blizzard's default party frames. The addon's name plates and bars are hidden; the heal prediction keeps working invisibly.
HealComm sync — exchanges heal information with the group, see HealComm sync. On by default.
Language / Sprache — switches between English and German. The button opens the same cascading menu as the spell picker. The change takes effect immediately: FBHealBox\_ApplyLocale() relabels the already-built interface, no /reload needed. On first start GetLocale() decides — German clients start in German, everything else in English. The choice is saved per character.
To move the window: drag its frame. Close it with the X in the top right.
---
The spell menu
A custom cascading menu, not UIDropDownMenu — the 1.12 implementation of the latter closes submenus as soon as the mouse brushes a neighbouring entry, and forces check marks and a click sound.
- Level 1 lists every learned spell of your class from the spell list, each with its icon.
- An arrow on the right means multiple ranks exist. The submenu opens on hover, overlaps the parent list by two pixels and has a 14-pixel tolerance zone around it so the mouse never loses it on the way over.
- Open stays open: only picking a rank, opening another submenu, or clicking outside closes it. After three seconds without the mouse nearby an emergency timer fires (
FBMENU\_GRACE\_TIME, set it to 999 to disable). - No spell at the top clears the button again.
The selection is stored as the cast string Spell(Rank N) — exactly the form CastSpellByName expects, and the reason the prediction knows the precise rank.
---
Heal prediction
The heart of the addon. Three independent sources feed the bars.
Direct heals
SPELLCAST\_START provides the spell name and the cast time in milliseconds — regardless of whether the cast came from a Heal Box button, the action bar or a macro. No hook on CastSpellByName is required. The preview disappears on SPELLCAST\_STOP, \_FAILED and \_INTERRUPTED; pushback (SPELLCAST\_DELAYED) extends it.
Instants deliberately get no prediction: the healing has landed before a bar could show it.
Heal over time
UnitBuff() reports no remaining duration for other units, so the addon keeps its own books:
- The button registers the cast including target and rank.
UNIT\_AURAconfirms the application by comparing the buff texture with the spellbook icon (locale independent, no tooltip scan per event).- What is shown is
remaining ticks × healing per tick, with the remaining ticks derived from(expiry − GetTime()) / interval. The bar therefore counts down tick by tick. - If the buff disappears early — dispel, death, overwritten — the display is gone immediately.
HoTs cast from the action bar are recognised as well, then with the highest known rank; the first combat log tick straightens the value out.
The tick interval cannot be read from the tooltip in Vanilla and therefore lives in FBPredictTickInterval (3 seconds by default, Lifebloom 1).
Absorb shields
Maximum absorb from the spellbook tooltip, consumption from the combat log ((123 absorbed)). For \*\_VS\_SELF\_\* events the victim is the player, otherwise the message is searched for one of the currently shielded names.
If you absorb more than the tooltip allows — heal gear — the maximum is corrected upwards and remembered. That correction is one-directional and therefore safe: more than possible cannot have been absorbed.
Fully absorbed hits report no number in Vanilla. The remaining value then stands until the buff drops and the display is cleared. Likewise absorbs on group members only count as far as the combat log shows them at all — the aura check catches the drift at the end.
Self-correction and learned values
Tooltips in 1.12 only provide base values without +healing, and there is no API for spell power. The combat log, on the other hand, tells the truth:
| Observation | Effect |
|---|---|
… gains 194 health from your Renew. |
Sets the real healing per tick for all remaining ticks |
Your Flash Heal heals Bob for 1240. |
Settles the estimate in (50/50 averaging) |
(342 absorbed) above the maximum |
Raises the assumed shield value |
All of it lands per spell and rank in HealBox.PredictMemory and survives logout.
Two safeguards keep that memory clean. Crits are not learned — the crit wording makes the spell name come through the pattern as "Flash Heal critically", which is in no watch list. And learning only happens with a confirmed rank, that is on casts through the Heal Box buttons; otherwise a rank 3 cast from the action bar would be attributed to the maximum rank and drag the prediction down. The live display still corrects itself either way; only the persistent memory is protected.
What a spell can do is decided by its own tooltip — and a spell may be several things at once. Regrowth, for instance, provides an instant portion and a HoT, and is treated as both.
---
HealComm sync
HealComm-1.0 broadcasts plain text through SendAddonMessage with the prefix HealComm. Heal Box Vanilla speaks that protocol directly — without embedding the library. Puppeteer, pfUI, Luna Unit Frames, CT_RaidAssist and everything else HealComm-aware therefore see your announced heals, and you see theirs.
| Message | Meaning |
|---|---|
Heal/<target>/<amount>/<cast time ms>/ |
Direct heal starts |
Healstop |
Cast interrupted |
Healdelay/<ms>/ |
Pushback |
GrpHeal/<amount>/<ms>/<t1>/<t2>/… |
Group heal (Prayer of Healing) |
GrpHealstop · GrpHealdelay/<ms>/ |
Same for group heals |
Renew · Reju · Regr /<target>/<duration>/ |
HoT applied |
Messages go to the raid, otherwise to the party, otherwise nowhere. The amounts are the self-corrected combat log values, so arguably more accurate than what a real HealComm estimates with ItemBonusLib.
A few details: on a successful cast end no Healstop is sent — HealComm receivers expire the entry themselves at cast time. Prayer of Healing correctly goes out as GrpHeal with every target in range. And a HoT cast from the action bar is reported after the fact on the first own combat log tick, with the duration still remaining — because only "… from your Renew" proves that it is yours.
On receive, your own messages are filtered by sender name, and since HealComm stores incoming heals per caster nothing can double up — not even when a real HealComm is broadcasting alongside. HoT messages carry only durations and no amounts; HealComm does not count them in its own getHeal, and neither does this addon.
The protocol knows nothing about absorb shields — those stay local.
---
Slash commands
| Command | Effect |
|---|---|
/fbp |
Status report: every tooltip value read per spell (direct, HoT and shield portion, learned values in parentheses), all currently running predictions, the state of the HealComm sync and the incoming heals received |
/fbp debug |
Toggles live output. Reports every detected cast, every correction, every absorb and every message sent (\[FBP>]) |
/fbp reset |
Discards all learned values and re-reads the tooltips |
/fbp is the first place to look when something is not displayed: if a spell is not listed there, the tooltip parser did not recognise it — the display is not at fault.
---
Saved settings
Everything lives in the HealBox table, saved per character:
| Key | Contents |
|---|---|
SpellChoice\[1..10] |
Cast string per button, e.g. Renew(Rank 10) |
MaxButtons |
How many buttons are shown |
Scale |
Scale of the plates |
AttachMode |
0 = own plates, 1 = default party frames |
Active |
Display on/off (shift + left click on the minimap) |
HealComm |
1 = sync on, 0 = off |
Locale |
deDE or enUS |
PredictMemory |
Learned heal values per spell and rank |
---
Configuration in code
Every knob is a global at the top of its own section and can be changed without touching the logic.
| Constant | Default | Effect |
|---|---|---|
LowHP · VeryLowHP |
0.6 · 0.3 | Thresholds for yellow and red |
NamePlateWidth · NamePlateHeight |
120 · 28 | Size of one plate |
xSpacing |
2 | Gap between the buttons |
MaxButtonCount |
10 | Maximum number of buttons |
FBMENU\_BTN\_HEIGHT · FBMENU\_ICON\_SIZE |
17 · 16 | Row height and icon size in the menu |
FBMENU\_MOUSE\_PAD |
14 | Tolerance zone around the menus |
FBMENU\_GRACE\_TIME |
3.0 | Menu auto-close (999 = off) |
FBPREDICT\_TICK\_DEFAULT |
3 | Default tick interval for HoTs |
FBPREDICT\_THROTTLE |
0.2 | Update rate of the prediction |
FBPREDICT\_CONFIRM\_TIME |
3.0 | Time to wait for the aura confirmation |
FBPREDICT\_TARGET\_TIME |
2.0 | Lifetime of the remembered cast target |
FBPredictTickInterval |
{Lifebloom = 1} |
Deviating tick intervals |
FBCommGroupHeal |
{Prayer of Healing} |
What is broadcast as GrpHeal |
FBLocale |
enUS, deDE |
Every visible string, per language |
---
Function reference
Display and frames
| Function | Purpose |
|---|---|
FBHealBox\_OnLoad() |
Event registration, startup message |
FBHealBox\_OnEvent(event, arg1) |
Central event dispatch |
FBHealBoxSetup() |
Creates the five plates |
FBHealBoxCreateFrame(…) |
Builds one plate including its three bars |
FBHealBox\_SetBarStrata(f, strata) |
Stacks health / shield / prediction |
FBHealBox\_UpdateUnit(unit, frame) |
Writes HP, shield, prediction and dispel colour into a plate |
FBHealBox\_RefreshAllBars() |
Updates all five |
FBUpdateNames() |
Names and visibility after a group change |
HealBoxAttachMode(mode) |
Switch between own plates ↔ default party frames |
HealBoxScale(this, scale) |
Scaling |
Buttons and spell data
| Function | Purpose |
|---|---|
FBHealBoxCreateButton(…) |
One spell button including cast logic and tooltip |
FBHealBoxButtons() |
Rebuilds all buttons |
FBHealBoxButtonsChanged() |
Refreshes icons and assignment without rebuilding |
FBLoadSpellData() |
Scans the spellbook, collects all ranks |
FBApplySpellChoice(i, castString) |
Assigns a spell to a button |
HealBoxButton\_OnEvent(…) |
Tints the icon by mana, cooldown and range |
Spell menu
| Function | Purpose |
|---|---|
FBMenu\_OpenMenu(entries, anchor) |
Opens any entry list as a menu |
FBMenu\_OpenSpellMenu(btnIndex, anchor) |
Opens the menu for one options button |
FBMenu\_OpenLanguageMenu(anchor) |
The language picker |
FBMenu\_ShowLevel(level, entries, anchor) |
Builds and positions one menu level |
FBMenu\_BuildSpellEntries() |
Level 1: all learned spells |
FBMenu\_BuildRankEntries(spellName) |
Level 2: all ranks of one spell |
FBMenu\_SelectSpell(entry) · FBMenu\_ClearSpell() |
Apply a selection, or clear the button |
FBMenu\_CloseAll() · FBMenu\_IsOpen() |
Close the menu, query its state |
Prediction — queries
The four functions that feed the bars. All of them expect a player name, not a unit ID:
| Function | Returns |
|---|---|
FBGetDirectHeal(name) |
Amount of your running direct cast |
FBGetHoTHeal(name) |
Sum of all your outstanding HoT ticks |
FBGetShield(name) |
Remaining absorb |
FBGetCommHeal(name) |
Healing announced by other healers |
Prediction — internals
| Function | Purpose |
|---|---|
FBPredict\_GetSpellInfo(bookID, name) |
Parses the spellbook tooltip (direct / HoT / shield) |
FBPredict\_BuildWatch() |
Builds the watch list after every spellbook scan |
FBPredict\_NoteCast(castString, target) |
Registers target and rank before the cast |
FBPredict\_CastStart(spell, castMs) · FBPredict\_CastEnd() |
Start and end a direct heal |
FBPredict\_ScanUnit(unit) |
Aura check: confirm application, detect removal |
FBPredict\_StartHoT(…) · FBPredict\_StartShield(…) |
Arm the tracking |
FBPredict\_ParseCombat(event, msg) |
Combat log evaluation |
FBPredict\_OnTick(…) · FBPredict\_OnDirectHeal(…) · FBPredict\_OnAbsorb(…) |
The three correction paths |
FBPredict\_Remember(…) · FBPredict\_Remembered(…) |
Write and read the learned values |
FBPredict\_TicksLeft(e, now) |
Remaining ticks of a HoT |
HealComm
| Function | Purpose |
|---|---|
FBComm\_Enabled() |
Is the sync switched on? |
FBComm\_Send(msg) |
Raw send to raid or party |
FBComm\_SendHealStart(…) |
Heal or GrpHeal |
FBComm\_SendHealStop() · FBComm\_SendHealDelay(ms) |
Interrupt and pushback |
FBComm\_SendHoT(spell, target, dur) |
Renew / Reju / Regr |
FBComm\_OnMessage(prefix, msg, channel, sender) |
Receive and evaluate |
Localization
| Function | Purpose |
|---|---|
FBT(key) |
Looks up a string in the active language, falls back to English |
FBSetLocale(code, apply) |
Switches language and optionally relabels the interface |
FBDetectLocale() |
Default language from GetLocale() |
FBHealBox\_ApplyLocale() |
Relabels the already-built interface |
---
Troubleshooting
A spell does not appear in the menu. It is not in your class's spell list (Spell.Name near the top of the file), or not learned yet. The list can be extended freely.
No prediction for a particular spell. Run /fbp: if the spell is not among the spells read, the tooltip parser did not recognise it. Wording can differ on custom servers — the patterns all sit in FBPredict\_GetSpellInfo.
Combat log corrections do not take. The patterns are built from the client's global strings (PERIODICAURAHEALOTHERSELF, HEALEDSELFOTHER, ABSORB\_TRAILER) and otherwise fall back to English defaults. /fbp debug shows whether corrections arrive.
Values are too low. Before the first observed heal only the tooltip base value without +healing is available. A single cast through the buttons is enough to settle it.
The HealComm sync seems dead. It only sends in a party or raid — alone nothing happens. /fbp shows the switch state, /fbp debug every outgoing message.
Numbers are off after a gear change. They correct themselves on the next cast; /fbp reset forces a fresh start.
---
Class spells
The preset lists — freely extensible in Spell.Name:
| Class | Spells |
|---|---|
| Priest | Renew · Flash Heal · Lesser Heal · Heal · Greater Heal · Binding Heal · Prayer of Healing · Prayer of Mending · Circle of Healing · Power Word: Shield · Abolish Disease · Cure Disease · Dispel Magic |
| Druid | Rejuvenation · Regrowth · Lifebloom · Healing Touch · Swiftmend · Remove Curse · Abolish Poison |
| Shaman | Lesser Healing Wave · Healing Wave · Chain Heal · Earth Shield · Cure Poison · Cure Disease |
| Paladin | Flash of Light · Holy Light · Holy Shock · Lay on Hands · Purify · Cleanse · Blessing of Protection |
Entries that do not exist do no harm: if the spellbook scan does not find them, they are quietly skipped.
---
Credits
Original: Heal Box by Dourd (Argent Dawn EU), UI Overhauled. The core idea, the layout with name plates and quick-cast buttons and the original options window are his. Without that groundwork this addon would not exist. Credit where credit is due.
Ported to Vanilla and extended 09/2026: Mquadrat. Ported to client 1.12 / 1.21.1 with optional SuperWoW support, plus:
- a custom cascading menu for spell and rank selection, because
UIDropDownMenuprovides no usable submenus in 1.12 - heal prediction for direct heals, remaining HoT ticks and absorb shields, self-correcting from the combat log
- HealComm sync with Puppeteer, pfUI, Luna and others — without any Ace libraries
- English / German localization, switchable in game
---
Heal Box Vanilla v1.4 · original by Dourd — UI Overhauled · ported to Vanilla and extended 09/2026 by Mquadrat
GERMAN
Heal Box Vanilla
ADDON-DOKUMENTATION · VERSION 1.4 · CLIENT 1.12 / 1.21.1
Party- und Selbst-Heilanzeige mit Schnellzugriff-Buttons für Heiler. Für jeden Gruppenplatz eine Namensplakette mit Lebensbalken, daneben bis zu zehn frei belegbare Zauber-Buttons. Dazu eine vollständige Heilvorhersage — Direktheilung, HoT-Restticks und Absorb-Schilde — die sich über den Combatlog selbst korrigiert und ihre Werte im HealComm-Format mit anderen Heilern teilt. Die Oberfläche gibt es auf Deutsch und Englisch, umschaltbar im Optionsfenster.
Kurzfassung für Ungeduldige: Minimap-Button anklicken → Optionsfenster → für jeden Button einen Zauber wählen → fertig. Alles Weitere passiert von allein. /fbp zeigt jederzeit, was die Vorhersage gerade denkt.
---
Installation
Der Ordner unter Interface\\AddOns heißt FBHealBox und enthält drei Dateien:
| Datei | Inhalt |
|---|---|
FBHealBox.toc |
Metadaten, Ladereihenfolge, SavedVariables |
FBHealBox.lua |
Der komplette Addon-Code |
FBHealBox.xml |
Nur der Event-Frame, der FBHealBox\_OnLoad und FBHealBox\_OnEvent aufruft |
Der Ordnername muss zum Dateinamen der .toc passen — sonst startet das Addon nicht. Willst du den Ordner umbenennen, ändere in FBHealBox.lua zusätzlich die Konstante FBADDON\_FOLDER am Dateianfang, denn daran hängt der ADDON\_LOADED-Abgleich. Der Anzeigename steht getrennt davon in FBADDON\_NAME und darf frei geändert werden.
Optional: SuperWoW. Wird es erkannt, meldet das Addon beim Login \[SuperWoW erkannt] und castet direkt auf das Gruppenmitglied, ohne dein aktuelles Ziel anzufassen. Ohne SuperWoW wechselt das Addon für den Cast kurz das Ziel und stellt das alte danach wieder her.
Keine Bibliotheken nötig. Kein Ace, kein HealComm, kein RosterLib. Das Addon spricht das HealComm-Protokoll direkt, siehe HealComm-Sync.
---
Die Anzeige
Fünf Namensplaketten: FBHealBox1 ist immer der Spieler selbst, FBHealBox2 bis FBHealBox5 sind party1 bis party4. Jede zeigt Name, Lebensprozent und einen mehrschichtigen Balken. Verschieben: die eigene Plakette mit der linken Maustaste ziehen — die anderen hängen daran und folgen.
Balkenaufbau
Drei Statusbalken liegen deckungsgleich übereinander, geregelt über feste Ebenen (FBHealBox\_SetBarStrata). Der Lebensbalken liegt oben und deckend, darunter der Schild, ganz unten die Heilvorhersage:
| Schicht | Farbe | Bedeutung |
|---|---|---|
| Leben | grün / gelb / rot, deckend | Aktuelle HP. Grün über 60 %, gelb 30–60 %, rot darunter |
| Schild | hellblau, 50 % | Verbleibender Absorb, direkt hinter den aktuellen HP |
| Vorhersage | hellgrün, 50 % | Eingehende Heilung, hinter dem Schild-Anteil |
Alles wird am Balkenende abgeschnitten: Ein Schild über der Maximal-HP bleibt unsichtbar, die Skala bleibt maßstabsgetreu.
Dispel-Färbung
Hat jemand einen Debuff, den deine Klasse entfernen kann, färbt sich sein Lebensbalken in der Debuff-Farbe statt nach HP-Stand:
| Klasse | Erkannte Typen |
|---|---|
| Priester | Magie (blau), Krankheit (braun) |
| Paladin | Magie, Gift (grün), Krankheit |
| Schamane | Gift, Krankheit |
| Druide | Fluch (violett), Gift |
Die Schwellwerte für die HP-Farben stehen als LowHP (0.6) und VeryLowHP (0.3) am Dateianfang.
---
Die Zauber-Buttons
Rechts neben jeder Plakette liegen bis zu zehn Buttons, jeder mit dem Icon seines Zaubers. Ein Linksklick wirkt den Zauber auf genau dieses Gruppenmitglied — unabhängig davon, wen du gerade im Ziel hast.
Der Icon-Rand färbt sich mit:
| Icon | Zustand |
|---|---|
| Normal | Zauber wirkbar |
| Bläulich | Nicht genug Mana |
| Dunkelgrau | Nicht wirkbar (Cooldown, Voraussetzung fehlt) |
| Rötlich | Ziel außer Reichweite |
Beim Überfahren erscheint der komplette Zaubertooltip plus die Zeile Heal Box Vanilla Ziel: <Name>, damit klar ist, wen dieser Button bedient.
---
Optionsfenster
Zu öffnen über den Minimap-Button:
| Bedienung | Wirkung |
|---|---|
| Linksklick | Optionsfenster auf/zu |
| Shift + Linksklick | Gesamte Anzeige ein-/ausblenden |
| Rechts halten und ziehen | Minimap-Button verschieben |
Im Fenster selbst:
Button 1 bis 10 — je ein Feld mit Icon und Zaubername. Klick öffnet das Zauber-Menü (siehe unten). Die Belegung wird pro Charakter gespeichert.
Show N Buttons — wie viele der zehn Buttons tatsächlich erscheinen (0–10). Belegte, aber ausgeblendete Buttons behalten ihre Zuordnung.
HealBox Scale — Skalierung der Plaketten von 0.6 bis 1.5. Wirkt nicht im Party-Frame-Modus.
Default Party Frames — statt eigener Plaketten hängen die Buttons an Blizzards Standard-Gruppenfenstern. Die eigenen Namensplaketten und Balken werden dabei ausgeblendet; die Heilvorhersage arbeitet unsichtbar weiter.
HealComm-Sync — Austausch der Heilinformationen mit der Gruppe, siehe HealComm-Sync. Standardmäßig an.
Sprache / Language — schaltet zwischen Deutsch und Englisch um. Der Knopf öffnet dasselbe Kaskadenmenü wie die Zauberwahl. Die Umstellung wirkt sofort: FBHealBox\_ApplyLocale() beschriftet die bereits gebaute Oberfläche neu, ein /reload ist nicht nötig. Beim ersten Start entscheidet GetLocale() — deutsche Clients starten auf Deutsch, alle anderen auf Englisch. Die Wahl wird pro Charakter gespeichert.
Fenster verschieben: am Rahmen ziehen. Schließen über das X oben rechts.
Das Zauber-Menü
Ein eigenes Kaskadenmenü, kein UIDropDownMenu — dessen 1.12er Implementierung schließt Untermenüs, sobald die Maus einen Nachbareintrag streift, und erzwingt Haken und Klickgeräusch.
- Ebene 1 listet alle gelernten Zauber deiner Klasse aus der Zauberliste, jeweils mit Icon.
- Pfeil rechts = mehrere Ränge vorhanden. Das Untermenü öffnet beim Überfahren, überlappt die Elternliste um zwei Pixel und hat ringsum eine Toleranzzone von 14 Pixeln, damit die Maus auf dem Weg nichts verliert.
- Offen bleibt offen: Nur die Auswahl eines Rangs, das Aufklappen eines anderen Untermenüs oder ein Klick daneben schließt es. Nach drei Sekunden ohne Maus in der Nähe greift eine Notbremse (
FBMENU\_GRACE\_TIME, auf 999 setzen deaktiviert sie). - Kein Zauber ganz oben leert den Button wieder.
Ausgewählt wird als Cast-String Zauber(Rank N) — genau die Form, die CastSpellByName erwartet, und die Basis dafür, dass die Vorhersage den exakten Rang kennt.
---
Heilvorhersage
Der Kern des Addons. Drei unabhängige Quellen speisen die Balken.
Direktheilung
SPELLCAST\_START liefert Zaubernamen und Castdauer in Millisekunden — unabhängig davon, ob der Cast vom HealBox-Button, der Aktionsleiste oder aus einem Makro kommt. Es braucht dafür keinen Hook auf CastSpellByName. Die Vorschau verschwindet bei SPELLCAST\_STOP, \_FAILED und \_INTERRUPTED, Pushback (SPELLCAST\_DELAYED) verlängert sie.
Instants bekommen bewusst keine Vorhersage: Die Heilung ist da, bevor ein Balken sie zeigen könnte.
Heilung über Zeit
UnitBuff() liefert für fremde Einheiten keine Restlaufzeit — das Addon führt deshalb selbst Buch:
- Der Button meldet den Cast samt Ziel und Rang vor.
UNIT\_AURAbestätigt die Anwendung über den Buff-Textur-Vergleich mit dem Zauberbuch-Icon (locale-unabhängig, kein Tooltip-Scan pro Event).- Angezeigt wird
Restticks × Heilung pro Tick, wobei die Restticks aus(Ablauf − GetTime()) / Intervallfallen. Der Balken zählt damit Tick für Tick herunter. - Fällt der Buff vorzeitig weg — Dispel, Tod, Überschrieben — ist die Anzeige sofort weg.
HoTs von der Aktionsleiste werden ebenfalls erkannt, dann mit dem höchsten bekannten Rang; der erste Combatlog-Tick zieht den Wert gerade.
Das Tickintervall ist in Vanilla nicht aus dem Tooltip lesbar und steht deshalb in FBPredictTickInterval (Standard 3 Sekunden, Lifebloom 1).
Absorb-Schilde
Maximaler Absorb aus dem Zauberbuch-Tooltip, Verbrauch aus dem Combatlog ((123 absorbed)). Bei \*\_VS\_SELF\_\*-Events ist das Opfer der Spieler, sonst wird unter den aktuell beschildeten Namen gesucht.
Absorbierst du mehr, als der Tooltip hergibt — Heal-Gear —, wird das Maximum nach oben korrigiert und gemerkt. Diese Korrektur ist einseitig und damit sicher: Mehr als möglich kann nicht absorbiert worden sein.
Vollständig absorbierte Treffer melden in Vanilla keine Zahl. Der Restwert bleibt dann stehen, bis der Buff fällt und die Anzeige gelöscht wird. Ebenso zählen Absorbs an Gruppenmitgliedern nur, soweit der Combatlog sie überhaupt zeigt — der Aura-Abgleich fängt die Abweichung am Ende wieder ein.
Selbstkorrektur und Lernspeicher
Tooltips liefern in 1.12 nur Basiswerte ohne +Heilung, und eine API für Zaubermacht gibt es nicht. Der Combatlog liefert dagegen die Wahrheit:
| Beobachtung | Wirkung |
|---|---|
… gains 194 health from your Renew. |
Setzt die echte Heilung pro Tick für alle Restticks |
Your Flash Heal heals Bob for 1240. |
Pendelt die Schätzung ein (50/50-Mittelung) |
(342 absorbed) über dem Maximum |
Hebt den angenommenen Schildwert an |
Alles davon landet pro Zauber und Rang in HealBox.PredictMemory und übersteht den Logout.
Zwei Schutzregeln halten den Speicher sauber. Crits werden nicht gelernt — die Crit-Formulierung lässt den Zaubernamen als „Flash Heal critically" durchs Muster fallen, und der steht in keiner Watchlist. Und gelernt wird nur bei gesichertem Rang, also bei Casts über die HealBox-Buttons; sonst würde ein Rang-3-Cast von der Aktionsleiste dem Maximalrang zugeschrieben und die Vorhersage nach unten ziehen. Die laufende Anzeige korrigiert sich trotzdem immer, geschützt ist nur der dauerhafte Speicher.
Welcher Zauber was kann, entscheidet der Tooltip selbst — ein Zauber darf mehreres sein. Regrowth etwa liefert Sofortheilung und HoT und wird auch so behandelt.
---
HealComm-Sync
HealComm-1.0 funkt reinen Klartext über SendAddonMessage mit dem Prefix HealComm. Heal Box Vanilla spricht dieses Protokoll direkt — ohne die Bibliothek einzubinden. Damit sehen Puppeteer, pfUI, Luna Unit Frames, CT_RaidAssist und alles andere HealComm-fähige deine angekündigten Heilungen, und du siehst umgekehrt ihre.
| Nachricht | Bedeutung |
|---|---|
Heal/<Ziel>/<Betrag>/<Castzeit ms>/ |
Direktheilung startet |
Healstop |
Cast abgebrochen |
Healdelay/<ms>/ |
Pushback |
GrpHeal/<Betrag>/<ms>/<Z1>/<Z2>/… |
Gruppenheilung (Prayer of Healing) |
GrpHealstop · GrpHealdelay/<ms>/ |
dito für Gruppenheilung |
Renew · Reju · Regr /<Ziel>/<Dauer>/ |
HoT angewendet |
Gesendet wird ins Raid, sonst in die Gruppe, sonst gar nicht. Die Beträge sind die selbstkorrigierten Combatlog-Werte, also eher genauer als das, was ein echtes HealComm mit ItemBonusLib schätzt.
Ein paar Feinheiten: Bei erfolgreichem Castende geht kein Healstop raus — HealComm-Empfänger lassen den Eintrag selbst zur Castzeit auslaufen. Prayer of Healing geht korrekt als GrpHeal mit allen Zielen in Reichweite raus. Und ein HoT von der Aktionsleiste wird beim ersten eigenen Combatlog-Tick nachgemeldet, mit der dann noch verbleibenden Laufzeit — denn erst „… from your Renew" beweist, dass er von dir stammt.
Beim Empfang werden eigene Nachrichten über den Absendernamen gefiltert, und da HealComm eingehende Heilungen pro Caster ablegt, kann sich nichts doppeln — selbst wenn parallel noch ein echtes HealComm mitfunkt. HoT-Nachrichten tragen nur Laufzeiten und keine Beträge; HealComm zählt sie im eigenen getHeal nicht mit, hier passiert dasselbe.
Absorb-Schilde kennt das Protokoll nicht — die bleiben lokal.
---
Slash-Befehle
| Befehl | Wirkung |
|---|---|
/fbp |
Statusbericht: alle ausgelesenen Tooltip-Werte je Zauber (Direkt-, HoT- und Schildanteil, gelernte Werte in Klammern), alle gerade laufenden Vorhersagen, der Zustand des HealComm-Sync und die empfangenen Fremdheilungen |
/fbp debug |
Live-Ausgabe an/aus. Meldet jeden erkannten Cast, jede Korrektur, jeden Absorb und jede gefunkte Nachricht (\[FBP>]) |
/fbp reset |
Verwirft alle gelernten Werte und liest die Tooltips neu ein |
/fbp ist die erste Anlaufstelle, wenn etwas nicht angezeigt wird: Steht ein Zauber dort nicht drin, hat der Tooltip-Parser ihn nicht erkannt — und nicht die Anzeige versagt.
---
Gespeicherte Einstellungen
Alles liegt in der Tabelle HealBox, gespeichert pro Charakter:
| Schlüssel | Inhalt |
|---|---|
SpellChoice\[1..10] |
Cast-String je Button, z. B. Renew(Rank 10) |
MaxButtons |
Wie viele Buttons angezeigt werden |
Scale |
Skalierung der Plaketten |
AttachMode |
0 = eigene Plaketten, 1 = Standard-Gruppenfenster |
Active |
Anzeige ein/aus (Shift + Linksklick auf die Minimap) |
HealComm |
1 = Sync an, 0 = aus |
Locale |
deDE oder enUS |
PredictMemory |
Gelernte Heilwerte je Zauber und Rang |
Konfiguration im Code
Alle Stellschrauben stehen als Globals oben in ihrem jeweiligen Abschnitt und lassen sich ohne Eingriff in die Logik ändern.
| Konstante | Standard | Wirkung |
|---|---|---|
LowHP · VeryLowHP |
0.6 · 0.3 | Schwellen für gelb und rot |
NamePlateWidth · NamePlateHeight |
120 · 28 | Größe einer Plakette |
xSpacing |
2 | Abstand zwischen den Buttons |
MaxButtonCount |
10 | Maximale Buttonzahl |
FBMENU\_BTN\_HEIGHT · FBMENU\_ICON\_SIZE |
17 · 16 | Zeilenhöhe und Icon-Größe im Menü |
FBMENU\_MOUSE\_PAD |
14 | Toleranzzone um die Menüs |
FBMENU\_GRACE\_TIME |
3.0 | Auto-Close des Menüs (999 = aus) |
FBPREDICT\_TICK\_DEFAULT |
3 | Standard-Tickintervall für HoTs |
FBPREDICT\_THROTTLE |
0.2 | Update-Rate der Vorhersage |
FBPREDICT\_CONFIRM\_TIME |
3.0 | Wartezeit auf die Aura-Bestätigung |
FBPREDICT\_TARGET\_TIME |
2.0 | Gültigkeit des gemerkten Cast-Ziels |
FBPredictTickInterval |
{Lifebloom = 1} |
Abweichende Tickintervalle |
FBCommGroupHeal |
{Prayer of Healing} |
Was als GrpHeal gefunkt wird |
---
Funktionsreferenz
Anzeige und Rahmen
| Funktion | Zweck |
|---|---|
FBHealBox\_OnLoad() |
Event-Registrierung, Startmeldung |
FBHealBox\_OnEvent(event, arg1) |
Zentrale Ereignisverteilung |
FBHealBoxSetup() |
Legt die fünf Plaketten an |
FBHealBoxCreateFrame(…) |
Baut eine Plakette samt der drei Balken |
FBHealBox\_SetBarStrata(f, strata) |
Stapelt Leben / Schild / Vorhersage |
FBHealBox\_UpdateUnit(unit, frame) |
Schreibt HP, Schild, Vorhersage und Dispel-Farbe in eine Plakette |
FBHealBox\_RefreshAllBars() |
Aktualisiert alle fünf |
FBUpdateNames() |
Namen und Sichtbarkeit nach Gruppenwechsel |
HealBoxAttachMode(mode) |
Umschaltung eigene Plaketten ↔ Standard-Gruppenfenster |
HealBoxScale(this, scale) |
Skalierung |
Buttons und Zauberdaten
| Funktion | Zweck |
|---|---|
FBHealBoxCreateButton(…) |
Ein Zauber-Button samt Cast-Logik und Tooltip |
FBHealBoxButtons() |
Baut alle Buttons neu auf |
FBHealBoxButtonsChanged() |
Aktualisiert Icons und Zuordnung ohne Neubau |
FBLoadSpellData() |
Scannt das Zauberbuch, sammelt alle Ränge |
FBApplySpellChoice(i, castString) |
Weist einem Button einen Zauber zu |
HealBoxButton\_OnEvent(…) |
Färbt das Icon nach Mana, Cooldown und Reichweite |
Zauber-Menü
| Funktion | Zweck |
|---|---|
FBMenu\_OpenSpellMenu(btnIndex, anchor) |
Öffnet das Menü für einen Options-Button |
FBMenu\_ShowLevel(level, entries, anchor) |
Baut und positioniert eine Menü-Ebene |
FBMenu\_BuildSpellEntries() |
Ebene 1: alle gelernten Zauber |
FBMenu\_BuildRankEntries(spellName) |
Ebene 2: alle Ränge eines Zaubers |
FBMenu\_SelectSpell(entry) · FBMenu\_ClearSpell() |
Auswahl übernehmen bzw. Button leeren |
FBMenu\_CloseAll() · FBMenu\_IsOpen() |
Menü schließen, Zustand abfragen |
Vorhersage — Abfrage
Die vier Funktionen, die die Balken speisen. Alle erwarten einen Spielernamen, keine Unit-ID:
| Funktion | Liefert |
|---|---|
FBGetDirectHeal(name) |
Betrag des laufenden eigenen Direktcasts |
FBGetHoTHeal(name) |
Summe aller noch ausstehenden eigenen HoT-Ticks |
FBGetShield(name) |
Verbleibender Absorb |
FBGetCommHeal(name) |
Angekündigte Heilung anderer Heiler |
Vorhersage — Innenleben
| Funktion | Zweck |
|---|---|
FBPredict\_GetSpellInfo(bookID, name) |
Wertet den Zauberbuch-Tooltip aus (Direkt / HoT / Schild) |
FBPredict\_BuildWatch() |
Baut die Watchlist nach jedem Zauberbuch-Scan |
FBPredict\_NoteCast(castString, target) |
Merkt Ziel und Rang vor dem Cast vor |
FBPredict\_CastStart(spell, castMs) · FBPredict\_CastEnd() |
Direktheilung starten und beenden |
FBPredict\_ScanUnit(unit) |
Aura-Abgleich: Anwendung bestätigen, Wegfall erkennen |
FBPredict\_StartHoT(…) · FBPredict\_StartShield(…) |
Tracking scharfschalten |
FBPredict\_ParseCombat(event, msg) |
Combatlog-Auswertung |
FBPredict\_OnTick(…) · FBPredict\_OnDirectHeal(…) · FBPredict\_OnAbsorb(…) |
Die drei Korrekturpfade |
FBPredict\_Remember(…) · FBPredict\_Remembered(…) |
Lernspeicher schreiben und lesen |
FBPredict\_TicksLeft(e, now) |
Restticks eines HoT |
HealComm
| Funktion | Zweck |
|---|---|
FBComm\_Enabled() |
Ist der Sync eingeschaltet? |
FBComm\_Send(msg) |
Rohversand ins Raid bzw. in die Gruppe |
FBComm\_SendHealStart(…) |
Heal bzw. GrpHeal |
FBComm\_SendHealStop() · FBComm\_SendHealDelay(ms) |
Abbruch und Pushback |
FBComm\_SendHoT(spell, target, dur) |
Renew / Reju / Regr |
FBComm\_OnMessage(prefix, msg, channel, sender) |
Empfang und Auswertung |
---
Fehlersuche
Ein Zauber taucht im Menü nicht auf. Er steht nicht in der Zauberliste deiner Klasse (Spell.Name am Dateianfang) oder ist noch nicht gelernt. Die Liste lässt sich frei erweitern.
Keine Vorhersage für einen bestimmten Zauber. /fbp aufrufen: Steht der Zauber nicht in der Liste der ausgelesenen Zauber, hat der Tooltip-Parser ihn nicht erkannt. Auf abweichenden Servern können die Formulierungen abweichen — die Muster sitzen gebündelt in FBPredict\_GetSpellInfo.
Combatlog-Korrekturen greifen nicht. Die Muster werden aus den GlobalStrings des Clients gebaut (PERIODICAURAHEALOTHERSELF, HEALEDSELFOTHER, ABSORB\_TRAILER) und fallen sonst auf englische Vorgaben zurück. /fbp debug zeigt, ob Korrekturen ankommen.
Werte sind zu niedrig. Vor der ersten beobachteten Heilung steht nur der Tooltip-Basiswert ohne +Heilung zur Verfügung. Ein einziger Cast über die Buttons genügt zum Einpendeln.
Der HealComm-Sync scheint tot. Er sendet nur in Gruppe oder Raid — allein passiert nichts. /fbp zeigt den Schaltzustand, /fbp debug jede ausgehende Nachricht.
Nach einem Gear-Wechsel stimmen die Zahlen nicht. Sie korrigieren sich beim nächsten Cast von selbst; /fbp reset erzwingt den Neustart.
---
Klassenzauber
Die vorbelegten Listen — frei erweiterbar in Spell.Name:
| Klasse | Zauber |
|---|---|
| Priester | Renew · Flash Heal · Lesser Heal · Heal · Greater Heal · Binding Heal · Prayer of Healing · Prayer of Mending · Circle of Healing · Power Word: Shield · Abolish Disease · Cure Disease · Dispel Magic |
| Druide | Rejuvenation · Regrowth · Lifebloom · Healing Touch · Swiftmend · Remove Curse · Abolish Poison |
| Schamane | Lesser Healing Wave · Healing Wave · Chain Heal · Earth Shield · Cure Poison · Cure Disease |
| Paladin | Flash of Light · Holy Light · Holy Shock · Lay on Hands · Purify · Cleanse · Blessing of Protection |
Nicht vorhandene Einträge stören nicht: Findet der Zauberbuch-Scan sie nicht, werden sie stillschweigend übergangen.
---
Credits
Original: Heal Box von Dourd (Argent Dawn EU), UI Overhauled. Von ihm stammen die Grundidee, der Aufbau mit Namensplaketten und Schnellzugriff-Buttons und das ursprüngliche Optionsfenster. Ohne diese Vorlage gäbe es dieses Addon nicht. Ehre wem Ehre gebührt.
Vanilla-Portierung und Funktionserweiterung 09/2026: Mquadrat. Portiert auf Client 1.12 / 1.21.1 mit optionaler SuperWoW-Unterstützung, dazu:
- eigenes Kaskadenmenü für Zauber- und Rangwahl, weil
UIDropDownMenuin 1.12 keine brauchbaren Untermenüs liefert - Heilvorhersage für Direktheilung, HoT-Restticks und Absorb-Schilde, selbstkorrigierend über den Combatlog
- HealComm-Sync mit Puppeteer, pfUI, Luna und Co. — ohne Ace-Bibliotheken
- Lokalisierung Deutsch / Englisch, im laufenden Spiel umschaltbar
---
Heal Box Vanilla v1.4 · Original von Dourd — UI Overhauled · Vanilla-Portierung und Erweiterung 09/2026 von Mquadrat