# Add Ability

Grammar — Add inBehavior to inUnit
Flags — Native | Action

Added ability may not be able to be cast without command buttons. You can set a ability to automaticly create command button, by go to the ability’s Command+ field, and assigne default button for them. “Use Default Button” and “Create Default Button” flags needs to be check to allow the button to be auto created. The position of the auto-created button can be set in the Button data.

# Arguments

• unit — Unit
• string<gamelink::Abil> — Ability

Returns — void

native void UnitAbilityAdd(unit inUnit, string inBehavior);

# Related

Category: Ability / Basic

• Remove Ability — void — UnitAbilityRemove
• Add Ability — void — UnitAbilityAdd
• Unit Uses Ability — void — TriggerAddEventUnitAbility
• Unit Changes Ability Auto Cast State — void — TriggerAddEventUnitAbilityAutoCastChange
• Triggering Ability — abilcmd — EventUnitAbility
• Triggering Ability Stage — int<preset::AbilityStage> — EventUnitAbilityStage
• Triggering Ability Target Point — point — EventUnitTargetPoint
• Triggering Ability Target Unit — unit — EventUnitTargetUnit
• Triggering Ability Other Unit — unit — EventUnitAbilityOtherUnit
• Ability From Item or Trigger — abilcmd — libNtve_gf_EventItemAbilityOrUnitAbility
• Unit Is Created — void — TriggerAddEventUnitCreated
• Created Unit — unit — EventUnitCreatedUnit
• Behavior That Created Unit — string<gamelink::Behavior> — EventUnitCreatedBehavior
• Ability That Created Unit — string<gamelink::Abil> — EventUnitCreatedAbil
• Show/Hide Ability For Unit — void — UnitAbilityShow
• Ability Enabled For Unit — bool — UnitAbilityCheck
• Number Of Abilities On Unit — int — UnitAbilityCount
• Unit Ability — string<gamelink::Abil> — UnitAbilityGet
• Unit Ability By Class — string<gamelink::Abil> — libNtve_gf_UnitAbilityGetByType
• Unit Ability Command State — bool — UnitCheckAbilCmdState
• Unit Ability Order State (Flags) — int — UnitAbilOrderStateFlags
• Unit Has Ability — bool — UnitAbilityExists
• Enable/Disable Ability For Unit — void — UnitAbilityEnable
• Add Level To Unit Ability — void — UnitAbilityChangeLevel
• Replace Unit Ability — void — UnitAbilityChangeLink
• Set Ability Default Submenu — void — UnitAbilityChangeCardId
• Current Level For Unit Ability — int — UnitAbilityGetLevel
• Maximum Level For Unit Ability — int — UnitAbilityMaxLevel
• Ability Matches Filters — bool — libNtve_gf_AbilityMatchesFilters
• Unit Ability By Filters — string<gamelink::Abil> — libNtve_gf_UnitAbilityByFilters
• Unit Ability Default Submenu — string — UnitAbilityGetCardId

# Examples

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicSystem.galaxy:288

        autoA87D0C6F_val = lv_race;
        if (autoA87D0C6F_val == "Human") {
            UnitAbilityAdd(lv_townHall, "Amic");
        }
        else if (autoA87D0C6F_val == "NightElf") {