# Unit Enters/Leaves Range Of Unit
Grammar — u state|Enters/Leaves a distance of range from fromUnit|Unit
Flags —Native
|Event
This event fires when a unit enters or leaves a distance around another unit. Use “Triggering Player” to get the player that was controlling the unit. Use “Triggering Unit” to get the unit.
# Arguments
unitref
[ unit ] — Unitunit
— From Unitfixed
— Rangebool
[ preset::RegionEnterLeaveState ] — State
Returns — void
native void TriggerAddEventUnitRange(
trigger t,
unitref u,
unit fromUnit,
fixed range,
bool state,
);
# Event parameters
- Triggering Game User — EventGameUser
- Triggering Player — EventPlayer
- Triggering Range Unit — EventUnitRangeUnit
- Triggering Unit — EventUnit
# Related
Category: Unit / Basic
- [F] —
void
— Unit Show Kill Display — ( UnitShowKillDisplay ) - [F] —
bool
— Unit Can Path To Point — ( UnitPathableToPoint ) - [F] —
bool
— Unit Can Path To Unit — ( UnitPathableToUnit ) - [F] —
void
— Create Units With Default Facing — ( libNtve_gf_CreateUnitsWithDefaultFacing ) - [F] —
void
— Create Units With Point Facing — ( libNtve_gf_CreateUnitsAtPoint2 ) - [F] —
unitgroup
— Create Units Facing Angle — ( UnitCreate ) - [F] —
unitgroup
— Create Units Facing Point — ( libNtve_gf_UnitCreateFacingPoint ) - [F] —
unit
— Last Created Unit — ( UnitLastCreated ) - [F] —
unitgroup
— Last Created Units — ( UnitLastCreatedGroup ) - [F] —
unit
— Original Caster Of Unit — ( UnitGetOriginalCaster ) - [F] —
string
[ gamelink::Effect ] — Effect That Created Unit — ( UnitGetOriginalEffect ) - [F] —
void
— Replace Unit — ( libNtve_gf_ReplaceUnit ) - [F] —
unit
— Last Replaced Unit — ( libNtve_gf_LastReplacedUnit ) - [F] —
void
— Change Owner — ( UnitSetOwner ) - [F] —
void
— Unit Owner Changes — ( TriggerAddEventUnitChangeOwner ) - [F] —
int
— Old Unit Owner — ( EventUnitOwnerOld ) - [F] —
int
— New Unit Owner — ( EventUnitOwnerNew ) - [F] —
void
— Rescue Unit — ( libNtve_gf_RescueUnit ) - [F] —
void
— Rescue Unit Group — ( libNtve_gf_RescueUnit2 ) - [F] —
void
— Kill Unit — ( UnitKill ) - [F] —
void
— Revive Unit — ( UnitRevive ) - [F] —
void
— Remove Unit — ( UnitRemove ) - [F] —
int
— Owner Of Unit — ( UnitGetOwner ) - [F] —
bool
— Unit Is Alive — ( UnitIsAlive ) - [F] —
bool
— Unit Is Valid — ( UnitIsValid ) - [F] —
bool
— Unit Group Is Dead — ( libNtve_gf_UnitGroupIsDead ) - [F] —
void
— Move Unit Instantly — ( UnitSetPosition ) - [F] —
void
— Make Unit Face Angle — ( UnitSetFacing ) - [F] —
void
— Make Unit Face Point — ( libNtve_gf_MakeUnitFacePoint ) - [F] —
point
— Position Of Unit — ( UnitGetPosition ) - [F] —
point
— Goal Position Of Unit — ( UnitGetGoalPosition ) - [F] —
fixed
— Facing Angle Of Unit — ( UnitGetFacing ) - [F] —
void
— Pause/Unpause Unit — ( libNtve_gf_PauseUnit ) - [F] —
void
— Pause/Unpause All Units — ( UnitPauseAll ) - [F] —
void
— Sleep/WakeUp Unit — ( libNtve_gf_SleepUnit ) - [F] —
void
— Show/Hide Unit — ( libNtve_gf_ShowHideUnit ) - [F] —
void
— Share Vision of Unit — ( libNtve_gf_ShareVisionofUnit ) - [F] —
bool
— Unit Is Paused — ( libNtve_gf_UnitIsPaused ) - [F] —
bool
— Unit Is Sleepiing — ( libNtve_gf_UnitIsSleepiing ) - [F] —
bool
— Unit Is Hidden — ( libNtve_gf_UnitIsHidden ) - [F] —
bool
— Unit Is Visible To Player — ( libNtve_gf_UnitIsVisibleToPlayer ) - [F] —
void
— Set Unit Custom Value — ( UnitSetCustomValue ) - [F] —
fixed
— Custom Value Of Unit — ( UnitGetCustomValue ) - [F] —
void
— Unit Enters/Leaves Region — ( TriggerAddEventUnitRegion ) - [F] —
region
— Triggering Region — ( EventUnitRegion ) - [F] —
void
— Unit Enters/Leaves Point — ( TriggerAddEventUnitRangePoint ) - [F] —
void
— Unit Enters/Leaves Range Of Unit — ( TriggerAddEventUnitRange ) - [F] —
unit
— Triggering Range Unit — ( EventUnitRangeUnit ) - [F] —
bool
— Unit In Region — ( libNtve_gf_UnitInRegion ) - [F] —
unit
— Triggering Unit — ( EventUnit ) - [F] —
void
— Load Unit Model — ( UnitLoadModel ) - [F] —
void
— Unload Unit Model — ( UnitUnloadModel ) - [F] —
unit
— Agent Of Player For Unit — ( UnitAgent ) - [F] —
void
— Change Empty Unit Variables In Events — ( UnitEventSetNullVariableInvalid ) - [F] —
text
— Name of Unit — ( UnitGetName ) - [F] —
int
— Ideal Harvester Count — ( UnitIdealWorkerCount ) - [F] —
int
— Current Harvester Count — ( UnitCurrentWorkerCount )
# Examples
# campaigns/liberty.sc2campaign
// L3523
TriggerAddEventUnitRange(gt_TransmissionFirstBarrageQ, UnitRefFromUnit(UnitFromId(2)), UnitFromId(119), 12.0, true)
// L845
TriggerAddEventUnitRange(gt_RunDogmeatRUN, null, UnitFromId(2661), 3.0, true)
// L987
TriggerAddEventUnitRange(gt_CrazyOldLadyLineQ, null, UnitFromId(43), 5.5, true)
// L1416
TriggerAddEventUnitRange(gt_MutteringJohnQ, null, UnitFromId(645), 5.0, true)
// L3176
TriggerAddEventUnitRange(gt_CreateReticule2, null, UnitFromId(24), 8.0, true)
// L3218
TriggerAddEventUnitRange(gt_CreateReticule3, null, UnitFromId(207), 4.0, true)
// L3260
TriggerAddEventUnitRange(gt_CreateReticule4, null, UnitFromId(32), 8.0, true)
// L3302
TriggerAddEventUnitRange(gt_CreateReticule5, null, UnitFromId(68), 8.0, true)
// L3344
TriggerAddEventUnitRange(gt_CreateReticule6, null, UnitFromId(2694), 8.0, true)
// L2128
TriggerAddEventUnitRange(gt_P1Spec2powers, null, UnitFromId(181), 9.0, true)
// L3546
TriggerAddEventUnitRange(gt_P2WestSpectrepowers, null, UnitFromId(425), 8.0, true)
// L4130
TriggerAddEventUnitRange(gt_P3CentralSpectrepowers, null, UnitFromId(306), 8.0, true)
// L4496
TriggerAddEventUnitRange(gt_P3PostNukerApowers, null, UnitFromId(242), 8.0, true)
// L4538
TriggerAddEventUnitRange(gt_P3PostNukerBpowers, null, UnitFromId(246), 8.0, true)
// L1030
TriggerAddEventUnitRange(gt_BrutaliskStumbledUpon, null, UnitFromId(1178), 14.0, true)
// L965
TriggerAddEventUnitRange(gt_PingDetectorCannon, null, UnitFromId(420), 10.0, true)
// L966
TriggerAddEventUnitRange(gt_PingDetectorCannon, null, UnitFromId(4), 10.0, true)
// L2384
TriggerAddEventUnitRange(gt_MothershipProximityAttack, null, UnitFromId(3), 30.0, true)
// L3523
TriggerAddEventUnitRange(gt_TransmissionFirstBarrageQ, UnitRefFromUnit(UnitFromId(2)), UnitFromId(119), 12.0, true)
// L845
TriggerAddEventUnitRange(gt_RunDogmeatRUN, null, UnitFromId(2661), 3.0, true)
// L987
TriggerAddEventUnitRange(gt_CrazyOldLadyLineQ, null, UnitFromId(43), 5.5, true)
// L1416
TriggerAddEventUnitRange(gt_MutteringJohnQ, null, UnitFromId(645), 5.0, true)
// L3176
TriggerAddEventUnitRange(gt_CreateReticule2, null, UnitFromId(24), 8.0, true)
// L3218
TriggerAddEventUnitRange(gt_CreateReticule3, null, UnitFromId(207), 4.0, true)
// L3260
TriggerAddEventUnitRange(gt_CreateReticule4, null, UnitFromId(32), 8.0, true)
// L3302
TriggerAddEventUnitRange(gt_CreateReticule5, null, UnitFromId(68), 8.0, true)
// L3344
TriggerAddEventUnitRange(gt_CreateReticule6, null, UnitFromId(2694), 8.0, true)
// L2128
TriggerAddEventUnitRange(gt_P1Spec2powers, null, UnitFromId(181), 9.0, true)
// L3546
TriggerAddEventUnitRange(gt_P2WestSpectrepowers, null, UnitFromId(425), 8.0, true)
// L4130
TriggerAddEventUnitRange(gt_P3CentralSpectrepowers, null, UnitFromId(306), 8.0, true)
// L4496
TriggerAddEventUnitRange(gt_P3PostNukerApowers, null, UnitFromId(242), 8.0, true)
// L4538
TriggerAddEventUnitRange(gt_P3PostNukerBpowers, null, UnitFromId(246), 8.0, true)
// L1030
TriggerAddEventUnitRange(gt_BrutaliskStumbledUpon, null, UnitFromId(1178), 14.0, true)
// L965
TriggerAddEventUnitRange(gt_PingDetectorCannon, null, UnitFromId(420), 10.0, true)
// L966
TriggerAddEventUnitRange(gt_PingDetectorCannon, null, UnitFromId(4), 10.0, true)
// L2384
TriggerAddEventUnitRange(gt_MothershipProximityAttack, null, UnitFromId(3), 30.0, true)
// L1537
TriggerAddEventUnitRange(gt_PlayerApproachingInfestedCommandCenters, null, UnitFromId(948), 10.0, true)
// L1538
TriggerAddEventUnitRange(gt_PlayerApproachingInfestedCommandCenters, null, UnitFromId(946), 10.0, true)
// L2516
TriggerAddEventUnitRange(gt_FirstEggEvent, UnitRefFromVariable("gv_kerrigan"), UnitFromId(640), 8.0, true)
// L4412
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1831), 1.5, true)
// L4413
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1824), 1.5, true)
// L4414
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1832), 1.5, true)
// L2190
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(468), 4.0, true)
// L2191
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(465), 4.0, true)
// L2192
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(395), 6.0, true)
// L2193
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(396), 6.0, true)
// L2194
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(398), 6.0, true)
// L2195
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(384), 6.0, true)
// L2196
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(385), 6.0, true)
// L2197
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(393), 6.0, true)
// L2198
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(394), 6.0, true)
// L2199
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(401), 6.0, true)
// L3050
TriggerAddEventUnitRange(gt_EnableBeaconbyproximity_Center, null, UnitFromId(292), 5.0, true)
// L3086
TriggerAddEventUnitRange(gt_EnableBeaconbyproximity_2ndright, null, UnitFromId(106), 5.0, true)
// L3123
TriggerAddEventUnitRange(gt_EnableBeaconbyproximity_1stLeft, null, UnitFromId(30), 5.0, true)
// L3160
TriggerAddEventUnitRange(gt_EnableBeaconbyproximity_2ndLeft, null, UnitFromId(234), 5.0, true)
// L3345
TriggerAddEventUnitRange(gt_TransmissionNextTwoBeaconsQ, null, UnitFromId(149), 14.0, true)
// L3346
TriggerAddEventUnitRange(gt_TransmissionNextTwoBeaconsQ, null, UnitFromId(292), 14.0, true)
// L3404
TriggerAddEventUnitRange(gt_TransmissionLastThreeBeaconsQ, null, UnitFromId(106), 15.0, true)
// L3405
TriggerAddEventUnitRange(gt_TransmissionLastThreeBeaconsQ, null, UnitFromId(30), 15.0, true)
// L3406
TriggerAddEventUnitRange(gt_TransmissionLastThreeBeaconsQ, null, UnitFromId(234), 15.0, true)
// L3939
TriggerAddEventUnitRange(gt_CreateLabEntranceIndicator, null, UnitFromId(212), 10.0, true)
// L3338
TriggerAddEventUnitRange(gt_TransmissionFirstPowerLinkAttackedQ, UnitRefFromVariable("gv_dEHAKA"), UnitFromId(446), 10.0, true)
// L3505
TriggerAddEventUnitRange(gt_MakeBridgeBattleForcesTakeDamage, UnitRefFromVariable("gv_kerrigan"), UnitFromId(784), 7.0, true)
// L3794
TriggerAddEventUnitRange(gt_RemoveUmojanAtExtractionPoint01, null, UnitFromId(84), 2.0, true)
// L1983
TriggerAddEventUnitRange(gt_HyperionIsClose1, UnitRefFromVariable("gv_hyperion"), UnitFromId(232), 14.0, true)
// L1984
TriggerAddEventUnitRange(gt_HyperionIsClose1, UnitRefFromVariable("gv_hyperion"), UnitFromId(183), 14.0, true)
// L2005
TriggerAddEventUnitRange(gt_HyperionIsClose2, UnitRefFromVariable("gv_hyperion"), UnitFromId(602), 14.0, true)
// L2006
TriggerAddEventUnitRange(gt_HyperionIsClose2, UnitRefFromVariable("gv_hyperion"), UnitFromId(185), 14.0, true)
// L2617
TriggerAddEventUnitRange(gt_SecondBaseCloseQ, UnitRefFromVariable("gv_hyperion"), UnitFromId(656), 18.0, true)
// L1610
TriggerAddEventUnitRange(gt_SecretDocumentPickups, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1047), 1.5, true)
// L1611
TriggerAddEventUnitRange(gt_SecretDocumentPickups, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1118), 1.5, true)
// L4021
TriggerAddEventUnitRange(gt__1PrisonCellInfestation, UnitRefFromVariable("gv_kerrigan"), UnitFromId(576), 3.0, true)
// L4022
TriggerAddEventUnitRange(gt__1PrisonCellInfestation, UnitRefFromVariable("gv_kerrigan"), UnitFromId(575), 3.0, true)
// L4023
TriggerAddEventUnitRange(gt__1PrisonCellInfestation, UnitRefFromVariable("gv_kerrigan"), UnitFromId(607), 3.0, true)
// L4024
TriggerAddEventUnitRange(gt__1PrisonCellInfestation, UnitRefFromVariable("gv_kerrigan"), UnitFromId(613), 3.0, true)
// L3490
TriggerAddEventUnitRange(gt_PrimalHiveWarningQ, null, UnitFromId(469), 10.0, true)
// L3491
TriggerAddEventUnitRange(gt_PrimalHiveWarningQ, null, UnitFromId(468), 10.0, true)
// L3492
TriggerAddEventUnitRange(gt_PrimalHiveWarningQ, null, UnitFromId(2088), 10.0, true)
// L3493
TriggerAddEventUnitRange(gt_PrimalHiveWarningQ, null, UnitFromId(206), 10.0, true)
// L3684
TriggerAddEventUnitRange(gt_EssencePoolApproached, UnitRefFromVariable("gv_kerrigan"), UnitFromId(2060), 18.0, true)
// L3685
TriggerAddEventUnitRange(gt_EssencePoolApproached, UnitRefFromVariable("gv_kerrigan"), UnitFromId(154), 18.0, true)
// L3686
TriggerAddEventUnitRange(gt_EssencePoolApproached, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1346), 18.0, true)
// L3858
TriggerAddEventUnitRange(gt_EssencePoolAbsorbedQ, UnitRefFromVariable("gv_kerrigan"), UnitFromId(154), 1.5, true)
// L3859
TriggerAddEventUnitRange(gt_EssencePoolAbsorbedQ, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1346), 1.5, true)
// L3860
TriggerAddEventUnitRange(gt_EssencePoolAbsorbedQ, UnitRefFromVariable("gv_kerrigan"), UnitFromId(2060), 1.5, true)
// L1537
TriggerAddEventUnitRange(gt_PlayerApproachingInfestedCommandCenters, null, UnitFromId(948), 10.0, true)
// L1538
TriggerAddEventUnitRange(gt_PlayerApproachingInfestedCommandCenters, null, UnitFromId(946), 10.0, true)
// L2516
TriggerAddEventUnitRange(gt_FirstEggEvent, UnitRefFromVariable("gv_kerrigan"), UnitFromId(640), 8.0, true)
// L4412
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1831), 1.5, true)
// L4413
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1824), 1.5, true)
// L4414
TriggerAddEventUnitRange(gt_ObjectiveFindZergBiomassUpdate, UnitRefFromVariable("gv_kerrigan"), UnitFromId(1832), 1.5, true)
// L2190
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(468), 4.0, true)
// L2191
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(465), 4.0, true)
// L2192
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(395), 6.0, true)
// L2193
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(396), 6.0, true)
// L2194
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(398), 6.0, true)
// L2195
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(384), 6.0, true)
// L2196
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(385), 6.0, true)
// L2197
TriggerAddEventUnitRange(gt_RescueRoaches, null, UnitFromId(393), 6.0, true)