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
return type
nothing
Source code
native UnitApplyTimedLife           takes unit whichUnit, integer buffId, real duration returns nothing