AISSP v1.15

AmbientExplosions

Creates dynamic ambient explosions around defined object/unit(s). Explosions can be brought to scene by airplanes or artillery (distant sfx). You can easily define which units and/or areas are avoided from exploding.

How to use Ambient Explosions?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you may define parameters to customize the script.) 

                                            nul = [] execVM "LV\ambientExplosions.sqf";
Parameter Description Default
1: Center array (units / objects that are the center of explosions) [player]
2: Amount number (average explosions amount per minute) 10
3: Duration number (seconds, duration of Ambient Explosions) 30
4: Max distance number (meters, maximum distance from center object(s) where explosions occur) 600
5: Min Distance number (meters, maximum distance from center object(s) where explosions occur == safe radius) 100
6: Avoid players boolean (if true, explosions will avoid center units/objects (-> Min Distance)) true
7: Avoid AI boolean (if true, explosions will avoid all AI units (-> Min Distance)) false
8: Planes false | array (plane parameter array, or false if planes not needed) default: 
                                    [2,["ambientExplosionsPlanes"],1500,300,"random"]
1: Side 1 = west, 2 = east, 3 = resistance 2
2: Classname class Classes for planes. New example class "ambientExplosionsPlanes" added to LV/config_aissp.hpp ["ambientExplosionsPlanes"]
3: Distance Distance from which the planes comes from 1500
4: Altitude Flying altitude for the planes 300
5: Direction "random" | number (Direction from where the planes comes from) "random"
9: Artillery SFX boolean (true will cause distant artillery sfx 5 seconds before each explosion) false
10: MP boolean (true = Center will automatically be an array of all alive non-captive playableUnits) false
How to make Ambient Explosions to avoid certain areas and locations?

You can make markers where units wont be spawned and which they will try to avoid during their patrolling. This can be done with normal markers (RECTANGLE & ELLIPSE). Name the first one to ACavoid and just copy & paste it, so that next ones will have names like ACavoid_1, ACavoid_2, etc, up to ACavoid_30. These can also be created on the fly, and Ambient Explosions will notice them.

Militarize

Populates area with infantry units and/or vehicles and makes them patrol in defined area. Adds also possibility for infantry units to correctly close doors behind them and to use smokes when engaging battle.

How to use Militarize?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you may define parameters to customize the script.) 

                                            nul = [this] execVM "LV\militarize.sqf";
Parameter Description Default
1: Target Center point (object/unit/marker/position array, note: remember to use "quotes" with marker names) this
2: Side 0 / 1 / 2 / 3 (0 = civilian, 1 = blue, 2 = red, 3 = green) 2
3: Radius meters (from center point) 150
4: Spawn infantry [boolean, boolean] - spawn land units, spawn water units [true,false]
5: Spawn vehicles [boolean, boolean, boolean] - spawn land vehicles, spawn water vehicles, spawn air vehicles [true,false,false]
6: Still true / false (if false, units will patrol in radius, checking also buildings) false
7: Infantry ratio decimal / array (amount of spawning infantry = Radius * Infantry ratio) 0.3 
                                    0.2 = will spawn 50 units if radius is 250 (250 * 0.2 = 50)
                                    [10,12] = will spawn 10 units AND random 1-12 units
8: Vehicle ratio decimal / array (amount of spawning vehicles = Radius * Infantry ratio) 0.3 
                                    0.1 = will spawn 25 vehicles if radius is 250 (250 * 0.1 = 25)
                                    [3,2] = will spawn 3 vehicles AND random 1-2 vehicles
9: AI skills 0-1.0 or "default" or array of individual skill values (AIs skills) "default" 
                                    "default"				 leaves AI skills to default
                                    0.75					 makes all AI skill levels to 0.75 (75%)
                                    [0.75,0.8,0.9,1,1,1,1,1,0.9,1] 		 adjusts skill levels separately, as in:
                                    [aimingAccuracy, aimingShake, aimingSpeed, spotDistance, spotTime, courage, commanding, general, endurance, reloadSpeed]
10: Group nil / Group name (if you want units in existing group, set it here. if nil, new group is made) nil
11: Custom init If you want to add something in units init lines, add it here in "quotes". If you need to use quotes inside the init itself, use ' or "" instead of ", or use this parameter to init external script nil 
                                    "hint format['this is custom init from unit %1',this];"
                                    "hint 'Spawning!'; this setCaptive true;"
                                    "nul = [] execVM 'customScript.sqf';"
