# Unit Acquires Target
Grammar — u acquires a target
Flags —Native
|Event
This event fires when a unit acquires a target. Use “Acquired Target” to get the target that was acquired. Use “Triggering Player” to get the owner of the unit that acquired a target. Use “Triggering Unit” to get the unit that acquired a target.
# Arguments
unitref
[ unit ] — Unit
Returns — void
native void TriggerAddEventUnitAcquiredTarget(
trigger t,
unitref u,
);
# Event parameters
- Triggering Game User — EventGameUser
- Triggering Player — EventPlayer
- Triggering Unit — EventUnit
- Acquired Target — libNtve_gf_AcquiredTarget
# Related
Category: Unit / Combat
- [F] —
fixed
— Get Unit Damage Dealt Time — ( UnitGetDamageDealtTime ) - [F] —
fixed
— Get Unit Damage Taken Time — ( UnitGetDamageTakenTime ) - [F] —
string
[ gamelink::Weapon ] — Weapon Used In Attack — ( EventUnitGetWeapon ) - [F] —
unit
— Item Used In Attack — ( EventUnitGetItem ) - [F] —
string
[ gamelink::Item ] — Item Type Used In Attack — ( EventUnitGetItemType ) - [F] —
void
— Unit Dies — ( TriggerAddEventUnitDied ) - [F] —
unit
— Killing Unit — ( libNtve_gf_KillingUnit ) - [F] —
int
— Killing Player — ( libNtve_gf_KillingPlayer ) - [F] —
bool
— Triggering Death Type Check — ( EventUnitDamageDeathCheck ) - [F] —
void
— Unit Is Being Removed — ( TriggerAddEventUnitRemoved ) - [F] —
void
— Unit Starts Attacking (Deprecated) — ( TriggerAddEventUnitStartedAttack ) - [F] —
void
— Unit Starts Attacking — ( TriggerAddEventUnitStartedAttack2 ) - [F] —
void
— Unit Is Attacked (Deprecated) — ( TriggerAddEventUnitAttacked ) - [F] —
void
— Unit Is Attacked — ( TriggerAddEventUnitAttacked2 ) - [F] —
unit
— Attacking Unit — ( EventUnitTarget ) - [F] —
void
— Unit Absorbs Damage — ( TriggerAddEventUnitDamageAbsorbed ) - [F] —
void
— Unit Takes Damage — ( TriggerAddEventUnitDamaged ) - [F] —
unit
— Damaging Unit — ( EventUnitDamageSourceUnit ) - [F] —
int
— Damaging Player — ( EventUnitDamageSourcePlayer ) - [F] —
string
[ gamelink::Effect ] — Damaging Effect — ( EventUnitDamageEffect ) - [F] —
fixed
— Triggering Damage Taken — ( EventUnitDamageAmount ) - [F] —
fixed
— Triggering Damage Attempted — ( EventUnitDamageAttempted ) - [F] —
fixed
— Triggering Damage Attempted Vitals — ( EventUnitDamageAttemptedVitals ) - [F] —
fixed
— Triggering Damage Absorbed — ( EventUnitDamageAbsorbed ) - [F] —
fixed
— Triggering Damage Behavior Shield — ( EventUnitDamageBehaviorShield ) - [F] —
fixed
— Triggering Vitals Leeched — ( EventUnitDamageVitalsLeeched ) - [F] —
int
— Triggering Unit Kill XP — ( EventUnitDamageKillXP ) - [F] —
point
— Damage Source Position — ( EventUnitDamageSourcePoint ) - [F] —
void
— Unit is Healed — ( TriggerAddEventUnitHealed ) - [F] —
unit
— Healing Unit — ( EventUnitHealLaunchUnit ) - [F] —
int
— Healing Player — ( EventUnitHealLaunchPlayer ) - [F] —
int
[ preset::UnitVitalType ] — Triggering Heal Vital Type — ( EventUnitHealVital ) - [F] —
fixed
— Triggering Heal Given — ( EventUnitHealAmount ) - [F] —
string
[ gamelink::Effect ] — Healing Effect — ( EventUnitHealEffect ) - [F] —
void
— Unit Spends Vital — ( TriggerAddEventUnitSpendVital ) - [F] —
int
[ preset::UnitVitalType ] — Triggering Spent Vital Type — ( EventUnitSpentVitalVital ) - [F] —
fixed
— Triggering Vital Spent — ( EventUnitSpentVitalAmount ) - [F] —
void
— Unit Acquires Target — ( TriggerAddEventUnitAcquiredTarget ) - [F] —
unit
— Acquired Target — ( libNtve_gf_AcquiredTarget ) - [F] —
void
— Unit Is Revived — ( TriggerAddEventUnitRevive ) - [F] —
unit
— Triggering Victim Unit — ( EventUnitVictimUnit ) - [F] —
unit
— Triggering Item Used — ( EventUnitItemUsed ) - [F] —
string
[ gamelink::Effect ] — Triggering Effect Used — ( EventUnitEffectUsed )
# Examples
# campaigns/liberty.sc2campaign
// L3880
TriggerAddEventUnitAcquiredTarget(gt_TransmissionOdinApproachesP04BaseQ, UnitRefFromUnit(UnitFromId(28)))
// L4080
TriggerAddEventUnitAcquiredTarget(gt_DialogueHaltatPlayerBase01Q, null)
// L3880
TriggerAddEventUnitAcquiredTarget(gt_TransmissionOdinApproachesP04BaseQ, UnitRefFromUnit(UnitFromId(28)))
// L4080
TriggerAddEventUnitAcquiredTarget(gt_DialogueHaltatPlayerBase01Q, null)
// L2962
TriggerAddEventUnitAcquiredTarget(gt_SiegeTankEntersSiegeMode, UnitRefFromUnit(UnitFromId(253)))
// L2436
TriggerAddEventUnitAcquiredTarget(gt_TransmissionThorAggroQ, null)
// L4524
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(281)))
// L4525
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(297)))
// L4526
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(410)))
// L4527
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(13)))
// L4528
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(1109)))
// L4529
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(995)))
// L2353
TriggerAddEventUnitAcquiredTarget(gt_UrsadonAttack03Sound, UnitRefFromUnit(UnitFromId(93)))
// L2354
TriggerAddEventUnitAcquiredTarget(gt_UrsadonAttack03Sound, UnitRefFromUnit(UnitFromId(458)))
// L2543
TriggerAddEventUnitAcquiredTarget(gt_MineralClustersMinesUnhighlight, null)
// L3400
TriggerAddEventUnitAcquiredTarget(gt_HyperionFighterAcquireTarget, null)
// L4335
TriggerAddEventUnitAcquiredTarget(gt_SpaceMineAttack, null)
// L4854
TriggerAddEventUnitAcquiredTarget(gt_BattlecruiserLogic, null)
// L6589
TriggerAddEventUnitAcquiredTarget(gt__2PrisonRoomEnteredQ, UnitRefFromUnit(UnitFromId(850)))
// L1360
TriggerAddEventUnitAcquiredTarget(gt_PrimalEngagedEarly, null)
// L1368
TriggerAddEventUnitAcquiredTarget(gt_SplitterFirstEncounter, UnitRefFromUnit(UnitFromId(95)))
// L1421
TriggerAddEventUnitAcquiredTarget(gt_SplitterProtossTauntQ1, UnitRefFromUnit(UnitFromId(170)))
// L1452
TriggerAddEventUnitAcquiredTarget(gt_SplitterProtossTauntQ2, UnitRefFromUnit(UnitFromId(705)))
// L2471
TriggerAddEventUnitAcquiredTarget(gt_HunterDominionTheyarejumpingQ, UnitRefFromUnit(UnitFromId(233)))
// L2771
TriggerAddEventUnitAcquiredTarget(gt_HunterMedivacDrop2AttackedQ, null)
// L2905
TriggerAddEventUnitAcquiredTarget(gt_HunterWhereDoTheyComeFromQ, null)
// L1283
TriggerAddEventUnitAcquiredTarget(gt_VikingModeSwap, null)
// L1272
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(132)))
// L1273
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(7)))
// L1274
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(1358)))
// L1275
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(630)))
// L2277
TriggerAddEventUnitAcquiredTarget(gt_Colossus, UnitRefFromUnit(UnitFromId(112)))
// L1301
TriggerAddEventUnitAcquiredTarget(gt_SwarmlingInitAttackWaveEngaged, null)
// L2360
TriggerAddEventUnitAcquiredTarget(gt_RaptorEncounter, UnitRefFromUnit(UnitFromId(974)))
// L1368
TriggerAddEventUnitAcquiredTarget(gt_SplitterFirstEncounter, UnitRefFromUnit(UnitFromId(95)))
// L1421
TriggerAddEventUnitAcquiredTarget(gt_SplitterProtossTauntQ1, UnitRefFromUnit(UnitFromId(170)))
// L1452
TriggerAddEventUnitAcquiredTarget(gt_SplitterProtossTauntQ2, UnitRefFromUnit(UnitFromId(705)))
// L2471
TriggerAddEventUnitAcquiredTarget(gt_HunterDominionTheyarejumpingQ, UnitRefFromUnit(UnitFromId(233)))
// L2771
TriggerAddEventUnitAcquiredTarget(gt_HunterMedivacDrop2AttackedQ, null)
// L2905
TriggerAddEventUnitAcquiredTarget(gt_HunterWhereDoTheyComeFromQ, null)
// L1283
TriggerAddEventUnitAcquiredTarget(gt_VikingModeSwap, null)
// L1272
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(132)))
// L1273
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(7)))
// L1274
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(1358)))
// L1275
TriggerAddEventUnitAcquiredTarget(gt_TransmissionZergSpottedQ, UnitRefFromUnit(UnitFromId(630)))
// L2277
TriggerAddEventUnitAcquiredTarget(gt_Colossus, UnitRefFromUnit(UnitFromId(112)))
// L1301
TriggerAddEventUnitAcquiredTarget(gt_SwarmlingInitAttackWaveEngaged, null)
// L2360
TriggerAddEventUnitAcquiredTarget(gt_RaptorEncounter, UnitRefFromUnit(UnitFromId(974)))
// L2962
TriggerAddEventUnitAcquiredTarget(gt_SiegeTankEntersSiegeMode, UnitRefFromUnit(UnitFromId(253)))
// L2436
TriggerAddEventUnitAcquiredTarget(gt_TransmissionThorAggroQ, null)
// L4524
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(281)))
// L4525
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(297)))
// L4526
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(410)))
// L4527
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(13)))
// L4528
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(1109)))
// L4529
TriggerAddEventUnitAcquiredTarget(gt_TransmissionBridgeGhostSquadsQ, UnitRefFromUnit(UnitFromId(995)))
// L2353
TriggerAddEventUnitAcquiredTarget(gt_UrsadonAttack03Sound, UnitRefFromUnit(UnitFromId(93)))
// L2354
TriggerAddEventUnitAcquiredTarget(gt_UrsadonAttack03Sound, UnitRefFromUnit(UnitFromId(458)))
// L2543
TriggerAddEventUnitAcquiredTarget(gt_MineralClustersMinesUnhighlight, null)
// L3400
TriggerAddEventUnitAcquiredTarget(gt_HyperionFighterAcquireTarget, null)
// L4335
TriggerAddEventUnitAcquiredTarget(gt_SpaceMineAttack, null)
// L4854
TriggerAddEventUnitAcquiredTarget(gt_BattlecruiserLogic, null)
// L6589
TriggerAddEventUnitAcquiredTarget(gt__2PrisonRoomEnteredQ, UnitRefFromUnit(UnitFromId(850)))
// L1360
TriggerAddEventUnitAcquiredTarget(gt_PrimalEngagedEarly, null)
# mods/warcoop/warclassicsystem.sc2mod
// L879
TriggerAddEventUnitAcquiredTarget(libGAwX_gt_CreepPlayersLinkedAgro, null)