# Units In Unit Group For Player

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

Returns a unit group by extracting units from a unit group belonging to the specified player.

# Arguments

• unitgroup — Group
• int — Player
• int — Count

Returns — unitgroup

native unitgroup UnitGroupFilterPlayer(
	unitgroup g,
	int player,
	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/liberty.sc2campaign

— MapScript.galaxy

// L1758
UnitGroupFilterPlayer(gv_infestedStructureGroup, gv_pLAYER_03_INFESTED_REFUGEES, (gv_infestedTerranQty + gv_infestedMarineQty))

// L11444
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L12743
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L12761
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L2950
UnitGroupFilterPlayer(gv_dominionCompoundCivilian, gv_p3_RIKSVILLE_YELLOW, 0)

// L5931
UnitGroupFilterPlayer(gv_escapeCivilians, gv_p3_RIKSVILLE_YELLOW, 0)

// L388
UnitGroupFilterPlayer(lv_dropGroup, lp_who, 0)

// L1758
UnitGroupFilterPlayer(gv_infestedStructureGroup, gv_pLAYER_03_INFESTED_REFUGEES, (gv_infestedTerranQty + gv_infestedMarineQty))

// L11444
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L12743
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L12761
UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0)

// L2950
UnitGroupFilterPlayer(gv_dominionCompoundCivilian, gv_p3_RIKSVILLE_YELLOW, 0)

// L5931
UnitGroupFilterPlayer(gv_escapeCivilians, gv_p3_RIKSVILLE_YELLOW, 0)

// L388
UnitGroupFilterPlayer(lv_dropGroup, lp_who, 0)

// L7062
UnitGroupFilterPlayer(gv_cinematicTempUnits, 1, 0)

// L2950
UnitGroupFilterPlayer(gv__1LockedDoorWave, gv_p02_DOMINION, 0)

// L8591
UnitGroupFilterPlayer(lv_stage1Units, gv_p01_USER, 0)

// L7062
UnitGroupFilterPlayer(gv_cinematicTempUnits, 1, 0)

// L2950
UnitGroupFilterPlayer(gv__1LockedDoorWave, gv_p02_DOMINION, 0)

// L8591
UnitGroupFilterPlayer(lv_stage1Units, gv_p01_USER, 0)

// L1037
UnitGroupFilterPlayer(lv_warpedUnits, gv_pLAYER_01_USER, 0)

// L8283
UnitGroupFilterPlayer(gv_midCineFlyingStructures, gv_pLAYER_02_DOMINION8, 0)

// L8325
UnitGroupFilterPlayer(gv_midCineFlyingStructures, gv_pLAYER_02_DOMINION8, 0)

// L1037
UnitGroupFilterPlayer(lv_warpedUnits, gv_pLAYER_01_USER, 0)

// L8283
UnitGroupFilterPlayer(gv_midCineFlyingStructures, gv_pLAYER_02_DOMINION8, 0)

// L8325
UnitGroupFilterPlayer(gv_midCineFlyingStructures, gv_pLAYER_02_DOMINION8, 0)

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

— LibPEB1.galaxy

// L5796
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L6027
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L8139
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L8729
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L8733
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L10700
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

// L10901
UnitGroupFilterPlayer(libPEB1_gv_activeZergMinions, libCore_gv_cOMPUTER_TeamChaos, 0)

# mods/heroesdata.stormmod

— SupportLib.galaxy

// L2743
UnitGroupFilterPlayer(libGame_gv_players[EventPlayer()].lv_heroUnitGroup, EventPlayer(), 0)

# mods/starcoop/starcoop.sc2mod

— LibCOMI.galaxy

// L1709
UnitGroupFilterPlayer(lv_dropGroupTerran, lv_attackPlayerIter, 0)

// L1723
UnitGroupFilterPlayer(lv_dropGroupZerg, lv_attackPlayerIter, 0)

// L2105
UnitGroupFilterPlayer(lv_attackForce, lv_playerIter, 0)

// L2311
UnitGroupFilterPlayer(lp_attackForce, lv_playerIter, 0)

# mods/warcoop/warmeleeai.sc2mod

— MeleeWaveAI.galaxy

// L32
UnitGroupFilterPlayer(ug,GAw3_AICreepPlayer,c_noMaxCount)