Code: Select all

if uf_killUnits ~= nil then
    uf_killUnits( {1,2}, true )  --{1,2} are the teams and true means only kill AI (false means also kill humans
else
    print("WARNING: uf_killUnit() not found so likely v1.3 not installed.  ")
end

Code: Select all

--
---- Description ----
-- Applies the given function to all the units of the given teams
--
---- Parameters ----
--cont      - the continuation function to call.  Should take 3 parameters: unit, property, value
--property  - value to be passed on to the given cont function
--value     - value to be passed on to the given cont function
--teams     - a table of numbers which represent team numbers 
--aiOrHuman - "ai" to only process AI bots, "human" to only process human players, nil to process both bots and humans
--
---- Returns ----
-- (nothing)
--
function uf_applyFunctionOnTeamUnits( cont, property, value, teams, aiOrHuman )
	if cont == nil then return end	--if have nothing to do, then do nothing

	--the teams whos units will have the given function applied to them
	local teams = teams or {1, 2}

	--for each team,
	local team
	for team = 1, table.getn(teams) do

		--get the team's size
	    local size = GetTeamSize( teams[team] )

	    --for each team member,
	    local m
	    for m = 0, size-1 do

	        --get a team member's unit
	        local player = GetTeamMember(teams[team], m)
	        local type = IsCharacterHuman(player)
			if (type and (aiOrHuman == "ai")) or ((not type) and (aiOrHuman == "human")) then
				--player is not the correct type
			else
				local unit = GetCharacterUnit(player)
				print( "uf_applyFunctionOnTeamUnits(): Team, Unit:", team, m ) 
	            cont(player, unit, property, value)
			end

		end
	end
end


--
---- Description ----
--  Kills the units on the given teams
--
---- Parameters ----
-- teams - a table of teams whose units should be killed
-- ai    - true to kill only AI units, false to kill only human units
--
---- Returns ----
-- (nothing)
--
function uf_killUnits( teams, ai )
	--check input
	if teams == nil then return end
	if ai == nil then return end

	--
	local miniFun = function( player, unit, property, ai, teams )
		if (player == nil) or (unit == nil) or (ai == nil) then return end	--check input

		--determine the player type (ai or human)
		--local isAi = true
		--if IsCharacterHuman(player) then
		--	isAi = false
		--end
		local isAi = not IsCharacterHuman(player)

		--if is the correct type, kill it
		if (isAi == ai) then
			KillObject( unit )
		end
	end

	uf_applyFunctionOnTeamUnits( miniFun, nil, ai, teams )
end