Compilation of scripts used during multiplayer PVE/PVP mission on Arma 3. Also featuring defaults loadouts and missions as well as providing CBA settings in order to easily update the scripts to your convenience.
If you want to contribute to this project, see CONTRIBUTING.md.
Installation of all the scripts/zeus modules is done by copying the below files and folder directly into your mission folder where your "mission.sqm" file is located (ex: C:\Users<user_name>\Documents\Arma 3 - Other Profiles<profile_name>\missions\KheSanhMission01.vn_khe_sanh).
- functions (Folder)
- description.ext (File)
- init.sqf (File)
- initPlayerlocal.sqf (File)
- initServer.sqf (File)
- onPlayerRespawn.sqf (File)
- Default loadouts:
- Default missions:
- Cam_Lao_Nam: Includes borders between ARVN (South Vietnam), PAVN (North Vietnam), Khmer Republic, Laos and Cambodia.
- fox_pamai: Includes FOB from vn_the_bra and an Airfield in out of bound area.
- fox_vanam: Includes border between (South Vietnam) and Cambodia, Special Forces FOB and the Do Lung Bridge (same bridge as Apocalypse Now).
- vn_khe_sanh
- vn_the_bra
- Default addons for missions: defaultAddons.txt
- Default whitelist arsenal: defaultWhitelistArsenal.json
- A - COLSOG AI
- Set AI Skills: define sub-skills of AI.
- Toggle Trackers: manage Tracker module (behaviour, speed, presence).
- Un-Garrison (enable PATH): make a unit/group move out of building.
- A - COLSOG Env
- Fog Low
- Fog Ring
- Transition Time: transition with optional text to whenever in time.
- Vanilla Fog: manage fog.
- A - COLSOG Radio
- Init PF77s: add 3 new racks to vehicle (requires player to get in/exit vehicle before executing module on vehicle).
- NVA radio chatter: enables to make tape-recorder object produce vietnamese radio like voice (used to simulate wire taping).
- Toggle CAS: manage CAS asset available in the Radio Support module.
- A - COLSOG Vehicle
- Add STABO: add the ability to deploy a rope from a helicopter to allow player on the ground to get into the helicopter.
- Add Crew management: add the ability for the pilot of a helicopter to request AI crew members (door gunners).
- Conceal AA: conceal static gun with a shelter.
- A - COLSOG Punji Traps
- Fall Trap: create mace with punji sticks falling from a tree above trap wire.
- Swing Trap: create mace with punji sticks swinging from a tree towards the trap wire.
In the Addons configuration menu, you will have the ability to update the following values on the fly:
-
Vanilla medical items conversion to ace medical items
- Medikit
- field dressing: Integer
- saline IV 500: Integer
- epinephrine: Integer
- morphine: Integer
- tourniquet: Integer
- split: Integer
- First Aid:
- field dression: Integer
- morphine: Integer
- Medikit
-
AI skills
- enable: Boolean
- general: Float
- aiming accuracy: Float
- aiming speed: Float
- aiming shake: Float
- commanding: Float
- courage: Float
- spot distance: Float
- sport time: Float
- reload speed: Float
- seek cover: Boolean
- auto combat: Boolean
- suppression: Boolean
-
Tracker module
- enable: Boolean
- Tracker module name: String
- Default behaviour: ["Careless", "Safe", "Aware", "Combat"]
- Default combat: ["Never fire", "Hold fire", "Hold fire, engage at will", "Fire at will", "Fire at will, loose formation"]
- Default speed: ["Limited", "Normal", "Full"]
-
Support module
- enable artillery: Boolean
- enable helicopter: Boolean
- enable jets: Boolean
- enable arc light (B52): Boolean
- enable daisy cutter: Boolean
-
STABO
- Action duration in seconds: Integer
-
AI Throwable
- Throwable to Remove from AI: List<String> separated with , and no " required
-
Triangulation
- Required ACRE radio: String
- Items to detect: List<String> separated with , and no " required
- Cool down in seconds: Integer
- Requires ACRE spike 'vhf30108spike' nearby (10m away max): Boolean
- Threshold distance for signal strength 1/5: Integer
- Threshold distance for signal strength 2/5: Integer
- Threshold distance for signal strength 3/5: Integer
- Threshold distance for signal strength 4/5: Integer
- Threshold distance for signal strength 5/5: Integer
-
Punji Mace Traps
- Mace kill radius (m): Integer
- Enable screams: Boolean
- Side activating trap: ["BLUFOR", "OPFOR", "Independent", "Civilian", "Any player", "Any AI or player"]
-
Battery
- PRC77 Battery capacity in seconds: Integer
- Amount of radio calls before enemy detection: Integer
- Item used as spare battery: List<String> separated with , and no " required
- Groups impacted by enemy radio call detection: List<String> separated with , and no " required
1. Radio Support
Radio support from the Prairie Fire CDLC is available in a mission if all of the below points are true for a player: - Radio Support module is present in the mission - The player has the following radio (should only be the case for RTO if no Covey in a mission):"vn_b_pack_lw_06"
-
Or if the player is flying one of the aircraft in the list:
"JK_B_Cessna_T41_Armed_F", "vnx_b_air_ac119_01_01", "vn_b_air_ch34_03_01", "vn_b_air_ch34_03_01", "vn_b_air_ch34_04_01", "vn_b_air_ch34_04_02", "vn_b_air_oh6a_04" -
(IF unit_trait_required = 1 in description.ext) Player has the below code in its 'init' section
this setUnitTrait["vn_artillery", true, true]; -
All this can be modified in the vn_artillery_settings class in artillery.hpp
Here is how we emulate FOB with artillery support capabilities. By this we mean that the FOB can provide artillery support within a perimeter (it will be 3.5km in our example).
-
To do so, we use a public variable called 'SUPPORT_ENABLED' defined in initServer.sqf and it is used as the condition in artillery.hpp.
SUPPORT_ENABLED = true; // Used with the artillery support from Prairie Fire. By default condition on artillery strike will be true thanks to this public variable. publicVariable "SUPPORT_ENABLED"; -
then add a trigger that updates that variable (see example below).
- Condition:
this - On Activation:
SUPPORT_ENABLED = true; publicVariable "SUPPORT_ENABLED"; - On Deactivation:
SUPPORT_ENABLED = false; publicVariable "SUPPORT_ENABLED";
- Condition:
2. Punji mace traps
- **Johnnyboy** for original implementation of mace trap that my scripts are based on. - **Savage Game Design** for the objects and sound files used by this script. 1. Place a Whip Trap object in the editor. The direction you set the trap will be the direction the mace will swinging. 2. In the Whip Trap object's init field, put the following code:[[this, 'WEST'], "functions\traps\swinging\colsog_fn_createSwingingMaceTrap.sqf"] remoteExec ["execVM", 0, true];
or
[[this, _trapHeight, _treeType], "functions\traps\falling\colsog_fn_createFallingMaceTrap.sqf"] remoteExec ["execVM", 0, true];
- _trapHeight: Integer (default 0, will allow the height to be automatically managed depending on _treeType)
- _treeType: Integer
- 0: no tree.
- 1: "\vn\vn_vegetation_f_exp\tree\vn_t_ficus_big_f.p3d"
- 2: "\vn\vn_vegetation_f_exp\tree\vn_t_inocarpus_f.p3d"
- 3: "vn\vn_vegetation_f_exp\tree\vn_t_palaquium_f.p3d"
3. ACRE2
Babel configuration present in:Key to change languages: 'Right Alt'
We are using Babel to provide the following behaviour during our MACVSOG missions:
-
Have the MACVSOG team able to talk and understand each other (using English)
-
Have some members of the MACVSOG team that could speak and understand Vietnamese (be used as translator) by adding the below line in the 'init' section of the playable unit
this setVariable ["f_languages",["en", "vn"]]; -
Have the Zeus player speak Vietnamese when controlling an OPFOR unit. This makes the dialog between OPFOR and MACVSOG team possible only via the members speaking English and Vietnamese.
Here are the steps to follow if you want to add 3 news acre radio racks to a vehicle:
- Place a vehicle in the editor or during a mission
- During the mission a player/zeus must enter the plane once in order to initialize ACRE radios in the plane
- Use the zeus module implemented in colsog_zeus_initPf77Rack.sqf and click on the vehicle
- The vehicle will now have 3 more racks of PRC77 radios:
- A2A
- A2G
- HQ
4. Tracker module
We created a custom Zeus module to manage the AI trackers spawned by the tracker module. To use that module, the tracker module placed in the Eden editor needs to have the below name:TrackermoduleNAME
and the below code in its 'Run condition' section.
COLSOG_TrackersEnabled
By default:
- tracker module is disabled
- tracker behaviour is set as "CARELESS", "BLUE", "LIMITED".
5. Disable mine detector panel
For immersion purposes, we removed the HUD for mine detector.6. Remove throwables from OPFOR AI
We removed the below items for OPFOR AIs:"vn_rdg2_mag",
"vn_molotov_grenade_mag"]
7. Convert AI medikit/First aid kit to ace medical
At the death of a unit (AI/Player):-
Medikit are converted to:
20x "ACE_fieldDressing" 2x "ACE_salineIV_500" 2x "ACE_epinephrine" 2x "ACE_morphine" 4x "ACE_tourniquet" 2x "ACE_splint" -
FirstAidKit are converted to:
5x "ACE_fieldDressing" 1x "ACE_morphine"
8. Add 'STABO' action on chopper in Eden Editor
Adds the ability to any player in the vehicle to drop/detach the STABO rig.
Place the below lines of code into the 'init' section of the vehicle.
this setVariable ["COLSOG_staboRopeDeployed", false, true];
this addAction
[
"<t color='#FF0000'>Drop the STABO rig</t>",
"functions\stabo\colsog_fn_dropStabo.sqf",
nil,
0,
true,
true,
"",
"(_this in _target) AND !(_target getVariable 'COLSOG_staboRopeDeployed')",
50,
false,
"",
""
];
this addAction
[
"<t color='#FF0000'>Detach ropes</t>",
"functions\stabo\colsog_fn_detatchRopes.sqf",
nil,
0,
true,
true,
"",
"(_this in _target) AND (_target getVariable 'COLSOG_staboRopeDeployed')",
50,
false,
"",
""
];
9. Add 'request crew' action on chopper in Eden Editor
Adds the ability to the pilot in the vehicle to request AI door gunners (crew) if:
- helicopter is touching the ground AND
- engine is off
(Crew can only be added once).
Place the below lines of code into the 'init' section of the vehicle.
this setVariable ["COLSOG_HasCrew", false, true];
this addAction
[
"<t color='#FFFF00'>Request crew</t>",
"functions\crew\colsog_fn_addCrew.sqf",
nil,
0,
true,
true,
"",
"(_this in _target) AND (driver _target isEqualTo _this) AND (isTouchingGround _target) AND !(isEngineOn _target) AND !(_target getVariable 'COLSOG_HasCrew')",
50,
false,
"",
""
];
this addAction
[
"<t color='#FFFF00'>Remove crew</t>",
"functions\crew\colsog_fn_deleteCrew.sqf",
nil,
0,
true,
true,
"",
"(_this in _target) AND (driver _target isEqualTo _this) AND (isTouchingGround _target) AND !(isEngineOn _target) AND (_target getVariable 'COLSOG_HasCrew')",
50,
false,
"",
""
];
10. Radio battery/power management
Now the RTO will need to carry batteries for his radio. Currently managed ACRE radio:
- PRC77
You will have two new action under 'ace equipment' interaction:
- "Show battery level": If you have one of the above radio types in your inventory.
- "Add new battery": If you have one of the above radio types and a battery item in your inventory.
If your battery is EMPTY, the radio will be turned OFF (will not update radio GUI) and once a new battery has been added, you will have to turn it OFF/ON again in the radio GUI.
11. Triangulation
In order to triangulate enemy radios, you will need:
- To set the frequency on the in the object (see 'Items to detect' in CBA setting to use other objects) the players will have to triangulate with the below code in the 'init' section of the object (ex: frequency set to 52.50).
this setVariable ["COLSOG_radioFrequency", 52.50, true];
- The players will have to set the frequency of the PRC77 radio to the desired frequency (in this example 52.50) and then use the triangulate action in 'ace self-interact equipment' menu.
There is a timeout on the triangulation process (see 'Cool down in seconds' in CBA setting) after each execution.
1. Respawn with saved loadout
To save your loadout, add the below code in the arsenal 'init' section.
this addAction [
"Save loadout",
{player setVariable["saved_loadout",getUnitLoadout player];
hint "Loadout saved";},
nil,
1.5,
true,
true,
"",
"_this distance _target < 2",
50,
false,
"",
""
];
Then, by looking at the arsenal (from 2 meters maximum) and using the scroll wheel, you will have the option to 'save loadout'. This will allow you to respawn with the saved loadout instead of default loadout at connection.
2. Add image on map stand
To display any image on a map stand, follow the below steps:
-
convert your .png into one of these resolution: 256x256, 512x512, 1024x1024 or 2048x2048
-
2 ways to convert .png to .paa:
- Manual: use the TexView 2 (Arma 3 Tool) to convert the .png into a .paa (Use 'RGBA' and in the other section use 'DXT5')
- Web: ARMA 3 PAA CONVERTER
-
add .paa file into the 'images' folder
-
add the below code in the 'init' section of the map stand:
this setObjectTexture [0, "images\YOUR_IMAGE.paa"]
3. Add teleport flag
To add a teleport flag (or any other object that player can use to teleport themselves at a predetermined point) follow the below steps:
-
Add a invisible marker (point) on the map in editor and give it a name (ex: "airfield")
-
add the below code in the 'init' section of the teleport flag (or object you choose)
this addAction [ "Travel to airfield", // This text will be displayed in the action menu (using the scroll wheel). { (_this select 1) setPos (getMarkerPos "airfield");} // This section will teleport the player to the position of the "airfield" marker. ];
4. Force vietnamese face on players
N.B: Roles 1-0, 1-1 and 1-2 will not be impacted by the face change since they were US soldiers.
Playing as early MACV-SOG team, we are playing as south vietnamese thus we force vietnamese faces on all playable character. At player initilization or at player respawn, one random asian face is selected from the below list and set for the current player.
[
"vn_b_AsianHead_A3_06_02",
"vn_b_AsianHead_A3_07_02",
"vn_b_AsianHead_A3_07_03",
"vn_b_AsianHead_A3_07_04",
"vn_b_AsianHead_A3_07_05",
"vn_b_AsianHead_A3_07_06",
"vn_b_AsianHead_A3_07_07",
"vn_b_AsianHead_A3_07_08",
"vn_b_AsianHead_A3_07_09"
]
To disable this feature, you can comment or remove the below line from initPlayerlocal.sqf and onPlayerRespawn.sqf:
call COLSOG_fnc_faces;
You can also directly execute the below command on the server to directly reset all players faces to a random asian face:
call COLSOG_fnc_faces;
5. Add drinkable beer
To create a drinkable beer (or any other object that player can use) follow the below steps:
-
Add the beer object 'Savage Bia'
-
add the below code in the 'init' section of the beer (or object you choose)
this addAction ["Drink Beer", { "dynamicBlur" ppEffectEnable true; "dynamicBlur" ppEffectCommit 1; "dynamicBlur" ppEffectAdjust [6]; addCamShake [5, 60, 1]; sleep 4; "dynamicBlur" ppEffectEnable false; }];
6. Fuel consumption
Here is the code to place in the 'init' section of the vehicle you to change the fuel consumption of:
_this setFuelConsumptionCoef 3; // Fuel consumption will be 3x default consumption.
7. Display kill counter
To add an action to display kill counter for each player on the server, add the below line in the 'init' section of an object:this addAction ["Display total kills", "functions\colsog_fn_killCounter.sqf"]
this will give you a scroll wheel action to diplay the kill counter when looking at the object. see colsog_fn_killCounter.sqf