Scripts need help

[tuocs 10]

I'm new to scripting and I don't know how to use these scripts. I got these scripts using the BIS_fnc_help feature by creating a trigger with the following info in a trigger.

Condition: !isnil "bis_fnc_init" 
On Activation: [] call BIS_fnc_help;

Here's the first one.

scriptName "Functions\spawning\fn_spawnGroup.sqf";
/*
File: spawnGroup.sqf
Author: Joris-Jan van 't Land

Description:
Function which handles the spawning of a dynamic group of characters.
The composition of the group can be passed to the function.
Alternatively a number can be passed and the function will spawn that
amount of characters with a random type.

Parameter(s):
_this select 0: the group's starting position (Array)
_this select 1: the group's side (Side)
_this select 2: can be three different types:
	- list of character types (Array)
	- amount of characters (Number)
	- CfgGroups entry (Config)
_this select 3: (optional) list of relative positions (Array)
_this select 4: (optional) list of ranks (Array)
_this select 5: (optional) skill range (Array)
_this select 6: (optional) ammunition count range (Array)
_this select 7: (optional) randomization controls (Array)
	0: amount of mandatory units (Number)
	1: spawn chance for the remaining units (Number)
_this select 8: (optional) azimuth (Number)

Returns:
The group (Group)
*/

//Validate parameter count
if ((count _this) < 3) exitWith {debugLog "Log: [spawnGroup] Function requires at leat 3 parameters!"; grpNull};

private ["_pos", "_side"];
_pos = _this select 0;
_side = _this select 1;

private ["_chars", "_charsType", "_types"];
_chars = _this select 2;
_charsType = typeName _chars;
if (_charsType == (typeName [])) then
{
_types = _chars;
}
else
{
if (_charsType == (typeName 0)) then 
{
	//Only a count was given, so ask this function for a good composition.
	_types = [_side, _chars] call BIS_fnc_returnGroupComposition;
} 
else 
{
	if (_charsType == (typeName configFile)) then 
	{
		_types = [];
	};
};
};

private ["_positions"];
if ((count _this) > 3) then 
{
_positions = _this select 3;
} 
else 
{
_positions = [];
};

private ["_ranks"];
if ((count _this) > 4) then 
{
_ranks = _this select 4;
} 
else 
{
_ranks = [];
};

private ["_skillRange"];
if ((count _this) > 5) then 
{
_skillRange = _this select 5;	
} 
else 
{
_skillRange = [];	
};

private ["_ammoRange"];
if ((count _this) > 6) then 
{
_ammoRange = _this select 6;	
} 
else 
{
_ammoRange = [];
};

private ["_randomControls"];
if ((count _this) > 7) then 
{
_randomControls = _this select 7;	
} 
else 
{
_randomControls = [-1, 1];
};

//Fetch the random controls.
private ["_minUnits", "_chance"];
_minUnits = _randomControls select 0;
_chance = _randomControls select 1;

private ["_azimuth"];
if ((count _this) > 8) then 
{
_azimuth = _this select 8;	
} 
else 
{
_azimuth = 0;
};

//Check parameter validity.
//TODO: Check for valid skill and ammo ranges?
if ((typeName _pos) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] Position (0) should be an Array!"; grpNull};
if ((count _pos) < 2) exitWith {debugLog "Log: [spawnGroup] Position (0) should contain at least 2 elements!"; grpNull};
if ((typeName _side) != (typeName sideEnemy)) exitWith {debugLog "Log: [spawnGroup] Side (1) should be of type Side!"; grpNull};
if ((typeName _positions) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] List of relative positions (3) should be an Array!"; grpNull};
if ((typeName _ranks) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] List of ranks (4) should be an Array!"; grpNull};
if ((typeName _skillRange) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] Skill range (5) should be an Array!"; grpNull};
if ((typeName _ammoRange) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] Ammo range (6) should be an Array!"; grpNull};
if ((typeName _randomControls) != (typeName [])) exitWith {debugLog "Log: [spawnGroup] Random controls (7) should be an Array!"; grpNull};
if ((typeName _minUnits) != (typeName 0)) exitWith {debugLog "Log: [spawnGroup] Mandatory units (7 select 0) should be a Number!"; grpNull};
if ((typeName _chance) != (typeName 0)) exitWith {debugLog "Log: [spawnGroup] Spawn chance (7 select 1) should be a Number!"; grpNull};
if ((typeName _azimuth) != (typeName 0)) exitWith {debugLog "Log: [spawnGroup] Azimuth (8) should be a Number!"; grpNull};
if ((_minUnits != -1) && (_minUnits < 1)) exitWith {debugLog "Log: [spawnGroup] Mandatory units (7 select 0) should be at least 1!"; grpNull};
if ((_chance < 0) || (_chance > 1)) exitWith {debugLog "Log: [spawnGroup] Spawn chance (7 select 1) should be between 0 and 1!"; grpNull};
if (((count _positions) > 0) && ((count _types) != (count _positions))) exitWith {debugLog "Log: [spawnGroup] List of positions (3) should contain an equal amount of elements to the list of types (2)!"; grpNull};
if (((count _ranks) > 0) && ((count _types) != (count _ranks))) exitWith {debugLog "Log: [spawnGroup] List of ranks (4) should contain an equal amount of elements to the list of types (2)!"; grpNull};

//Convert a CfgGroups entry to types, positions and ranks.
if (_charsType == (typeName configFile)) then 
{
_ranks = [];
_positions = [];

for "_i" from 0 to ((count _chars) - 1) do 
{
	private ["_item"];
	_item = _chars select _i;

	if (isClass _item) then 
	{
		_types = _types + [getText(_item >> "vehicle")];
		_ranks = _ranks + [getText(_item >> "rank")];
		_positions = _positions + [getArray(_item >> "position")];
	};
};
};

