# Unit Count In Region Matching Condition

Grammar — Count of type units in reg owned by player player matching unitFilter, with at most count
Flags — Native | Function

Returns a count of units that match the specified filters.

# Arguments

• string [ gamelink::Unit ] — Unit Type
• int — Player
• region — Region
• unitfilter — Unit Filter
• int — Count

Returns — int

native int UnitCount(
	string type,
	int player,
	region r,
	unitfilter filter,
	int maxCount,
);

# Related

Category: Unit Group / Useful Unit Groups

• [F] — unitgroup — Empty Unit Group — ( UnitGroupEmpty )
• [F] — unitgroup — Idle Units For Player — ( UnitGroupIdle )
• [F] — unitgroup — Convert Unit To Unit Group — ( libNtve_gf_ConvertUnitToUnitGroup )
• [F] — unitgroup — Units In Region Matching Condition — ( UnitGroup )
• [F] — int — Unit Count In Region Matching Condition — ( UnitCount )
• [F] — unitgroup — Units Near Point Matching Condition — ( UnitGroupSearch )
• [F] — unitgroup — Units In Region With Alliance To Player — ( UnitGroupAlliance )
• [F] — int — Unit Count In Region With Alliance To Player — ( UnitCountAlliance )
• [F] — unitgroup — Units In Region With Alliance To Player Matching Condition — ( libNtve_gf_UnitsInRegionWithAllianceToPlayerMatchingCondition )
• [F] — unitgroup — Units In Unit Group For Player — ( UnitGroupFilterPlayer )
• [F] — unitgroup — Units In Unit Group Matching Condition — ( UnitGroupFilter )
• [F] — unitgroup — Units In Unit Group Targetable As — ( UnitGroupFilterPlane )
• [F] — unitgroup — Units In Unit Group With Alliance — ( UnitGroupFilterAlliance )
• [F] — unitgroup — Units In Unit Group With Custom Value — ( libNtve_gf_UnitsInUnitGroupWithCustomValue )
• [F] — unitgroup — Units In Unit Group Within Region — ( UnitGroupFilterRegion )

# Examples

# campaigns/void.sc2campaign

— MapScript.galaxy

// L3735
UnitCount(null, gv_p01_USER, RegionFromId(33), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L9166
UnitCount(null, gv_p01_USER, RegionFromId(40), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L9202
UnitCount(null, gv_p01_USER, RegionFromId(41), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L14968
UnitCount(null, gv_p01_USER, RegionFromId(38), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L5360
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5470
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5521
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5529
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2400
UnitCount(null, gv_pLAYER_07_TALDARIM, RegionFromId(2), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2451
UnitCount(null, gv_pLAYER_08_NERAZIM, RegionFromId(3), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2502
UnitCount(null, gv_pLAYER_09_PURIFIER, RegionFromId(4), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2876
UnitCount(null, gv_pLAYER_04_AMON, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterHeroic) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L3735
UnitCount(null, gv_p01_USER, RegionFromId(33), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L9166
UnitCount(null, gv_p01_USER, RegionFromId(40), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L9202
UnitCount(null, gv_p01_USER, RegionFromId(41), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L14968
UnitCount(null, gv_p01_USER, RegionFromId(38), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 0)

// L5360
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5470
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5521
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L5529
UnitCount(null, gv_pLAYER_01_USER, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2400
UnitCount(null, gv_pLAYER_07_TALDARIM, RegionFromId(2), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2451
UnitCount(null, gv_pLAYER_08_NERAZIM, RegionFromId(3), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2502
UnitCount(null, gv_pLAYER_09_PURIFIER, RegionFromId(4), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L2876
UnitCount(null, gv_pLAYER_04_AMON, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterHeroic) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

# mods/heroesbrawlmods/brawlmapmods/coop/pvebrawlstarcraft.stormmod

— LibPESC.galaxy

// L166
UnitCount(null, c_playerAny, RegionCircle(UnitGetPosition(libPESC_gv_hMCLCaptureSlab), libPESC_gv_hMCLCaptureRadius), UnitFilter((1 << c_targetFilterHeroic), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L166
UnitCount(null, c_playerAny, RegionCircle(UnitGetPosition(libPESC_gv_hMCLCaptureSlab), libPESC_gv_hMCLCaptureRadius), UnitFilter((1 << c_targetFilterHeroic), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

# mods/heroesdata.stormmod

— GameDataHelperLib.galaxy

// L6343
UnitCount("ArthasArmyOfTheDeadGhoul", lv_player, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L6396
UnitCount("ArthasArmyOfTheDeadGhoul", lv_player, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

# mods/novastoryassets.sc2mod

— MapScript.galaxy

// L1362
UnitCount("InfestableColonistHut", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedCC", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedBarracks", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedFactory", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedStarport", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedEngBay", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedArmory", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedBunker", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedSupply", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedMissileTurret", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestableColonistHut", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedCC", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedBarracks", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedFactory", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedStarport", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedEngBay", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedArmory", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedBunker", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedSupply", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L1362
UnitCount("InfestedMissileTurret", lp_player, lp_bullyRebuildRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

# mods/starcoop/starcoop.sc2mod

— LibCOMU.galaxy

// L3135
UnitCount(null, c_playerAny, RegionCircle(lv_targetLocation, 5.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1)

// L6949
UnitCount(null, c_playerAny, RegionCircle(lv_spawnPoint, 1.0), UnitFilter((1 << c_targetFilterStructure), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L6949
UnitCount(null, c_playerAny, RegionCircle(lv_spawnPoint, 5.0), UnitFilter((1 << c_targetFilterHarvestableResource), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L6949
UnitCount("CelestialLock", c_playerAny, RegionCircle(lv_spawnPoint, 8.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L6949
UnitCount("DuelBubbleUnit", c_playerAny, RegionCircle(lv_spawnPoint, 15.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCount(null, c_playerAny, RegionCircle(lv_spawnPoint, 1.0), UnitFilter((1 << c_targetFilterStructure), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCount(null, c_playerAny, RegionCircle(lv_spawnPoint, 10.0), UnitFilter((1 << c_targetFilterHarvestableResource), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCount("CelestialLock", c_playerAny, RegionCircle(lv_spawnPoint, 8.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCount("WidowMineBurrowed", c_playerAny, RegionCircle(lv_spawnPoint, 8.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCount("SpiderMineBurrowed", c_playerAny, RegionCircle(lv_spawnPoint, 8.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)