# Unit Count In Region With Alliance To Player

Grammar — Count of units in reg having alliance alliance with player player matching unitFilter, with at most count
Flags — Native | Function

Returns a count of units within the alliance filter specified.

# Arguments

• int — Player
• int [ preset::UnitAlliance ] — Alliance
• region — Region
• unitfilter — Unit Filter
• int — Count

Returns — int

native int UnitCountAlliance(
	int player,
	int alliance,
	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

// L766
UnitCountAlliance(UnitGetOwner(lp_warpPrism), c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lp_warpPrism), 15.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

// L804
UnitCountAlliance(UnitGetOwner(lp_overseer), c_unitAllianceAlly, RegionCircle(UnitGetPosition(lp_overseer), 15.0), UnitFilter(0, 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32)) | (1 << (c_targetFilterHasEnergy - 32))), 0)

// L3266
UnitCountAlliance(gv_pLAYER_03_TAL_EAST, c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lv_warpPrism), 9.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

// L3425
UnitCountAlliance(gv_pLAYER_03_TAL_EAST, c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lv_warpPrism), 9.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

// L766
UnitCountAlliance(UnitGetOwner(lp_warpPrism), c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lp_warpPrism), 15.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

// L804
UnitCountAlliance(UnitGetOwner(lp_overseer), c_unitAllianceAlly, RegionCircle(UnitGetPosition(lp_overseer), 15.0), UnitFilter(0, 0, (1 << c_targetFilterStructure) | (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32)) | (1 << (c_targetFilterHasEnergy - 32))), 0)

// L3266
UnitCountAlliance(gv_pLAYER_03_TAL_EAST, c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lv_warpPrism), 9.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

// L3425
UnitCountAlliance(gv_pLAYER_03_TAL_EAST, c_unitAllianceEnemy, RegionCircle(UnitGetPosition(lv_warpPrism), 9.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterInvulnerable - 32))), 1)

# mods/starcoop/starcoop.sc2mod

— LibCOMU.galaxy

// L3164
UnitCountAlliance(1, c_unitAllianceAlly, RegionEntireMap(), UnitFilter((1 << c_targetFilterAir), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L4234
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lv_riftLocation, 10.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L4641
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lp_spawnPoint, 7.0), UnitFilter((1 << c_targetFilterStructure), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L6949
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lv_spawnPoint, 25.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L7167
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lv_spawnPoint, 25.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L10863
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lv_spawnPoint, 25.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L10933
UnitCountAlliance(1, c_unitAllianceEnemy, RegionCircle(lv_spawnPoint, 25.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L11312
UnitCountAlliance(3, c_unitAllianceEnemy, RegionCircle(lv_spawnLocation, 50.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L11495
UnitCountAlliance(3, c_unitAllianceEnemy, RegionCircle(lv_spawnLocation, 1.0), UnitFilter((1 << c_targetFilterStructure), 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)

// L11495
UnitCountAlliance(3, c_unitAllianceEnemy, RegionCircle(lv_spawnLocation, 35.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0)