Secondary Operations Manager – Arma 2

From Bohemia Interactive Community
Jump to navigation Jump to search
(Added the 'Replacing the Default Vehicles' section)
m (Text replacement - "[[Image:" to "[[File:")
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:ArmA_2:_Editor_Modules]]
{{TOC|side}}
Secondary Operations (SecOps) may be likened to side quests in RPG games. They are simple missions that can take place anywhere in the gameworld. The [[Secondary Operations Manager]] ('''SOM''') handles the starting of random SecOps and also manages Support Requests such as artillery.


'''Note: this page is a work-in-progress! More info to follow as soon as possible.'''


== Introduction ==
== Quickstart ==
Secondary Operations (SecOps) may be likened to side quests in RPG games. They are simple missions that can take place anywhere in the gameworld. The Secondary Operations Manager (SOM) handles the starting of random SecOps and also manages Support Requests such as artillery.


== Quickstart ==
A quick-start could be as such:
A quick-start could be as such:


Add Sec-Op Manager
# Add Sec-Op Manager: Create a ''Radio Alpha'' trigger, name it BrokenArrow, whilst putting "Broken Arrow" in the text box.
Create a ''Radio Alpha'' trigger, name it BrokenArrow, whilst putting Broken Arrow in the text box.
# In the "on act" field put: <sqf>[["transport", "aerial_reconnaissance", "supply_drop", "tactical_airstrike", "artillery_barrage", "gunship_run"], player] call BIS_SOM_addSupportRequestFunc;</sqf>


In the "on act" field put:
This allow you to call support from "Broken Arrow" by simply pushing the 0 radio option.
'''[["transport", "aerial_reconnaissance", "supply_drop", "tactical_airstrike", "artillery_barrage","gunship_run"], player] call BIS_SOM_addSupportRequestFunc;
'''


This allow you to call support from Broken Arrow by simply pushing the 0 radio option.


== Configuration ==
== Configuration ==
=== Replacing the Default Vehicles ===
=== Replacing the Default Vehicles ===
Should you wish to replace the default support vehicles with your own (such as replacing the transport UH-1Y with a CH-47), use the following in your SOM/init.SQF:
 
Should you wish to replace the default support vehicles with your own (such as replacing the transport UH-1Y with a CH-47), use the following in your {{hl|SOM/init.SQF}}:
* '''Transport Helo:'''  
* '''Transport Helo:'''  
<pre>SOM_Name setVariable ["TSS_vehicle_custom", Helo_Name]; //Where SOM_Name is the name of your SOM module, and Helo_Name is the name of your chosen helo.</pre>
 
'''''Note:''' The helo of your choice must be manned and present on the map (it is not spawned)''
<sqf>SOM_Name setVariable ["TSS_vehicle_custom", Helo_Name]; // where SOM_Name is the name of your SOM module, and Helo_Name is the name of your chosen helo</sqf>
{{Feature|informative|The helo of your choice must be manned and present on the map (it is not spawned).}}
 


== Functions ==
== Functions ==
=== Request SecOp ===
=== Request SecOp ===
Request a SecOp from the manager. 


  [<secop | String>, <priority | Boolean>, <SOM reference | Object>] call BIS_SOM_requestSecOpFunc
Request a SecOp from the manager:
<sqf>[secop, priority, SOMreference] call BIS_SOM_requestSecOpFunc;</sqf>


* ''secop'': Name of the SecOp as String ("ambush", "attack_location", "trap", "rescue", "patrol", "escort", "defend_location", "destroy", "search").  See class names in CfgSecOps.
* ''secop'': [[String]] - Name of the SecOp as String ("ambush", "attack_location", "trap", "rescue", "patrol", "escort", "defend_location", "destroy", "search").  See class names in CfgSecOps.
* ''priority'': True will start the SecOp at once, false will put it in a queue for later.
* ''priority'': [[Boolean]] - [[true]] will start the SecOp at once, [[false]] will put it in a queue for later.
* ''SOM reference'': The reference to the manager.
* ''SOMreference'': [[Object]] - the reference to the manager.


==== Example ====
Starts Ambush SecOp at once.  BIS_SOM is module name:
<sqf>["ambush", true, BIS_SOM] call BIS_SOM_requestSecOpFunc;</sqf>


'''Example:'''


Starts Ambush SecOp at once.  BIS_SOM is module name.
== Advanced topics ==


  ["ambush", true, BIS_SOM] call BIS_SOM_requestSecOpFunc;
