# Random Unit From Unit Group

Grammar — Random type|Living/Dead unit from g|Unit Group
Flags — Native | Function

Returns a random unit from the specified unit group.

# Arguments

unitgroup — Group
int [ preset::UnitCountType ] — Type

Returns — unit

native unit UnitGroupRandomUnit(
	unitgroup inGroup,
	int inType,
);

Category: Unit Group / Groups

[F] — void — Add Unit To Unit Group — ( UnitGroupAdd )
[F] — void — Add Unit Group To Unit Group Old — ( libNtve_gf_AddUnitGroupToUnitGroup )
[F] — void — Add Unit Group To Unit Group — ( UnitGroupAddUnitGroup )
[F] — void — Unit Object Group Call For Help — ( UnitObjectGroupCallForHelp )
[F] — void — Remove Unit From Unit Group — ( UnitGroupRemove )
[F] — void — Remove Unit Group From Unit Group Old — ( libNtve_gf_RemoveUnitGroupFromUnitGroup )
[F] — void — Remove Unit Group From Unit Group — ( UnitGroupRemoveUnitGroup )
[F] — void — Remove All Units From Unit Group — ( UnitGroupClear )
[F] — void — Pause All Units In Unit Group — ( UnitGroupPauseAll )
[F] — int — Create Unit Object Group From Unit Group — ( UnitObjectGroupFromUnitGroup )
[F] — int — Number Of Units In Unit Group — ( UnitGroupCount )
[F] — bool — Unit In Unit Group — ( UnitGroupHasUnit )
[F] — unit — Unit From Unit Group — ( UnitGroupUnit )
[F] — unit — Random Unit From Unit Group — ( UnitGroupRandomUnit )
[F] — unitgroup — Copy Of Unit Group — ( UnitGroupCopy )
[F] — unit — Closest Unit To Point Old — ( libNtve_gf_ClosestUnitToPoint )
[F] — unit — Closest Unit To Point — ( UnitGroupClosestToPoint )
[F] — point — Center Of Unit Group Old — ( libNtve_gf_CenterOfUnitGroup )
[F] — point — Center Of Unit Group — ( UnitGroupCenterOfGroup )

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L317
UnitGroupRandomUnit(gv_civilianSpawners, c_unitCountAlive)

// L1398
UnitGroupRandomUnit(lv_zerglingGroup, c_unitCountAlive)

// L2262
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2263
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2265
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2269
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2440
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2623
UnitGroupRandomUnit(gv_convoyGuards, c_unitCountAlive)

// L919
UnitGroupRandomUnit(lv_attackersLeft, c_unitCountAlive)

// L929
UnitGroupRandomUnit(lv_attackersRight, c_unitCountAlive)

