/********* pook_ARTY SSBM AI Fire Mission Function **************************************************

Initiates player-requested SSBM fire mission for friendly pook_SCUD launchers. Can be scripted
for mission-driven "RED DAWN" or "SEARCH AND DESTROY" SCUD fire missions (e.g. "Stop General
Guba before he launches the SCUD" type missions).

Author: hcpookie

Arguments:
==========
0: The player calling the mission
1: The SSBM ammo type being requested (OPTIONAL: default = HE)
2: Range (in km) to check for friendly launchers (OPTIONAL: default = 20)
3: OPTIONAL: Map grid coordinates. Uses standard coordinate format (ex. [0,0,0]).

USAGE:
======
1. Place AI SCUD launcher via editor, or spawn within mission. The function supports types:
- pook_SCUD
- PLA_DF15

2. Either "addAction" for desired ammo type to a Commander/Spotter/Radio operator, etc:

HE:
----
this addAction ["SSBM Mission", {[player, "HE", 20] spawn pook_ARTY_FNC_SCUDMISSION},"",1,false,true];
- or -
this addAction ["SSBM Mission", {[player] spawn pook_ARTY_FNC_SCUDMISSION},"",1,false,true];

CBU:
----
this addAction ["SSBM Mission", {[player, "CBU", 15] spawn pook_ARTY_FNC_SCUDMISSION},"",1,false,true];

5kt:
----
this addAction ["SSBM Mission", {[player, "5kt", 5] spawn pook_ARTY_FNC_SCUDMISSION},"",1,false,true];

... You may replace "player" with the object's "Variable Name" (in the editor) depending on your scripting needs.

... Or via trigger/script for the artillery vehicle:

_launch = [this, "HE"] spawn pook_ARTY_FNC_SCUDMISSION;

3. OPTIONAL: The third input parameter defines the search radius to seek friendly launch-capable SCUD
launchers. Default is 20km. This can be adjusted to accommodate multiple launchers in the same mission.

4. OPTIONAL: Map grid Coordinates. Uses standard coordinate format (ex. [0,0,0]). May be used for scripting purposes.
If not found, operator will prompted for map-click coordinates.

5. AI will select and arm the appropriate warhead.

6. Script will disable consecutive reloads to prevent "infinite ammo" loops

7. Rearm can only be achieved either via player-based launches, and only for launchers with
their "ScudLoadStatus" variable > 0.

RETURN:
=======
- AI will send sideRadio and sideChat notices confirming fire
mission or reporting status if out of ammo, or no friendly
SCUD launchers are in the area (default 20km zone)

NOTES:
======
- Cannot be used for human-controlled launchers.
- Launch command cannot be aborted!
- The SCUD launcher is calibrated to Real World values, and can launch anywhere between 1-300km

*****************************************************************************************************/