UnitApplyTimedLife

Parameters

whichUnit	unit	Target unit.
buffId	integer	id of the buff to use. The only allowed values are: BUan (Animate Dead), Bapl (Plague Ward), BEfn (Force of Nature), BTLF (Generic), Bhwd (Healing Ward), Brai (Raise Dead) and BHwe (Water Elemental).
duration	real	game time from now until the unit is killed.

comment

Adds a specific timed-life buff to a unit and kills the unit after a time. The unit will show a decreasing progress bar in its UI indicating the remaining time and what buff was used.

note

When another buff id than the allowed ones is given, it will fall back to use BTLF (Generic), even if the buff is derived from one of the allowed ones.

note

The text that appears on the progress bar is the tooltip (Bufftip/ftip) of the buff.

note

The buff won't show up in the unit's status UI.

note

The buff can be queried with BlzGetUnitAbilityByIndex.

note

Timed life can be stacked (even the same buff id), the timers will be running down in parallel, so the first expired timer will kill the unit but only the timed life applied first will show up in the unit's UI. Timed life can also stem from summoning abilities as the allowed buff id values suggest.

note

Removing any timed-life buff from the unit will kill the unit.

patch

1.00

Source

common.j (suggest an edit or discuss on Github)

return type

nothing

Source code

native UnitApplyTimedLife           takes unit whichUnit, integer buffId, real duration returns nothing