# Units In Unit Group With Alliance

Grammar — Units in group|Unit Group having alliance alliance with player, with at most count
Flags — Native | Function

Returns a unit group that contains units that have passed the specified ally filters from another unit group.

# Arguments

• unitgroup — Group
• int — Player
• int [ preset::UnitAlliance ] — Alliance
• int — Count

Returns — unitgroup

native unitgroup UnitGroupFilterAlliance(
	unitgroup g,
	int player,
	int alliance,
	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

# mods/heroesbrawlmods/arenamodemods/templearena.stormmod

— LibAMCT.galaxy

// L2212
UnitGroupFilterAlliance(lv_validTargets, UnitGetOwner(libAMCT_gv_aRMSkyTemple[lv_templeIndex].lv_beacon), c_unitAllianceAlly, 0)

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

— LibPEB1.galaxy

// L8139
UnitGroupFilterAlliance(libPEB1_gv_activeZergHeroes, libCore_gv_cOMPUTER_TeamChaos, c_unitAllianceAlly, 0)

// L8729
UnitGroupFilterAlliance(libPEB1_gv_activeZergHeroes, libCore_gv_cOMPUTER_TeamChaos, c_unitAllianceAlly, 0)

// L8733
UnitGroupFilterAlliance(libPEB1_gv_activeZergHeroes, libCore_gv_cOMPUTER_TeamChaos, c_unitAllianceAlly, 0)

// L10700
UnitGroupFilterAlliance(libPEB1_gv_activeZergHeroes, libCore_gv_cOMPUTER_TeamChaos, c_unitAllianceAlly, 0)

// L10901
UnitGroupFilterAlliance(libPEB1_gv_activeZergHeroes, libCore_gv_cOMPUTER_TeamChaos, c_unitAllianceAlly, 0)

# mods/heroesmapmods/battlegroundmapmods/skytemple.stormmod

— LibMLCP.galaxy

// L2711
UnitGroupFilterAlliance(lv_validTargets, UnitGetOwner(libMLCP_gv_mMSkyTemples[lv_templeIndex].lv_beacon), c_unitAllianceAlly, 0)

# mods/starcoop/starcoop.sc2mod

— LibCOMU.galaxy

// L1958
UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 0)

// L1996
UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 0)

// L2218
UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 0)

// L2285
UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 0)

# mods/warcoop/warclassicsystem.sc2mod

— WarClassicTactical.galaxy

// L437
UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 3)