12: ID number (if you want to delete units this script creates, you'll need to set a unique ID number) nil
13: Smokes true / false (true will make AI to use smokes and chemlights when in action) true
14: Doors true / false (true will make AI close doors behind them while patrolling in buildings) true
15: Classes array (classes from config_aissp.hpp, defines which unit classnames are being used) ["ALL"]
How to remove units created by Militarize?

To remove Militarize units, you must make sure you have set the ID parameter when initializing Militarize. When you do that, the script forms an name for the Militarize group, which is basicly LVgroup + ID you defined. After that you simply initialize the following script anywhere you want, and for its only parameter set LVgroupID where ID id the ID you defined for this particular Militarize instance.

                                    nul = [LVgroupID] execVM "LV\LV_functions\LV_fnc_removeGroup.sqf";
FillHouse

Populates buildings in defined area with infantry units. You can also set units to patrol inside and outside of buildings.

How to use FillHouse?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you may define parameters to customize the script.) 

                                            nul = [this] execVM "LV\fillHouse.sqf";
Parameter Description Default
1: Target Center point (if called from a Game Logic, then simply this, and if called from trigger and targeting a Game Logic, then that particular Game Logics' name) this
2: Side 1 / 2 / 3 (1 = blue, 2 = red, 3 = green) 2
3: Patrol true / false (if true, units will patrol) true
4: Patrol type 1 / 2 (1 = only inside building, 2 = also outside of buildings) 2
5: Spawn percentage 1-100 OR Array (on how many percentage of possible positions are soldiers spawned) 50 
                                    50 = will spawn units into 50% of available building positions in defined radius
                                    [10,12] = will spawn at least 10 units + random 1-12 units
6: Radius 1 or larger number (1 = nearest building. if larger number, then all buildings in radius) 1
7: AI skills 0-1.0 or "default" or array of individual skill values (AIs skills) "default" 
                                    "default"				 leaves AI skills to default
                                    0.75					 makes all AI skill levels to 0.75 (75%)
                                    [0.75,0.8,0.9,1,1,1,1,1,0.9,1] 		 adjusts skill levels separately, as in:
                                    [aimingAccuracy, aimingShake, aimingSpeed, spotDistance, spotTime, courage, commanding, general, endurance, reloadSpeed]
8: Group nil / Group name (if you want units in existing group, set it here. if nil, new group is made) nil
9: Custom init If you want to add something in units init lines, add it here in "quotes". If you need to use quotes inside the init itself, use ' or "" instead of ", or use this parameter to init external script nil 
                                    "hint format['this is custom init from unit %1',this];"
                                    "hint 'Spawning!'; this setCaptive true;"
                                    "nul = [] execVM 'customScript.sqf';"
10: ID number (if you want to delete units this script creates, you'll need to set a unique ID number) nil
11: Classes array (classes from config_aissp.hpp, defines which unit classnames are being used) ["ALL"]
How to remove units created by FillHouse?

To remove FillHouse units, you must make sure you have set the ID parameter when initializing FillHouse. When you do that, the script forms an name for the FillHouse group, which is basicly LVgroup + ID you defined. After that you simply initialize the following script anywhere you want, and for its only parameter set LVgroupID where ID id the ID you defined for this particular FillHouse instance.

                                    nul = [LVgroupID] execVM "LV\LV_functions\LV_fnc_removeGroup.sqf";
ReinforcementChopper

Spawns a chopper which will transport a group of infantry to target location.

How to use ReinforcementChopper?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you may define parameters to customize the script.) 

                                            nul = [this] execVM "LV\reinforcementChopper.sqf";
Parameter Description Default
1: Spot Landing spot (object/unit/marker/position array, remember to use "quotes" with marker) this
2: Exact true / false (true = tries to land exactly on Spot, false = finds a nearby place where chopper fits) true
3: Side 1 / 2 / 3 (1 = blue, 2 = red, 3 = green) 1
4: Chopper type number (0 = random chopper, 1 = first element from available classname class [See AI Classnames for better understanding]) 0
5: Captive true / false (if true, enemies wont notice chopper before it has landed) false
6: Patrol true / false (if false, units wont patrol in any way = useful if you want to make this group to join a player by setting (group player) as Group parameter) true
7: Target (patrol target which infantry goes after) player 
                                    unit					= 	units name, ex: enemyunit1
                                    marker 					= 	markers' name, ex: "marker01" (remember quotes with markers!)
                                    marker array 				= 	array of markers in desired order, ex: ["marker01","marker02","marker03"]
                                    group					= 	groups name, ex: (group enemy1)	OR BlueGroup17
                                    group array				=	ex: [(group player), (group blue2)]
                                    ["PATROL",center position,radius] 	= 	uses patrol-vD.sqf, ex: ["PATROL",(getPos player),150]
                                            (units patrols in radius, also checking buildings)
8: Direction "random" or 0-360 (direction where chopper comes from, use quotes with "random"!) "random"
9: Distance meters (from how far the chopper comes from) 1500
10: Precise true / false (true = heli will land even in the middle of war, false = heli might have air fights etc before landing) true
11: Cycle true / false (if true and Target is an array of markers, units will cycle these markers) false
12: Group size 1-8 (infantry groups' size) 8
13: AI skills 0-1.0 or "default" or array of individual skill values (AIs skills) "default" 
                                    "default"				 leaves AI skills to default
                                    0.75					 makes all AI skill levels to 0.75 (75%)
                                    [0.75,0.8,0.9,1,1,1,1,1,0.9,1] 		 adjusts skill levels separately, as in:
                                    [aimingAccuracy, aimingShake, aimingSpeed, spotDistance, spotTime, courage, commanding, general, endurance, reloadSpeed]
14: Smoke [LZ smoke, cover smokes, flares, chemlights] (should chopper use these on landing zone) [false,false,false,false]
15: Group nil / Group name (if you want units in existing group, set it here. if nil, new group is made) nil
16: Custom init If you want to add something in units init lines, add it here in "quotes". If you need to use quotes inside the init itself, use ' or "" instead of ", or use this parameter to init external script nil 
                                    "hint format['this is custom init from unit %1',this];"
                                    "hint 'Spawning!'; this setCaptive true;"
                                    "nul = [] execVM 'customScript.sqf';"
17: ID number (if you want to delete units this script creates, you'll need to set a unique ID number) nil
18: MP true / false (true = Landing spot will automatically be one from an array of all alive non-captive playableUnits) false
19: Doors true / false (true will make AI close doors behind them if patrolling in buildings) true
20: Classes array (classes from config_aissp.hpp, defines which unit classnames are being used) ["ALL"]
Additional stuff

If you set Patrol to false, units will idle (if not joined to another group), and then you can extend the script and make them to do some custom stuff. (I commented the location in script, line ~347)

LV_fnc_follow.sqf has been changed a lot, and there's also things you can customize pretty easily. If you target inf group to go after another group or array of groups, there's maximum distance for them to action. (Gives more mission options for MP)
Max distance is defined in reinforcementChopper.sqf on lines ~326 and ~341 (mDis = 1000m as default), and if inf group is that far away from its target group (or target group -array), it will stay idling, and those idling positions are commented in LV_fnc_follow.sqf on lines ~73 and ~103. There you can add custom stuff.

HeliParadrop

Spawns a chopper which will deliver a paradrop group to stage.

How to use HeliParadrop?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you may define parameters to customize the script.) 

                                            nul = [this] execVM "LV\heliParadrop.sqf";
Parameter Description Default
1: Spot Drop spot (object/unit/marker/position array, remember to use "quotes" with marker) this
2: Side 1 / 2 / 3 (1 = blue, 2 = red, 3 = green) 2
3: Allow damage true / false (allow damage for the chopper) true
4: Captive true / false (if true, enemies wont notice chopper) false
5: Distance meters (from how far the chopper comes from) 1500
6: Direction "random" or 0-360 (direction where chopper comes from, use quotes with "random"!) "random"
7: Flyby true / false (true = chopper just flies through target, false = stays still while dropping units) true
8: Flight altitude number (how high the chopper flies) 200
9: Jump distance number (how many meters before the target location units starts jumping out from the heli) 150
10: Group size 1-8 (infantry groups' size) 8
11: Jump delay number (how many seconds is the delay between each units jump) 0.5
12: Parachute altitude number (in which altitude units will open their parachutes) 50
13: Smokes true / false (will units throw cover smokes, at around 10m height) false
14: Flares true / false (will units throw flares, at around 30m height) false
15: Chems true / false (will units throw chemlights, at around 30m height) false
16: Patrol true / false (if false, units wont patrol in any way = useful if you want to make this group to join a player by setting (group player) as Group parameter) true
17: Target (patrol target which infantry goes after) player 
                                    unit					= 	units name, ex: enemyunit1
                                    marker 					= 	markers' name, ex: "marker01" (remember quotes with markers!)
                                    marker array 				= 	array of markers in desired order, ex: ["marker01","marker02","marker03"]
                                    group					= 	groups name, ex: (group enemy1)	OR BlueGroup17
                                    group array				=	ex: [(group player), (group blue2)]
                                    ["PATROL",center position,radius] 	= 	uses patrol-vD.sqf, ex: ["PATROL",(getPos player),150]
                                            (units patrols in radius, also checking buildings)
18: Cycle true / false (if true and Target is an array of markers, units will cycle these markers) false
19: AI skills 0-1.0 or "default" or array of individual skill values (AIs skills) "default" 
                                    "default"				 leaves AI skills to default
                                    0.75					 makes all AI skill levels to 0.75 (75%)
                                    [0.75,0.8,0.9,1,1,1,1,1,0.9,1] 		 adjusts skill levels separately, as in:
                                    [aimingAccuracy, aimingShake, aimingSpeed, spotDistance, spotTime, courage, commanding, general, endurance, reloadSpeed]
20: Group nil / Group name (if you want units in existing group, set it here. if nil, new group is made) nil
21: Custom init If you want to add something in units init lines, add it here in "quotes". If you need to use quotes inside the init itself, use ' or "" instead of ", or use this parameter to init external script nil 
                                    "hint format['this is custom init from unit %1',this];"
                                    "hint 'Spawning!'; this setCaptive true;"
                                    "nul = [] execVM 'customScript.sqf';"
22: ID number (if you want to delete units this script creates, you'll need to set a unique ID number) nil
23: MP true / false (true = Landing spot will automatically be one from an array of all alive non-captive playableUnits) false
24: Doors true / false (true will make AI close doors behind them if patrolling in buildings) false
25: Classes array (classes from config_aissp.hpp, defines which unit classnames are being used) ["ALL"]
SimpleCache (for FillHouse & Militarize)

Makes FillHouse & Militarize -units to spawn when player is near, and to despawn when player is further away.

How to use SimpleCache?

This script can be initialized from any object, unit, or trigger. Default init line is:
(Between [ and ] you must define parameters for the script.) 

                                            nul = [] execVM "LV\LV_functions\LV_fnc_simpleCache.sqf";
Parameter Description
1: ID's array of FillHouse and/or Militarize script ID's (NOTE: Remember to set unique ID parameters when initializing FillHouse/Militarize)
2: Players array of players (doesnt matter what you set here if you use MP parameter)
3: Distance distance between player(s) and Militarize/FillHouse spots where units will be spawned/despawned
4: Keep count true / false (true = script will count & save exact AI amounts, false = AI amount will be reseted on each time units are spawned again)
5: MP true / false (true = all alive non-captive playableUnits will activate the script, false = only units in players-array)
Additional stuff

You can find _excludeSingleHeliPilot in the script file. (true = if single player flies over area as pilot, area wont trigger (reduces possible lag spikes))

SimpleCacheV2 (for FillHouse & Militarize)

Makes FillHouse & Militarize -units to spawn when player is near, and to despawn when player is further away. This V2 version also handles the actual initialization of FillHouse and Militarize. This makes it easier for you; just place Game Logics/Markers/etc to map, name them, and use SimpleCacheV2 setup tool to generate a simple script snippet that does all the work for you.

How to use SimpleCacheV2?

This script can be initialized from any object, unit, or trigger. For actual missions the preferred method is to use for example init.sqf in your mission root and initialize this script there.

                                            nul = [] execVM "LV\LV_functions\LV_fnc_simpleCacheV2.sqf";
Parameter Description
1: Scripts array of FillHouse / Militarize script arrays, which consists of:
1: Type (number) 1 = Militarize, 2 = FillHouse
2: Script params (array) Either FillHouse or Militarize parameters, depending on which Type was defined
NOTE: You must set ID parameter in every instance of FillHouse / Militarize and it must be unique.
2: Players array of players (doesnt matter what you set here if you use MP parameter)
3: Distance distance between player(s) and Militarize/FillHouse spots where units will be spawned/despawned
4: Keep count true / false (true = script will count & save exact AI amounts, false = AI amount will be reseted on each time units are spawned again)
5: MP true / false (true = all alive non-captive playableUnits will activate the script, false = only units in players-array)
Simple example:

To make it look more clear, we define the first parameter, which contains the initializations for Militarize and FillHouse, separately. Its first subarray is for Militarize:

[1, [p1, 2, 150, [true, false], [true, false, false], false, [20, 20], [1, 2], "default", nil, nil, 1, true, true, ["ALL"]]],

  - 1 = Militarize
  - Normal parameters for Militarize
  - Target location, in this case a Game Logic. When using markers, remember to use quotes with "markerName" here.


© Ruina