ShempError
ad50ebe636
A TurtleWoW 1.12.1 addon that shows the healing returned by the Vampirism item stat. The game emits no event for that healing, so the addon computes it from the player's own outgoing damage using a formula measured in-game, and shows it live on a movable bar with a per-ability breakdown, an overheal split, automatic source detection from equipped gear, and optional scrolling combat text.
6.5 KiB
Vampify
A TurtleWoW 1.12.1 addon that shows the healing you get back from the Vampirism item stat.
The game emits no event for that healing — it happens silently, folded into your health bar. Vampify computes it from your own outgoing damage using a formula measured in-game, and shows it live on a small movable bar, optionally as scrolling combat text.
Hover the bar for the per-ability breakdown; hover a row for that ability's own detail — hit count, average damage per hit, the return rate it actually achieved against the rate your gear promises, and whether the per-hit floor is what is carrying it.
Screenshots
 In a fight — each return scrolls past as it lands, with the bar keeping the running totals |
 Breakdown — every ability that returned health, for the session, the character's lifetime or the last fight |
 The bar — this fight's returned health, the single-target/AoE split, HPS, gear total |
 Options — every setting, plus a panel stating what the addon can and cannot see |
What it does
- Live total of Vampirism healing for the current session and for the character's lifetime.
- Per-ability breakdown on mouseover: which spells and attacks actually returned health.
- Overheal split — how much of the returned healing was wasted at full health.
- Automatic source detection: reads your equipped items and enchants and sums their Vampirism percentages. Sources it cannot read from a tooltip can be added by hand.
- AoE handling: a multi-target hit returns less per point of damage, and Vampify accounts for it rather than reporting a confident wrong number.
- Scrolling combat text, either through Blizzard's own engine or Vampify's, with its own colour, font size and anchor.
- It tells you when it cannot see — if no damage events arrive while you are visibly fighting, it says so instead of displaying a reassuring zero.
The formula
heal(D) = 0 if D <= 1
= max(nSources, D * P * a) otherwise
P is the summed percentage of your equipped Vampirism sources, a is 0.7 on AoE hits, and the
per-hit floor equals the number of equipped sources. Healing accumulates as a float; every integer
you see is a crossing of that accumulator rather than a per-hit rounding. That is what reproduces
the measured behaviour where two identical 251-damage hits healed 18 and then 17.
The constants are pinned in core/const.lua, each with the observation it came from.
Install
- Close the game.
- Copy the
Vampifyfolder into<WoW>\Interface\AddOns\so thatVampify.tocsits at<WoW>\Interface\AddOns\Vampify\Vampify.toc. - Start the game and enable Vampify in the character-select AddOns list.
Requirements
- WoW 1.12.1 client (TurtleWoW).
- nampower — required. Vampify reads your outgoing damage from the packet-derived events
nampower provides (
SPELL_DAMAGE_EVENT_SELF,AUTO_ATTACK_SELF,SPELL_GO_SELF). Without it the addon has no damage to work from and will say so rather than show zeros. Developed against nampower v4.6.2. - SuperWoW — optional. Used to resolve spell names for the breakdown and to write the debug export. Everything else works without it.
Usage
/vampify or /vf:
| Command | What it does |
|---|---|
/vf status |
equipped sources and current totals |
/vf options |
open the options window |
/vf reset [session|lifetime|both] |
reset totals (default: session) |
/vf pos |
move the display back to its default position |
/vf lock |
toggle dragging of the display |
/vf fct / /vf sct |
toggle scrolling combat text (either engine) |
/vf sctmove |
reposition Vampify's own SCT anchor |
/vf source add <pct> |
add a source by hand, if tooltip detection missed it |
/vf source clear |
drop all manually added sources |
/vf exclude add <spellId> |
stop a spell from counting as a Vampirism trigger |
/vf exclude remove <spellId> |
undo a runtime exclusion |
/vf exclude list |
show excluded spells |
/vf perhit on|off|status |
per-hit debug export |
There is also a minimap button: left-click toggles the display, right-click opens the options.
Options
The options window (/vf options, the minimap button's right-click, or the button on the bar)
covers every setting: show and lock the display, minimap button, overheal reporting, the gear
percentage on the bar, scrolling combat text and which of the three engines draws it, one number
per cast instead of per hit, SCT colour, anchor, font size, rise height and outline, the heights of
the bar and of the breakdown panel's rows, the per-hit debug export, and buttons to reset the
totals or bring the bar home.
Below the controls sits a panel that states what the addon currently sees: every Vampirism source it read off your gear and enchants, the summed total, the per-hit floor, how much of your healing came from that floor rather than from the percentage, what one more percent would be worth on your present numbers — and, in plain words, the two things it cannot measure.
For developers
Everything under core/ is pure Lua with no WoW API calls, and every WoW-facing file keeps its
wiring behind a single if CreateFrame then guard. That split exists so the logic can be run and
tested outside the game, against a real Lua 5.0.3 interpreter — the same language version the 1.12
client runs, which catches the classic traps (#table, string-method call syntax, string.match)
that a newer interpreter would silently accept and the client would then throw on.
The test suite itself is developed alongside the addon but is not part of this distribution.
License
MIT — see LICENSE.