BlzUnitDisableAbility

Parameters

whichUnit	unit	Unit to apply this to.
abilId	integer	Rawcode of ability.
flag	boolean	isDisabled: true to disable (cannot click), false to enable ability.
hideUI	boolean	isHidden: true to completely hide the icon, false to show icon. Icons are different for disabled/enabled abilities.

comment

Enables/disables and hides/unhides an ability for a unit. A visible disabled ability is shown as deactivated, an invisible ability disappears from the grid.

Example (Lua):

-- assume u is Human Peasant, AHbu is ability for Human building.
-- keep enabled, but hide icon
BlzUnitDisableAbility(u, FourCC"AHbu", false, true)

bug

(1.32.10 confirmed) The game counts isDisabled and hideUI internally as integers(?) If you called 5 times "hideUI = true" to hide an icon then you'll need to multiple times "hideUI = false" to show it again. I do not exactly understand how it's counted. https://www.hiveworkshop.com/threads/blzunithideability-and-blzunitdisableability-dont-work.312477/

note

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

patch

1.29.2.9231

Source

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

return type

nothing

Source code

native BlzUnitDisableAbility                       takes unit whichUnit, integer abilId, boolean flag, boolean hideUI returns nothing