# Unit Uses Ability

Grammar — unit uses ability at stage stage (includeSharedAbilities|Include/Ignore shared abilities)
Flags — Native | Event

This event fires when a unit uses an ability. Use “Triggering Ability” to get the ability that was used. Use “Triggering Ability Stage” to get the stage the ability was in when the event fired. Use “Triggering Ability Target Point” to get the target point for the ability. Use “Triggering Ability Target Unit” to get the target unit for the ability. Use “Triggering Player” to get the player that used the ability. Use “Triggering Unit” to get the unit that used the ability. If the parameter “Include Shared Abilities” is set to true, instead of matching the specific event, it will match any event that has the same ability set id (AbilSetId).

# Arguments

• unitref [ unit ] — Unit
• abilcmd — Ability
• int [ preset::AbilityStage ] — Stage
• bool [ preset::IncludeIgnoreOption ] — Include Shared Abilities

Returns — void

native void TriggerAddEventUnitAbility(
	trigger t,
	unitref u,
	abilcmd a,
	int stage,
	bool includeSharedAbils,
);

# Event parameters

• Triggering Ability — EventUnitAbility
• Triggering Ability Stage — EventUnitAbilityStage
• Triggering Ability Target Point — EventUnitTargetPoint
• Triggering Ability Target Unit — EventUnitTargetUnit
• Triggering Ability Other Unit — EventUnitAbilityOtherUnit
• Ability From Item or Trigger — libNtve_gf_EventItemAbilityOrUnitAbility
• Triggering Game User — EventGameUser
• Triggering Player — EventPlayer
• Triggering Unit — EventUnit

# Related

Category: Ability / Basic

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

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L456
TriggerAddEventUnitAbility(gt_MultikillNukedetector, null, AbilityCommand("TacNukeStrike", 0), c_abilEffectStageFinish, false)