// L1417
UnitGroupRandomUnit(UnitGroup(null, gv_pLAYER_01_USER, RegionCircle(UnitGetPosition(auto7ECFBFDB_var), 14.0), UnitFilter((1 << c_targetFilterGround), 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1762
UnitGroupRandomUnit(lv_spawners, c_unitCountAlive)

// L4933
UnitGroupRandomUnit(lv_tempUnitGroup, c_unitCountAlive)

// L4954
UnitGroupRandomUnit(lv_tempUnitGroup, c_unitCountAlive)

// L389
UnitGroupRandomUnit(gv_currentWaveSources, c_unitCountAlive)

// L1799
UnitGroupRandomUnit(lv_target_Group, c_unitCountAlive)

// L3519
UnitGroupRandomUnit(UnitGroup("ColonistShip", gv_pLAYER03_COLONIST, EventUnitRegion(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L3528
UnitGroupRandomUnit(UnitGroup("ColonistShip", gv_pLAYER03_COLONIST, EventUnitRegion(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L354
UnitGroupRandomUnit(UnitGroup("Virophage", c_playerAny, lp_area, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1), c_unitCountAlive)

// L493
UnitGroupRandomUnit(lv_overlordPool, c_unitCountAlive)

// L526
UnitGroupRandomUnit(lv_overseerPool, c_unitCountAlive)

// L626
UnitGroupRandomUnit(UnitGroup("Overlord", gv_p07_ZERG_INFESTED, gv_infestationRegion[lp_colonyIndex], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L702
UnitGroupRandomUnit(UnitGroup("Colonist", gv_p05_COLONIST, lp_location, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L711
UnitGroupRandomUnit(UnitGroup("Colonist", gv_p05_COLONIST, lp_location, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L720
UnitGroupRandomUnit(UnitGroup("Colonist", gv_p05_COLONIST, lp_location, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L830
UnitGroupRandomUnit(UnitGroup("Colonist", c_playerAny, lp_locale, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L839
UnitGroupRandomUnit(UnitGroup(null, gv_p05_COLONIST, lp_locale, UnitFilter((1 << c_targetFilterStructure), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2230
UnitGroupRandomUnit(UnitGroup("Feederling", gv_p07_ZERG_INFESTED, gv_infestationRegion[lv_colonyIndex], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1693
UnitGroupRandomUnit(UnitGroup(null, gv_p01_USER, RegionFromId(47), UnitFilter(0, 0, (1 << c_targetFilterAir) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1745
UnitGroupRandomUnit(UnitGroup(null, gv_p01_USER, RegionFromId(48), UnitFilter(0, 0, (1 << c_targetFilterAir) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1752
UnitGroupRandomUnit(UnitGroup(null, gv_p01_USER, RegionFromId(48), UnitFilter(0, 0, (1 << c_targetFilterAir) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1801
UnitGroupRandomUnit(UnitGroup(null, gv_p01_USER, RegionFromId(49), UnitFilter(0, 0, (1 << c_targetFilterAir) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1366
UnitGroupRandomUnit(UnitGroup("Hut", gv_p06_CIVILIANS, RegionCircle(UnitGetPosition(EventUnit()), 50.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2287
UnitGroupRandomUnit(UnitGroup("SCV", gv_p07_HORNERBASE, RegionFromId(18), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2477
UnitGroupRandomUnit(UnitGroup("Hut", c_playerAny, RegionCircle(UnitGetPosition(EventUnit()), 50.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L10072
UnitGroupRandomUnit(lv_zergGroup, c_unitCountAlive)

// L10123
UnitGroupRandomUnit(lv_protossGroup, c_unitCountAlive)

// L1901
UnitGroupRandomUnit(gv_dropGroup, c_unitCountAlive)

// L2075
UnitGroupRandomUnit(lv_mARINES, c_unitCountAlive)

// L2045
UnitGroupRandomUnit(gv_marinesRescued, c_unitCountAlive)

// L2775
UnitGroupRandomUnit(gv_mineGuardGroup, c_unitCountAlive)

// L3301
UnitGroupRandomUnit(gv_toshReapers, c_unitCountAlive)

// L295
UnitGroupRandomUnit(lv_terrazineGroup, c_unitCountAlive)

// L303
UnitGroupRandomUnit(UnitGroup("TerrazineCanister", c_playerAny, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L574
UnitGroupRandomUnit(UnitGroup("Probe", c_playerAny, RegionFromId(36), UnitFilter(0, 0, 0, 0), 0), c_unitCountAlive)

// L576
UnitGroupRandomUnit(UnitGroup("Probe", c_playerAny, RegionFromId(38), UnitFilter(0, 0, 0, 0), 0), c_unitCountAlive)

// L2680
UnitGroupRandomUnit(UnitGroup("MineralField", c_playerAny, RegionFromId(36), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2684
UnitGroupRandomUnit(UnitGroup("MineralField", c_playerAny, RegionFromId(38), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L320
UnitGroupRandomUnit(lv_vehicles, c_unitCountAlive)

// L351
UnitGroupRandomUnit(lv_prisonerGroup, c_unitCountAlive)

// L364
UnitGroupRandomUnit(lv_vehicleGroup, c_unitCountAlive)

// L2702
UnitGroupRandomUnit(UnitGroup("PrisonerCivilian", gv_p7_PRISONER_YELLOW, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2706
UnitGroupRandomUnit(UnitGroup("PrisonerCivilian", gv_p7_PRISONER_YELLOW, RegionFromId(15), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L783
UnitGroupRandomUnit(UnitGroup("MineralField", 0, lp_mineralFieldArea, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1), c_unitCountAlive)

// L1604
UnitGroupRandomUnit(UnitGroup("Marauder", gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L2788
UnitGroupRandomUnit(gv_phasePrismUnitGroups[2], c_unitCountAlive)

// L2856
UnitGroupRandomUnit(gv_phasePrismUnitGroups[1], c_unitCountAlive)

// L2924
UnitGroupRandomUnit(gv_phasePrismUnitGroups[3], c_unitCountAlive)

// L3601
UnitGroupRandomUnit(gv_gROUPAliveInside, c_unitCountAlive)

// L5077
UnitGroupRandomUnit(UnitGroup("Medivac", gv_p06_MOEBIUS_SEC_FORCE, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L5248
UnitGroupRandomUnit(gv_gROUPAliveInside, c_unitCountAlive)

// L5697
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(33), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L5702
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(83), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L5707
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(91), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L5782
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, gv_feederlingRegions[FixedToInt(UnitGetCustomValue(auto937566B9_var, 0))], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L5783
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, gv_feederlingRegions[FixedToInt(UnitGetCustomValue(auto937566B9_var, 0))], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L6906
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(87), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L6911
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(88), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L6916
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(89), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L7631
UnitGroupRandomUnit(UnitGroup("Egg", c_playerAny, RegionFromId(119), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L7684
UnitGroupRandomUnit(lv_cocoons, c_unitCountAlive)

// L520
UnitGroupRandomUnit(lv_nearbyEnemies, c_unitCountAlive)

// L2750
UnitGroupRandomUnit(gv_zergEncircleGroupLeft, c_unitCountAlive)

// L2753
UnitGroupRandomUnit(gv_zergEncircleGroupRight, c_unitCountAlive)

// L2761
UnitGroupRandomUnit(gv_zergEncircleGroupLeft, c_unitCountAlive)

// L2766
UnitGroupRandomUnit(gv_zergEncircleGroupRight, c_unitCountAlive)

// L3589
UnitGroupRandomUnit(gv_zergEncircleGroupLeft, c_unitCountAlive)

// L3592
UnitGroupRandomUnit(gv_zergEncircleGroupRight, c_unitCountAlive)

// L3600
UnitGroupRandomUnit(gv_zergEncircleGroupLeft, c_unitCountAlive)

// L3605
UnitGroupRandomUnit(gv_zergEncircleGroupRight, c_unitCountAlive)

// L3677
UnitGroupRandomUnit(lv_unitGroup, c_unitCountAlive)

// L4263
UnitGroupRandomUnit(lv_unitGroup, c_unitCountAlive)

// L1812
UnitGroupRandomUnit(lv_gravitonTargets, c_unitCountAlive)

// L1885
UnitGroupRandomUnit(lv_plasmaTargets, c_unitCountAlive)

// L317
UnitGroupRandomUnit(gv_civilianSpawners, c_unitCountAlive)

// L1398
UnitGroupRandomUnit(lv_zerglingGroup, c_unitCountAlive)

// L2262
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2263
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2265
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2269
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2440
UnitGroupRandomUnit(gv_colonistsOnTheMove, c_unitCountAlive)

// L2623
UnitGroupRandomUnit(gv_convoyGuards, c_unitCountAlive)

// L919
UnitGroupRandomUnit(lv_attackersLeft, c_unitCountAlive)

// L929
UnitGroupRandomUnit(lv_attackersRight, c_unitCountAlive)

// L1417
UnitGroupRandomUnit(UnitGroup(null, gv_pLAYER_01_USER, RegionCircle(UnitGetPosition(auto7ECFBFDB_var), 14.0), UnitFilter((1 << c_targetFilterGround), 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), c_unitCountAlive)

// L1762
UnitGroupRandomUnit(lv_spawners, c_unitCountAlive)

// L4933
UnitGroupRandomUnit(lv_tempUnitGroup, c_unitCountAlive)

// L4954
UnitGroupRandomUnit(lv_tempUnitGroup, c_unitCountAlive)

// L389
UnitGroupRandomUnit(gv_currentWaveSources, c_unitCountAlive)

// L1799
UnitGroupRandomUnit(lv_target_Group, c_unitCountAlive)

# Random Unit From Unit Group

# Arguments

# Related

# Examples

# campaigns/liberty.sc2campaign