=== New SecOps ===
 
{{Wiki|stub}}


== Advanced topics ==
=== New SecOps ===
=== SecOp parameters ===
=== SecOp parameters ===
SecOp does [[getVariable]] "settings" when it initializes. Values are: pool (default: ["ambush","attack_location","trap","rescue","patrol","escort","defend_location","destroy","search"]), HQ toggle (true), callsigns (leader of group, leader speech used, hq, hq speech: ["ALPHA", ["Alpha"], "H.Q.", ["HQ"]]), initialDelay (30), autoReinforce (true), secOpSpacing (30), randomActivation (0.7), and secOpDistances ([300, 700]).


'''Example:'''
SecOp does [[getVariable]] "settings" when it initializes. Values are:
  this setVariable ["settings", [[], true, ["Razor", ["Razor"], "H.Q.", ["H.Q."]], 120, false]];
* pool (default: <sqf inline>["ambush", "attack_location", "trap", "rescue", "patrol", "escort", "defend_location", "destroy", "search"]</sqf>)
* HQ toggle (true)
* callsigns (leader of group, leader speech used, hq, hq speech: ["ALPHA", ["Alpha"], "H.Q.", ["HQ"]])
* initialDelay (30)
* autoReinforce (true)
* secOpSpacing (30)
* randomActivation (0.7)
* secOpDistances ([300, 700])


==== Example ====
<sqf>this setVariable ["settings", [[], true, ["Razor", ["Razor"], "H.Q.", ["H.Q."]], 120, false]];</sqf>
''Taken from the War Welcome Mission''
''Taken from the War Welcome Mission''


For "leader speech", you can use multiple keywords to make a unique callsign, e.g
<sqf>this setVariable ["settings", [
[],
true,
[
"Romeo and Juliet is behind team blue not far from team red in Nadezhdino",
["Romeo", "and", "Juliet", "is", "behind", "blueTeam", "notFarFrom", "from", "redTeam", "in", "Nadezhdino"],
"H.Q.",
["H.Q."]
],
120,
false
]];</sqf>


=== SecOp phasescripts ===


Note: For "leader speech", you can use multiple keywords to make a unique callsign, eg.
{{Wiki|stub}}
 
'''Example:'''
  this setVariable ["settings", [[], true, ["Romeo and Juliet is behind team blue not far from team red in Nadezhdino", ["Romeo", "and", "Juliet", "is", "behind", "blueTeam", "notFarFrom", "from", "redTeam", "in", "Nadezhdino"], "H.Q.", ["H.Q."]], 120, false]];
 
=== SecOp phasescripts ===


===Using ARTY with the Secop Manager===
=== Using ARTY with the Secop Manager ===


[[Image:Arty_somlink.png|Artillery with SOM]]
[[File:Arty_somlink.png|Artillery with SOM]]


The Secop manager or (SOM) is currently the simplest way to take advantage of the artillery system. To use this, you must have a Secop Manager gamelogic synced to the player. If you want to use SOM with a real artillery battery, you must have constructed a battery using either real or virtual artillery.
The Secop manager is currently the simplest way to take advantage of the artillery system. To use this, you must have a Secop Manager gamelogic synced to the player. If you want to use SOM with a real artillery battery, you must have constructed a battery using either real or virtual artillery.


To add the artillery barrage to the list of Secop requests, you need to decide which ones should be available. As of the time of this writing, there are 9 fire mission templates loaded into the Secop manager which are available as Secop fire missions:
To add the artillery barrage to the list of Secop requests, you need to decide which ones should be available. As of the time of this writing, there are 9 fire mission templates loaded into the Secop manager which are available as Secop fire missions:
Line 79: Line 98:
# Adjust fire - Fire two HE rounds at the target.
# Adjust fire - Fire two HE rounds at the target.


When using a physical or virtual artillery battery, a list of one or more of these FM types (by ID) will need to be included. For instance, if I wanted to have SOM call on my artillery battery (with RIPPER as the Artillery Module logic), I would run the following:
When using a physical or virtual artillery battery, a list of one or more of these FM types (by ID) will need to be included. For instance, to have SOM call on an artillery battery (with RIPPER as the Artillery Module logic), run the following:
 
<pre>
[["artillery_barrage"], player, [[RIPPER, [7,8,9]]], [true]] call BIS_SOM_addSupportRequestFunc;
</pre>
 
