# Add Unit Group To Attack Wave
Grammar — Add unitGroup to the next attack wave for player player
Flags —Native
|Action
Adds a unit group to the next attack wave for a player.
# Arguments
int
— Playerunitgroup
— UnitGroup
Returns — void
native void AIAttackWaveUseGroup(int player, unitgroup ug);
# Related
Category: AI / AttackWaves / Actions
- [F] —
void
— Add Unit To Attack Wave — ( AIAttackWaveUseUnit ) - [F] —
void
— Add Unit Group To Attack Wave — ( AIAttackWaveUseGroup ) - [F] —
void
— Add Escort Unit To Attack Wave — ( AIAttackWaveAddEscortUnit ) - [F] —
void
— Add Escort UnitType To Attack Wave — ( AIAttackWaveAddEscortType ) - [F] —
void
— Add Attack Wave Waypoint — ( AIAttackWaveAddWaypoint ) - [F] —
void
— Send Attack Wave — ( AIAttackWaveSend ) - [F] —
void
— Cancel Attack Wave — ( AIAttackWaveCancel ) - [F] —
void
— Set Attack Wave Gather Point — ( AIAttackWaveSetGatherPoint ) - [F] —
void
— Set Target Player For Attack Waves — ( AIAttackWaveSetTargetPlayer ) - [F] —
void
— Set Target Unit For Attack Waves — ( AIAttackWaveSetTargetUnit ) - [F] —
void
— Set Target UnitGroup For Attack Waves — ( AIAttackWaveSetTargetUnitGroup ) - [F] —
void
— Set Target UnitArea For Attack Waves — ( AIAttackWaveSetTargetUnitPoint ) - [F] —
void
— Set Target Point For Attack Waves — ( AIAttackWaveSetTargetPoint ) - [F] —
void
— Set Target Merge For Attack Waves — ( AIAttackWaveSetTargetMerge ) - [F] —
void
— Set Target Patrol For Attack Waves — ( AIAttackWaveSetTargetPatrol ) - [F] —
void
— Set Target Escort For Attack Waves — ( AIAttackWaveSetTargetEscort ) - [F] —
void
— Set Target Escort For Attack Waves, No Leashing — ( AIAttackWaveSetTargetEscortNL ) - [F] —
void
— Set Target Gather Defense For Attack Waves — ( AIAttackWaveSetTargetGatherD ) - [F] —
void
— Set Target Gather Offense For Attack Waves — ( AIAttackWaveSetTargetGatherO ) - [F] —
void
— Set Target Melee For Attack Waves — ( AIAttackWaveSetTargetMelee ) - [F] —
void
— Set Target Melee Harass For Attack Waves — ( AIAttackWaveSetTargetMeleeHarass ) - [F] —
void
— Set Target Region For Attack/Defense Waves — ( AIAttackWaveSetTargetRegion ) - [F] —
void
— Add Attack Wave Unit Types (Liberty) — ( AIAttackWaveAddUnits4 ) - [F] —
void
— Add Attack Wave Unit Types (Swarm) — ( AIAttackWaveAddUnits3 ) - [F] —
void
— Set Attack Wave Keep Alive — ( AIAttackWaveSetKeepAlive ) - [F] —
void
— Set Attack Wave Gather Early No Replace — ( AIAttackWaveSetGatherEarlyNoReplace )
# Examples
# campaigns/liberty.sc2campaign
// L1057
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1077
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1097
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1226
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1252
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1254
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersD)
// L1277
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1412
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1433
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1459
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L723
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L728
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L730
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L735
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L739
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L741
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L746
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L748
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L750
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L755
AIAttackWaveUseGroup(gv_pLAYER_ENEMY, UnitLastCreatedGroup())
// L563
AIAttackWaveUseGroup(gv_p2_ENEMY_ZERG, UnitLastCreatedGroup())
// L567
AIAttackWaveUseGroup(gv_p2_ENEMY_ZERG, UnitLastCreatedGroup())
// L571
AIAttackWaveUseGroup(gv_p2_ENEMY_ZERG, UnitLastCreatedGroup())
// L575
AIAttackWaveUseGroup(gv_p2_ENEMY_ZERG, UnitLastCreatedGroup())
// L579
AIAttackWaveUseGroup(gv_p2_ENEMY_ZERG, UnitLastCreatedGroup())
// L1007
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1028
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1048
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1175
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1195
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1215
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1346
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1367
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1387
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1075
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1095
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1115
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1245
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1265
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1285
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L1418
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersA)
// L1437
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersB)
// L1456
AIAttackWaveUseGroup(gv_pLAYER_COMPUTER1, gv_enemyAttackersC)
// L405
AIAttackWaveUseGroup(gv_currentWaveAttacker, gv_currentWaveUnits)
// L2655
AIAttackWaveUseGroup(gv_pLAYER_02_DOMINION, gv_hellions)
// L1610
AIAttackWaveUseGroup(gv_p6_FIRST_PROTOSS, gv_initialStalkers)
// L2370
AIAttackWaveUseGroup(gv_p2_ZERG, lv_dropPodGroup)
// L2660
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2673
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2686
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2840
AIAttackWaveUseGroup(gv_p2_ZERG, gv_zergSpeedBumpUnits)
// L2896
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2909
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L3323
AIAttackWaveUseGroup(gv_p2_ZERG, lv_unitgroup)
// L1186
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1211
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(14), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1236
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(15), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1262
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(16), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1288
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(17), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1326
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1366
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(16), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1407
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(17), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1450
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(15), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1490
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(14), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L4997
AIAttackWaveUseGroup(gv_p10_ZERG_WHITEHIVE, lv_waveUnits)
// L491
AIAttackWaveUseGroup(gv_nextWavePlayer, gv_nextWaveUnits)
// L275
AIAttackWaveUseGroup(lp_player, UnitLastCreatedGroup())
// L2072
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2074
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2076
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2082
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2084
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2086
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2088
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2094
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2096
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L2098
AIAttackWaveUseGroup(lv_thisAIPlayer, UnitLastCreatedGroup())
// L405
AIAttackWaveUseGroup(gv_currentWaveAttacker, gv_currentWaveUnits)
// L2655
AIAttackWaveUseGroup(gv_pLAYER_02_DOMINION, gv_hellions)
// L1610
AIAttackWaveUseGroup(gv_p6_FIRST_PROTOSS, gv_initialStalkers)
// L2370
AIAttackWaveUseGroup(gv_p2_ZERG, lv_dropPodGroup)
// L2660
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2673
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2686
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2840
AIAttackWaveUseGroup(gv_p2_ZERG, gv_zergSpeedBumpUnits)
// L2896
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L2909
AIAttackWaveUseGroup(gv_p2_ZERG, lv_extraUnits)
// L3323
AIAttackWaveUseGroup(gv_p2_ZERG, lv_unitgroup)
// L1186
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1211
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(14), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1236
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(15), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1262
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(16), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1288
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(17), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1326
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(13), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1366
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(16), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1407
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(17), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1450
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(15), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L1490
AIAttackWaveUseGroup(gv_pLAYER_02_ScriptedTOSS, UnitGroup(null, gv_pLAYER_02_ScriptedTOSS, RegionFromId(14), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0))
// L4997
AIAttackWaveUseGroup(gv_p10_ZERG_WHITEHIVE, lv_waveUnits)
// L491
AIAttackWaveUseGroup(gv_nextWavePlayer, gv_nextWaveUnits)