// L1619
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5541
TriggerAddEventUnitAbility(gt_ResearchObjectiveChrysalisUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1298
TriggerAddEventUnitAbility(gt_CreatePingsWhenInfestedUnburrows, null, AbilityCommand("BurrowInfestorUp", 0), c_unitAbilStageExecute, false)

// L1340
TriggerAddEventUnitAbility(gt_RemovePingsWhenInfestorBurrows, null, AbilityCommand("BurrowInfestorDown", 0), c_unitAbilStageExecute, false)

// L1473
TriggerAddEventUnitAbility(gt_InfestorCooldown, null, AbilityCommand("InfestedTerrans", 0), c_abilEffectStageFinish, false)

// L3605
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L4293
TriggerAddEventUnitAbility(gt_TransmissionPurifierUsesVortexQ, null, AbilityCommand("VortexPurifier", 0), c_unitAbilStageComplete, false)

// L1389
TriggerAddEventUnitAbility(gt_GasPickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3267
TriggerAddEventUnitAbility(gt_ResourcePalletPickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5567
TriggerAddEventUnitAbility(gt_DefilerSkeletonFinding, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1085
TriggerAddEventUnitAbility(gt_ChangeOwnerofIntroStructures, null, AbilityCommand("FactoryLand", 0), c_unitAbilStageComplete, false)

// L1086
TriggerAddEventUnitAbility(gt_ChangeOwnerofIntroStructures, null, AbilityCommand("BarracksLand", 0), c_unitAbilStageComplete, false)

// L1087
TriggerAddEventUnitAbility(gt_ChangeOwnerofIntroStructures, null, AbilityCommand("CommandCenterLand", 0), c_unitAbilStageComplete, false)

// L1226
TriggerAddEventUnitAbility(gt_ChangeOwnerofSCVs, null, AbilityCommand("CommandCenterTransport", 1), c_unitAbilStageComplete, false)

// L1654
TriggerAddEventUnitAbility(gt_OrlanMineralCount, null, AbilityCommand("SCVHarvest", 1), c_abilHarvestStageDropOff, false)

// L2481
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3689
TriggerAddEventUnitAbility(gt_RemoveSalvagePing, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L4456
TriggerAddEventUnitAbility(gt_MineralsHarvestedBySCVs, null, AbilityCommand("SCVHarvest", 1), c_abilHarvestStageDropOff, false)

// L4980
TriggerAddEventUnitAbility(gt_ObjectiveFindContrabandUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3278
TriggerAddEventUnitAbility(gt_NukePan, UnitRefFromUnit(UnitFromId(2)), AbilityCommand("OdinNuclearStrike", 0), c_unitAbilStageAll, false)

// L3557
TriggerAddEventUnitAbility(gt_TransmissionFirstBarrageCompleteQ, UnitRefFromUnit(UnitFromId(2)), AbilityCommand("OdinBarrage", 0), c_abilEffectStageFinish, false)

// L3617
TriggerAddEventUnitAbility(gt_TransmissionBarrageQ, UnitRefFromUnit(UnitFromId(2)), AbilityCommand("OdinBarrage", 0), c_abilEffectStageApproach, false)

// L4577
TriggerAddEventUnitAbility(gt_DefeatOdinDead, null, AbilityCommand("OdinWreckage", 0), c_unitAbilStageComplete, false)

// L4982
TriggerAddEventUnitAbility(gt_ObjectiveDevourerSampleUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5038
TriggerAddEventUnitAbility(gt_RemoveDevourerTissueSample, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L2491
TriggerAddEventUnitAbility(gt_ParadePlazaReaction, null, AbilityCommand("OdinBarrage", 255), c_unitAbilStageExecute, false)

// L2626
TriggerAddEventUnitAbility(gt_OdinDiesMovetoStage2, UnitRefFromVariable("gv_odin"), AbilityCommand("OdinWreckage", 0), c_unitAbilStageComplete, false)

// L2777
TriggerAddEventUnitAbility(gt_OdinDiesQ, UnitRefFromVariable("gv_odin"), AbilityCommand("OdinWreckage", 0), c_unitAbilStageComplete, false)

// L1469
TriggerAddEventUnitAbility(gt_Grenades01, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1545
TriggerAddEventUnitAbility(gt_PlasmaGun01, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1621
TriggerAddEventUnitAbility(gt_ChronoChargePickup01, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1665
TriggerAddEventUnitAbility(gt_HealthandEnergyPickup, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3664
TriggerAddEventUnitAbility(gt_MakeAutoTurretsUnselectable, null, AbilityCommand("SentryGunBurrow", 0), c_unitAbilStageAll, false)

// L3665
TriggerAddEventUnitAbility(gt_MakeAutoTurretsUnselectable, null, AbilityCommand("SentryGunUnburrow", 0), c_unitAbilStageAll, false)

// L10911
TriggerAddEventUnitAbility(gt_ObjectiveProtossRelicsUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L11036
TriggerAddEventUnitAbility(gt_ObjectiveProtossRelicsUpdateSecondHalf, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1443
TriggerAddEventUnitAbility(gt_SupplyDepotLoweredRaised, null, AbilityCommand("SupplyDepotRaise", 0), c_unitAbilStageComplete, false)

// L1444
TriggerAddEventUnitAbility(gt_SupplyDepotLoweredRaised, null, AbilityCommand("SupplyDepotLower", 0), c_unitAbilStageComplete, false)

// L4204
TriggerAddEventUnitAbility(gt_ResourcePalletPickups, null, AbilityCommand("PickupMinerals100", 0), c_unitAbilStageExecute, false)

// L4205
TriggerAddEventUnitAbility(gt_ResourcePalletPickups, null, AbilityCommand("PickupGas100", 0), c_unitAbilStageExecute, false)

// L1425
TriggerAddEventUnitAbility(gt_SalvageBunkersDisableRetreatTransmission, null, AbilityCommand("SalvageBunkerRefund", 0), c_unitAbilStageComplete, false)

// L1767
TriggerAddEventUnitAbility(gt_RemoveBunkerTextTagSalvagedorDead, null, AbilityCommand("SalvageBunker", 0), c_unitAbilStageComplete, false)

// L2197
TriggerAddEventUnitAbility(gt_MineralPickups, null, AbilityCommand("PickupMinerals100", 0), c_unitAbilStageExecute, false)

// L1801
TriggerAddEventUnitAbility(gt_Playerstartsharvestingterrazine, null, AbilityCommand("SCVHarvest", 0), c_abilHarvestStageHarvest, false)

// L2028
TriggerAddEventUnitAbility(gt_SCVharvestingmanuallystopped, null, AbilityCommand("SCVHarvest", 0), c_unitAbilStageCancel, false)

// L2129
TriggerAddEventUnitAbility(gt_SCVisheadinghomewithterrazine, null, AbilityCommand("SCVHarvest", 1), c_abilHarvestStageWaitToReturn, false)

// L2130
TriggerAddEventUnitAbility(gt_SCVisheadinghomewithterrazine, null, AbilityCommand("SCVHarvest", 0), c_unitAbilStageComplete, false)

// L2342
TriggerAddEventUnitAbility(gt_Playerhasclaimedterrazine, null, AbilityCommand("SCVHarvest", 1), c_abilHarvestStageDropOff, false)

// L2580
TriggerAddEventUnitAbility(gt_ProtosssealingterrazineQ, null, AbilityCommand("ProbeHarvest", 0), c_abilHarvestStageHarvest, false)

// L2843
TriggerAddEventUnitAbility(gt_Probehassealedtheterrazine, null, AbilityCommand("ProbeHarvest", 1), c_abilHarvestStageWaitToReturn, false)

// L3908
TriggerAddEventUnitAbility(gt_ObjectiveRelicUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1815
TriggerAddEventUnitAbility(gt_GhostEMPSafetySet, UnitRefFromVariable("gv_ghostEMP"), AbilityCommand("EMP", 0), c_unitAbilStageAll, false)

// L1015
TriggerAddEventUnitAbility(gt_NukeCameraShakeCount, null, AbilityCommand("HeroNuclearStrike", 0), c_abilEffectStageFinish, false)

// L1224
TriggerAddEventUnitAbility(gt_DominationEndSafety, null, AbilityCommand("Domination", 0), c_abilEffectStageFinish, false)

// L1225
TriggerAddEventUnitAbility(gt_DominationEndSafety, null, AbilityCommand("Domination", 0), c_unitAbilStageCancel, false)

// L1418
TriggerAddEventUnitAbility(gt_P1SnipeFlashKiller, null, AbilityCommand("NovaSnipe", 0), c_unitAbilStageExecute, false)

// L1846
TriggerAddEventUnitAbility(gt_P1DominationFlashKiller, null, AbilityCommand("Domination", 0), c_unitAbilStageExecute, false)

// L2501
TriggerAddEventUnitAbility(gt_P2LZGuardDominated, null, AbilityCommand("Domination", 0), c_unitAbilStageComplete, false)

// L2538
TriggerAddEventUnitAbility(gt_P2LZGuardReleased, null, AbilityCommand("ReleaseMinion", 0), c_unitAbilStageComplete, false)

// L4241
TriggerAddEventUnitAbility(gt_P3ThorDominated, null, AbilityCommand("Domination", 0), c_unitAbilStageExecute, false)

// L4265
TriggerAddEventUnitAbility(gt_P3ThorReleased, null, AbilityCommand("ReleaseMinion", 0), c_unitAbilStageExecute, false)

// L4752
TriggerAddEventUnitAbility(gt_NukeLaunched, null, AbilityCommand("HeroNuclearStrike", 0), c_abilEffectStageCast, false)

// L6757
TriggerAddEventUnitAbility(gt_Collection01HarvestedMineralCheck, null, AbilityCommand("SCVHarvest", 0), c_abilHarvestStageHarvest, false)

// L7728
TriggerAddEventUnitAbility(gt_Collection03HarvestedGasCheck, null, AbilityCommand("SCVHarvest", 0), c_abilHarvestStageHarvest, false)

// L4418
TriggerAddEventUnitAbility(gt_ObjectiveRelicsUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L2321
TriggerAddEventUnitAbility(gt_LaserSoundRegionClear, UnitRefFromVariable("gv_tHEONEDRILL"), AbilityCommand("AttackAllowsInvulnerable", 0), c_unitAbilStageExecute, false)

// L3024
TriggerAddEventUnitAbility(gt_PrismAttackPhase3Arrival, null, AbilityCommand("PhasingMode", 0), c_unitAbilStageComplete, false)

// L4914
TriggerAddEventUnitAbility(gt_ObjectiveRelicsUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3231
TriggerAddEventUnitAbility(gt_ResearchObjectiveProtossRelicsUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1115
TriggerAddEventUnitAbility(gt_YamatoButtonFlashkiller, null, AbilityCommand("Yamato", 0), c_unitAbilStageAll, false)

// L2781
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5403
TriggerAddEventUnitAbility(gt_BaseMidSCV, null, AbilityCommand("CommandCenterTransport", 1), c_unitAbilStageComplete, false)

// L2968
TriggerAddEventUnitAbility(gt_GankBurrowRemoval, null, AbilityCommand("BurrowZerglingDown", 0), c_unitAbilStageComplete, true)

// L5340
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1862
TriggerAddEventUnitAbility(gt__1SnipeAbilityFlashOff, null, AbilityCommand("RaynorSnipe", 0), c_unitAbilStageExecute, false)

// L2161
TriggerAddEventUnitAbility(gt__1GrenadeAbilityFlashOff, null, AbilityCommand("BonesTossGrenade", 0), c_unitAbilStageExecute, false)

// L2495
TriggerAddEventUnitAbility(gt__1FlameTurretAbilityFlashOff, null, AbilityCommand("DutchPlaceTurret", 0), c_unitAbilStageExecute, false)

// L3592
TriggerAddEventUnitAbility(gt__1BroodchamberDestroyHintPings, null, AbilityCommand("DutchPlaceTurret", 0), c_abilEffectStageCast, false)

// L7269
TriggerAddEventUnitAbility(gt__3QueenShockwaveScreenShake, null, AbilityCommand("QueenShockwave", 0), c_unitAbilStageExecute, false)

// L8366
TriggerAddEventUnitAbility(gt_InfestorCooldown, null, AbilityCommand("InfestedTerrans", 0), c_abilEffectStageFinish, false)

// L8524
TriggerAddEventUnitAbility(gt_RaynorSnipeInitialize, null, AbilityCommand("RaynorSnipe", 0), c_unitAbilStageExecute, false)

// L8838
TriggerAddEventUnitAbility(gt_InfestorWarningQ, null, AbilityCommand("InfestedTerrans", 0), c_abilEffectStageFinish, false)

// L3486
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1385
TriggerAddEventUnitAbility(gt_EnergyNovaQ, UnitRefFromUnit(UnitFromId(42)), AbilityCommand("EnergyNova", 0), c_unitAbilStageExecute, false)

// L1452
TriggerAddEventUnitAbility(gt_EnergyNovaUsed, UnitRefFromUnit(UnitFromId(42)), AbilityCommand("EnergyNova", 0), c_unitAbilStageExecute, false)

// L3830
TriggerAddEventUnitAbility(gt_KerriganOmegastormCooldown, null, AbilityCommand("OmegaStorm", 0), c_unitAbilStageComplete, false)

// L3852
TriggerAddEventUnitAbility(gt_KerriganImplosionCooldown, null, AbilityCommand("Implosion", 0), c_unitAbilStageComplete, false)

// L4981
TriggerAddEventUnitAbility(gt_StunnedUltraliskQ, null, AbilityCommand("ZeratulStun", 0), c_unitAbilStageComplete, false)

// L1742
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1619
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5541
TriggerAddEventUnitAbility(gt_ResearchObjectiveChrysalisUpdate, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L1298
TriggerAddEventUnitAbility(gt_CreatePingsWhenInfestedUnburrows, null, AbilityCommand("BurrowInfestorUp", 0), c_unitAbilStageExecute, false)

// L1340
TriggerAddEventUnitAbility(gt_RemovePingsWhenInfestorBurrows, null, AbilityCommand("BurrowInfestorDown", 0), c_unitAbilStageExecute, false)

// L1473
TriggerAddEventUnitAbility(gt_InfestorCooldown, null, AbilityCommand("InfestedTerrans", 0), c_abilEffectStageFinish, false)

// L3605
TriggerAddEventUnitAbility(gt_ResourcePickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L4293
TriggerAddEventUnitAbility(gt_TransmissionPurifierUsesVortexQ, null, AbilityCommand("VortexPurifier", 0), c_unitAbilStageComplete, false)

// L1389
TriggerAddEventUnitAbility(gt_GasPickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L3267
TriggerAddEventUnitAbility(gt_ResourcePalletPickups, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)

// L5567
TriggerAddEventUnitAbility(gt_DefilerSkeletonFinding, null, AbilityCommand("Pickup", 0), c_unitAbilStageExecute, false)