The above will allow the two fire for effect missions and the adjust fire mission to be called by the SOM. The last parameter "[true]" means the SOM will not expire if you do not use it for X seconds. Once used, you will need to re-add the arty support request if you want to fire arty again.
 
However, the SOM will also run fire missions without an artillery battery specified. When you add this type of support request, it will utilize spawned virtual artillery pieces set in spawn mode, so you don't need to worry about the position of the battery—SOM will generate it automatically. Adding this type of support request is accomplished without passing parameters to the SOM as follows:
 
<pre>
[["artillery_barrage"], player, [[]], [true]] call BIS_SOM_addSupportRequestFunc;
</pre>
 
The SOM will handle all communications between the player and the HQ entity. Remember to only provide fire missions that are available for that Artillery battery (for instance, don't give the Grad an Illumination mission) or you will get an error.
 


Now after this explanation heres a step by step to add your artillery using SOM:
<sqf>[["artillery_barrage"], player, [[RIPPER, [7,8,9]]], [true]] call BIS_SOM_addSupportRequestFunc;</sqf>


The above will allow the two fire for effect missions and the adjust fire mission to be called by the SOM. The last parameter "[true]" means the SOM will not expire if not used within X seconds. Once used, the arty support request needs to be re-added in order to be able to fire artillery again.


'''1'''.Put a SOM module on the map
However, the SOM will also run fire missions without an artillery battery specified. When this type of support request is added, it will utilize spawned virtual artillery pieces set in spawn mode, so there is no need to worry about the position of the battery—SOM will generate it automatically. Adding this type of support request is accomplished without passing parameters to the SOM as follows:


'''2'''.in its int field copy this:
<sqf>[["artillery_barrage"], player, [[]], [true]] call BIS_SOM_addSupportRequestFunc;</sqf>


''this setVariable ["settings", [[], true, nil, nil, false]]'';   
The SOM will handle all communications between the player and the HQ entity. Remember to only provide fire missions that are available for that Artillery battery (for instance, don't give the Grad an Illumination mission) or you will get an error.)


to stop custom missions


'''3'''.link it to your soldier (using F5)
Here is a step by step to add your artillery using SOM:


'''4'''.create a trigger and in it copy this :  
# Place a '''SOM''' module on the map
# in its init field copy this: <sqf inline>this setVariable ["settings", [[], true, nil, nil, false]];</sqf> to stop custom missions
# link it to your soldier (using '''F5''')
# create a trigger and in it copy this: <sqf>[["artillery_barrage"], player, [[]]] call BIS_SOM_addSupportRequestFunc;</sqf> this will add the support function Artilley to your comm Menu (default 0)


''[["artillery_barrage"], player, [[]]] call BIS_SOM_addSupportRequestFunc'';
(I advise creating the trigger as a repeated trigger to add artilley when you need it)


this will add the support function Artilley to your comm Menu (default 0 )


( i advise creating the trigger as a repeated trigger to add artilley when you need it )
{{GameCategory|arma2|Editor Modules}}

Latest revision as of 23:09, 20 November 2023

Secondary Operations (SecOps) may be likened to side quests in RPG games. They are simple missions that can take place anywhere in the gameworld. The Secondary Operations Manager (SOM) handles the starting of random SecOps and also manages Support Requests such as artillery.


Quickstart

A quick-start could be as such:

  1. Add Sec-Op Manager: Create a Radio Alpha trigger, name it BrokenArrow, whilst putting "Broken Arrow" in the text box.
  2. In the "on act" field put:
    [["transport", "aerial_reconnaissance", "supply_drop", "tactical_airstrike", "artillery_barrage", "gunship_run"], player] call BIS_SOM_addSupportRequestFunc;

This allow you to call support from "Broken Arrow" by simply pushing the 0 radio option.


Configuration

Replacing the Default Vehicles

Should you wish to replace the default support vehicles with your own (such as replacing the transport UH-1Y with a CH-47), use the following in your SOM/init.SQF:

  • Transport Helo:

SOM_Name setVariable ["TSS_vehicle_custom", Helo_Name]; // where SOM_Name is the name of your SOM module, and Helo_Name is the name of your chosen helo

The helo of your choice must be manned and present on the map (it is not spawned).


Functions

Request SecOp

Request a SecOp from the manager:

[secop, priority, SOMreference] call BIS_SOM_requestSecOpFunc;

  • secop: String - Name of the SecOp as String ("ambush", "attack_location", "trap", "rescue", "patrol", "escort", "defend_location", "destroy", "search"). See class names in CfgSecOps.
  • priority: Boolean - true will start the SecOp at once, false will put it in a queue for later.
  • SOMreference: Object - the reference to the manager.

Example

Starts Ambush SecOp at once. BIS_SOM is module name:

["ambush", true, BIS_SOM] call BIS_SOM_requestSecOpFunc;


Advanced topics

New SecOps

SecOp parameters

SecOp does getVariable "settings" when it initializes. Values are:

  • pool (default: ["ambush", "attack_location", "trap", "rescue", "patrol", "escort", "defend_location", "destroy", "search"])
  • HQ toggle (true)
  • callsigns (leader of group, leader speech used, hq, hq speech: ["ALPHA", ["Alpha"], "H.Q.", ["HQ"]])
  • initialDelay (30)
  • autoReinforce (true)
  • secOpSpacing (30)
  • randomActivation (0.7)
  • secOpDistances ([300, 700])

Example

this setVariable ["settings", [[], true, ["Razor", ["Razor"], "H.Q.", ["H.Q."]], 120, false]];

Taken from the War Welcome Mission

For "leader speech", you can use multiple keywords to make a unique callsign, e.g

this setVariable ["settings", [ [], true, [ "Romeo and Juliet is behind team blue not far from team red in Nadezhdino", ["Romeo", "and", "Juliet", "is", "behind", "blueTeam", "notFarFrom", "from", "redTeam", "in", "Nadezhdino"], "H.Q.", ["H.Q."] ], 120, false ]];

SecOp phasescripts

Using ARTY with the Secop Manager

Artillery with SOM

The Secop manager is currently the simplest way to take advantage of the artillery system. To use this, you must have a Secop Manager gamelogic synced to the player. If you want to use SOM with a real artillery battery, you must have constructed a battery using either real or virtual artillery.

To add the artillery barrage to the list of Secop requests, you need to decide which ones should be available. As of the time of this writing, there are 9 fire mission templates loaded into the Secop manager which are available as Secop fire missions:

  1. Immediate suppression, high explosive - Fire 10 rounds as fast as the battery can.
  2. Immediate smoke - Fire 6 smoke shells.
  3. Immediate suppression, Willie Pete - Same as Immediate HE, but with WP.
  4. Illumination mission - One flare munition every 10 seconds for 3 minutes.
  5. LASER - Fire two laser guided HE shells.
  6. SADARM – Stagger three SADARMs ten seconds apart.
  7. HE Fire For Effect - Bombard with continuous HE for one minute.
  8. WP Fire For Effect – Bombard with continuous WP for one minute.
  9. Adjust fire - Fire two HE rounds at the target.

When using a physical or virtual artillery battery, a list of one or more of these FM types (by ID) will need to be included. For instance, to have SOM call on an artillery battery (with RIPPER as the Artillery Module logic), run the following:

[["artillery_barrage"], player, [[RIPPER, [7,8,9]]], [true]] call BIS_SOM_addSupportRequestFunc;

The above will allow the two fire for effect missions and the adjust fire mission to be called by the SOM. The last parameter "[true]" means the SOM will not expire if not used within X seconds. Once used, the arty support request needs to be re-added in order to be able to fire artillery again.

However, the SOM will also run fire missions without an artillery battery specified. When this type of support request is added, it will utilize spawned virtual artillery pieces set in spawn mode, so there is no need to worry about the position of the battery—SOM will generate it automatically. Adding this type of support request is accomplished without passing parameters to the SOM as follows:

[["artillery_barrage"], player, [[]], [true]] call BIS_SOM_addSupportRequestFunc;

The SOM will handle all communications between the player and the HQ entity. Remember to only provide fire missions that are available for that Artillery battery (for instance, don't give the Grad an Illumination mission) or you will get an error.)


Here is a step by step to add your artillery using SOM:

  1. Place a SOM module on the map
  2. in its init field copy this: this setVariable ["settings", [[], true, nil, nil, false]]; to stop custom missions
  3. link it to your soldier (using F5)
  4. create a trigger and in it copy this:
    [["artillery_barrage"], player, [[]]] call BIS_SOM_addSupportRequestFunc;
    this will add the support function Artilley to your comm Menu (default 0)

(I advise creating the trigger as a repeated trigger to add artilley when you need it)