# Acquired Target

Grammar — Acquired Target
Flags — Function

Returns the acquired target of a unit.

Returns — unit

unit libNtve_gf_AcquiredTarget();

# Supported triggers

• Unit Acquires Target — TriggerAddEventUnitAcquiredTarget

# Related

Category: Unit / Combat

• Get Unit Damage Dealt Time — fixed — UnitGetDamageDealtTime
• Get Unit Damage Taken Time — fixed — UnitGetDamageTakenTime
• Weapon Used In Attack — string<gamelink::Weapon> — EventUnitGetWeapon
• Item Used In Attack — unit — EventUnitGetItem
• Item Type Used In Attack — string<gamelink::Item> — EventUnitGetItemType
• Unit Dies — void — TriggerAddEventUnitDied
• Killing Unit — unit — libNtve_gf_KillingUnit
• Killing Player — int — libNtve_gf_KillingPlayer
• Triggering Death Type Check — bool — EventUnitDamageDeathCheck
• Unit Is Being Removed — void — TriggerAddEventUnitRemoved
• Unit Starts Attacking (Deprecated) — void — TriggerAddEventUnitStartedAttack
• Unit Starts Attacking — void — TriggerAddEventUnitStartedAttack2
• Unit Is Attacked (Deprecated) — void — TriggerAddEventUnitAttacked
• Unit Is Attacked — void — TriggerAddEventUnitAttacked2
• Attacking Unit — unit — EventUnitTarget
• Unit Absorbs Damage — void — TriggerAddEventUnitDamageAbsorbed
• Unit Takes Damage — void — TriggerAddEventUnitDamaged
• Damaging Unit — unit — EventUnitDamageSourceUnit
• Damaging Player — int — EventUnitDamageSourcePlayer
• Damaging Effect — string<gamelink::Effect> — EventUnitDamageEffect
• Triggering Damage Taken — fixed — EventUnitDamageAmount
• Triggering Damage Attempted — fixed — EventUnitDamageAttempted
• Triggering Damage Attempted Vitals — fixed — EventUnitDamageAttemptedVitals
• Triggering Damage Absorbed — fixed — EventUnitDamageAbsorbed
• Triggering Damage Behavior Shield — fixed — EventUnitDamageBehaviorShield
• Triggering Vitals Leeched — fixed — EventUnitDamageVitalsLeeched
• Triggering Unit Kill XP — int — EventUnitDamageKillXP
• Damage Source Position — point — EventUnitDamageSourcePoint
• Unit is Healed — void — TriggerAddEventUnitHealed
• Healing Unit — unit — EventUnitHealLaunchUnit
• Healing Player — int — EventUnitHealLaunchPlayer
• Triggering Heal Vital Type — int<preset::UnitVitalType> — EventUnitHealVital
• Triggering Heal Given — fixed — EventUnitHealAmount
• Healing Effect — string<gamelink::Effect> — EventUnitHealEffect
• Unit Spends Vital — void — TriggerAddEventUnitSpendVital
• Triggering Spent Vital Type — int<preset::UnitVitalType> — EventUnitSpentVitalVital
• Triggering Vital Spent — fixed — EventUnitSpentVitalAmount
• Unit Acquires Target — void — TriggerAddEventUnitAcquiredTarget
• Acquired Target — unit — libNtve_gf_AcquiredTarget
• Unit Is Revived — void — TriggerAddEventUnitRevive
• Triggering Victim Unit — unit — EventUnitVictimUnit
• Triggering Item Used — unit — EventUnitItemUsed
• Triggering Effect Used — string<gamelink::Effect> — EventUnitEffectUsed

# Examples

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/thorner03.sc2map/MapScript.galaxy:3855

        }

        if (!((UnitGetType(libNtve_gf_AcquiredTarget()) == "Odin"))) {
            return false;
        }

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/thorner03.sc2map — MapScript.galaxy:3855

        }

        if (!((UnitGetType(libNtve_gf_AcquiredTarget()) == "Odin"))) {
            return false;
        }

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map/MapScript.galaxy:1246

        }

        if (!((UnitGetOwner(libNtve_gf_AcquiredTarget()) == gv_pLAYER_01_USER))) {
            return false;
        }

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map/MapScript.galaxy:1250

        }

        if (!(((UnitGetType(libNtve_gf_AcquiredTarget()) == "Roachling") || (UnitGetType(libNtve_gf_AcquiredTarget()) == "RoachCorpser")))) {
            return false;
        }

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map/MapScript.galaxy:1250

        }

        if (!(((UnitGetType(libNtve_gf_AcquiredTarget()) == "Roachling") || (UnitGetType(libNtve_gf_AcquiredTarget()) == "RoachCorpser")))) {
            return false;
        }

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zspace01.sc2map/MapScript.galaxy:3389

    lv_targetGroup = gf_HyperionFighterTargetGroup();
    if ((UnitGroupHasUnit(lv_targetGroup, libNtve_gf_AcquiredTarget()) == false)) {
        gf_HyperionFighterLeashing(EventUnit());
    }

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zspace01.sc2map/MapScript.galaxy:4302

    libNtve_gf_SendActorMessageToUnit(EventUnit(), "ModelSwap D8Charge");
    libNtve_gf_SendActorMessageToUnit(EventUnit(), "AnimPlay Custom Stand PlayForever,NonLooping 0.000000 0.000000 1.500000 AsDuration");
    lv_target = libNtve_gf_AcquiredTarget();
    if ((UnitGroupHasUnit(gv_hyperionFighterGroup, lv_target) == true)) {
        lv_target = gv_hyperion;

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map — MapScript.galaxy:1246

        }

        if (!((UnitGetOwner(libNtve_gf_AcquiredTarget()) == gv_pLAYER_01_USER))) {
            return false;
        }

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map — MapScript.galaxy:1250

        }

        if (!(((UnitGetType(libNtve_gf_AcquiredTarget()) == "Roachling") || (UnitGetType(libNtve_gf_AcquiredTarget()) == "RoachCorpser")))) {
            return false;
        }

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/evolution/zevolutionroach.sc2map — MapScript.galaxy:1250

        }

        if (!(((UnitGetType(libNtve_gf_AcquiredTarget()) == "Roachling") || (UnitGetType(libNtve_gf_AcquiredTarget()) == "RoachCorpser")))) {
            return false;
        }

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zspace01.sc2map — MapScript.galaxy:3389

    lv_targetGroup = gf_HyperionFighterTargetGroup();
    if ((UnitGroupHasUnit(lv_targetGroup, libNtve_gf_AcquiredTarget()) == false)) {
        gf_HyperionFighterLeashing(EventUnit());
    }

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zspace01.sc2map — MapScript.galaxy:4302

    libNtve_gf_SendActorMessageToUnit(EventUnit(), "ModelSwap D8Charge");
    libNtve_gf_SendActorMessageToUnit(EventUnit(), "AnimPlay Custom Stand PlayForever,NonLooping 0.000000 0.000000 1.500000 AsDuration");
    lv_target = libNtve_gf_AcquiredTarget();
    if ((UnitGroupHasUnit(gv_hyperionFighterGroup, lv_target) == true)) {
        lv_target = gv_hyperion;

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

    }

    UnitObjectGroupCallForHelp(EventUnit(), libNtve_gf_AcquiredTarget());
    return true;
}