private ["_grp"];
_grp = createGroup _side;

//Create the units according to the selected types.
for "_i" from 0 to ((count _types) - 1) do
{
//See if this unit should be skipped.
private ["_skip"];
_skip = false;
if (_minUnits != -1) then 
{
	//Has the mandatory minimum been reached?
	if (_i > (_minUnits - 1)) then 
	{
		//Has the spawn chance been satisfied?
		if ((random 1) > _chance) then {_skip = true};
	};
};

if (!_skip) then 
{
	private ["_unit", "_type"];
	_type = _types select _i;

	//If given, use relative position.
	private ["_itemPos"];
	if ((count _positions) > 0) then 
	{
		private ["_relPos"];
		_relPos = _positions select _i;
		_itemPos = [(_pos select 0) + (_relPos select 0), (_pos select 1) + (_relPos select 1)];
	} 
	else 
	{
		_itemPos = _pos;
	};

	//Is this a character or vehicle?	
	if (getNumber(configFile >> "CfgVehicles" >> _type >> "isMan") == 1) then 
	{	
		_unit = _grp createUnit [_type, _itemPos, [], 0, "FORM"];
		_unit setDir _azimuth;
	} 
	else 
	{
		_unit = ([_itemPos, _azimuth, _type, _grp] call BIS_fnc_spawnVehicle) select 0;
	};

	//If given, set the unit's rank.
	if ((count _ranks) > 0) then 
	{
		_unit setRank (_ranks select _i);
	};

	//If a range was given, set a random skill.
	if ((count _skillRange) > 0) then 
	{
		private ["_minSkill", "_maxSkill", "_diff"];
		_minSkill = _skillRange select 0;
		_maxSkill = _skillRange select 1;
		_diff = _maxSkill - _minSkill;

		_unit setUnitAbility (_minSkill + (random _diff));	
	};

	//If a range was given, set a random ammo count.
	if ((count _ammoRange) > 0) then 
	{
		private ["_minAmmo", "_maxAmmo", "_diff"];
		_minAmmo = _ammoRange select 0;
		_maxAmmo = _ammoRange select 1;
		_diff = _maxAmmo - _minAmmo;

		_unit setVehicleAmmo (_minAmmo + (random _diff));	
	};
};
};

private ["_units"];
_units = units _grp;

if ((count _ranks) == 0) then 
{
//If no ranks were given, make the first unit the leader.
_grp selectLeader (_units select 0);
} 
else 
{
//Make the highest-ranking member leader.
private ["_bestCandidate"];
_bestCandidate = _units select 0;

{
	if ((rankId _x) > (rankId _bestCandidate)) then 
	{
		_bestCandidate = _x;
	};
} 
forEach _units;

_grp selectLeader _bestCandidate;
};

_grp

Here's the second one.

scriptName "Functions\spawning\fn_taskPatrol.sqf";
/*
File: taskPatrol.sqf
Author: Joris-Jan van 't Land

Description:
Create a random patrol of several waypoints around a given position.

Parameter(s):
_this select 0: the group to which to assign the waypoints (Group)
_this select 1: the position on which to base the patrol (Array)
_this select 2: the maximum distance between waypoints (Number)
_this select 3: (optional) blacklist of areas (Array)

Returns:
Boolean - success flag
*/

//Validate parameter count
if ((count _this) < 3) exitWith {debugLog "Log: [taskPatrol] Function requires at least 3 parameters!"; false};

private ["_grp", "_pos", "_maxDist", "_blacklist"];
_grp = _this select 0;
_pos = _this select 1;
_maxDist = _this select 2;

_blacklist = [];
if ((count _this) > 3) then {_blacklist = _this select 3};

//Validate parameters
if ((typeName _grp) != (typeName grpNull)) exitWith {debugLog "Log: [taskPatrol] Group (0) must be a Group!"; false};
if ((typeName _pos) != (typeName [])) exitWith {debugLog "Log: [taskPatrol] Position (1) must be an Array!"; false};
if ((typeName _maxDist) != (typeName 0)) exitWith {debugLog "Log: [taskPatrol] Maximum distance (2) must be a Number!"; false};
if ((typeName _blacklist) != (typeName [])) exitWith {debugLog "Log: [taskPatrol] Blacklist (3) must be an Array!"; false};

_grp setBehaviour "SAFE";

//Create a string of randomly placed waypoints.
private ["_prevPos"];
_prevPos = _pos;
for "_i" from 0 to (2 + (floor (random 3))) do
{
private ["_wp", "_newPos"];
_newPos = [_prevPos, 50, _maxDist, 1, 0, 60 * (pi / 180), 0, _blacklist] call BIS_fnc_findSafePos;
_prevPos = _newPos;

_wp = _grp addWaypoint [_newPos, 0];
_wp setWaypointType "MOVE";
_wp setWaypointCompletionRadius 20;

//Set the group's speed and formation at the first waypoint.
if (_i == 0) then
{
	_wp setWaypointSpeed "LIMITED";
	_wp setWaypointFormation "STAG COLUMN";
};
};

//Cycle back to the first position.
private ["_wp"];
_wp = _grp addWaypoint [_pos, 0];
_wp setWaypointType "CYCLE";
_wp setWaypointCompletionRadius 20;

true

I'm want to create groups via trigger in different locations. Some patroling, others defending.

Edited May 7, 2010 by tuocs