# Add Unit Group To Attack Wave

Grammar — Add unitGroup to the next attack wave for player player
FlagsNative | Action

Adds a unit group to the next attack wave for a player.

# Arguments

  • int — Player
  • unitgroup — UnitGroup

Returns — void

native void AIAttackWaveUseGroup(int player, unitgroup ug);

Category: AI / AttackWaves / Actions

# Examples

# campaigns/liberty.sc2campaign

MapScript.galaxy

// 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)