UnitRemoveAbility

Parameters

whichUnit	unit	Target unit.
abilityId	integer	Abilities' raw code identifier.

comment

Removes the ability from target unit.

Returns:

• true if the removal was successful (hero did have this ability before)
• false otherwise (hero does not have this ability)

bug

Removing non-interrupt abilities like divine shield while they're being cast (at the EVENT_PLAYER_UNIT_SPELL_EFFECT point), and while the caster is moving, will cause the caster to become unresponsive to new commands until they reach their ordered move point.

note

See UnitModifySkillPoints/ModifyHeroSkillPoints to grant a hero skill points.

note

All different building ability codes like 'AHbu', 'ANbu' are considered equivalent. For example, removing 'AHbu' on a unit with only 'ANbu' would remove 'ANbu' instead. See GetUnitAbilityLevel.

patch

1.00

Source

common.j (raise an issue to discuss on Github or submit a PR)

return type

boolean

Source code

native UnitRemoveAbility            takes unit whichUnit, integer abilityId returns boolean