About

Library for instant health updates via combat log. Only group members; other units do not receive instant updates.

Because of technical limitations melee auto attack damage is not instant.

Usage

local InstantHealth = LibStub("LibInstantHealth-1.0")

Use InstantHealth.UnitHealth(unit) where you would use UnitHealth(unit), InstantHealth.UnitHealthMax(unit) where you would use UnitHealthMax(unit), and instead of

frame:SetScript("OnEvent", onEvent)

frame:RegisterEvent(event)

frame:RegisterUnitEvent(event, unit1, unit2)

frame:UnregisterEvent(event)

InstantHealth.RegisterCallback(frame, event, onEvent, frame)

InstantHealth.RegisterCallback(frame, event, function (self, event, unit) if unit == unit1 or unit == unit2 then onEvent(self, event, unit) end end, frame)

InstantHealth.UnregisterCallback(frame, event)

where event is "UNIT_HEALTH", "UNIT_MAXHEALTH", or "UNIT_HEALTH_FREQUENT".

UNIT_HEALTH, UNIT_MAXHEALTH and UNIT_HEALTH_FREQUENT events fire when they normally would; additionally, UNIT_HEALTH_FREQUENT is fired when the health is updated via combat log events.

Because of the potentially large number of UNIT_HEALTH_FREQUENT events, it is recommended to update health bars etc. in OnUpdate if necessary, and not on each UNIT_HEALTH_FREQUENT event.

It is not recommended to use InstantHealth.UnitHealth(unit) and InstantHealth.UnitHealthMax(unit) within event handlers of Blizzard's UNIT_HEALTH, UNIT_MAXHEALTH, UNIT_HEALTH_FREQUENT, and COMBAT_LOG_EVENT/COMBAT_LOG_EVENT_UNFILTERED.