Page tree
Skip to end of metadata
Go to start of metadata

Introduced in

Version:3.9.1

Description

Description:Used to create different forms of Close Air Support (CAS).

The type of CAS and its behavior depend on the input type parameter.

  • Type "strafe":

Must be applied to an existing aircraft in the mission, which navigates to the Ingress Point (IP) before commencing attack on the target position. The aircraft needs to be equipped with the respective weapon and ammo, in order to attack. The aircraft navigates to the Egress Point (EP) after the attack run. If the aircraft has incomplete waypoints assigned to it before the function is called, it resumes waypoint navigation after reaching EP, or directly after the attack, if the EP parameter is left out. The distance at which the attack is initiated is based on the angle and altitude of the aircraft. Entering a positive or negative number always results in the angle being negative relative to level flight.

  • Type "airstrike":

Spawns a new aircraft, which attacks target position with bombs and / or missiles. Aircraft ordnance can be customized using an array of pylons / hardpoints (not visible in the aircraft model). An unlimited amount of ordnance can be added to the aircraft. However, excess amounts affect accuracy. Extremely low altitudes affect the accuracy of bombs.

Syntax

Syntax:["strafe", [vehicle, targetPos, attackAngle, altitude, ingressPos, egressPos, contactPt, pullupPt, weapon, magazine]] call fn_vbs_closeAirSupport
Parameters:
  • vehicle: Vehicle - Aircraft which is supposed to fire.
  • targetPos: Position-2 - Position of target area to fire on.
  • angleAttack: Number - Desired angle at which the aircraft attacks a target (relative to level flight).
  • altitude: Number - Altitude the aircraft flies at from IP to target area.
  • ingressPos: Position-2 - (Optional) Position the aircraft maneuvers to before initiating an attack run. Both ingress and egress parameters are required for this to occur, else the aircraft moves directly to the target position.
  • egressPos: Position-2 - (Optional) Position aircraft maneuvers to after initiating an attack run.
  • contactPt: Number - (Optional) Distance from target in meters at which the aircraft begins firing (default: 9/10 of the altitude).
  • pullupPt: Number - (Optional) Distance from target in meters at which the aircraft ends firing and pulls up (default: half of the altitude).
  • weapon: String - (Optional) Weapon to fire (default: first suitable weapon found).
  • magazine: String - (Optional) Ammunition type to fire (default: loaded ammunition).
Return Value:Nothing

Alternative Syntax

Syntax:["strafe", [vehicle, [startTgtPos, endTgtPos], attackAngle, altitude, ingressPos, egressPos, contactPt, pullupPt, weapon, magazine]] call fn_vbs_closeAirSupport (V17.1+)
Parameters:
  • vehicle: Vehicle - Aircraft which is supposed to fire.
  • startTgtPos: Position-2 - Start of the beaten zone.
  • endTgtPos: Position-2 - End of the beaten zone.
  • angleAttack: Number - Desired angle at which the aircraft attacks a target (relative to level flight).
  • altitude: Number - Altitude the aircraft flies at from IP to target area.
  • ingressPos: Position-2 - (Optional) Position the aircraft maneuvers to before initiating an attack run. Both ingress and egress parameters are required for this to occur, else the aircraft moves directly to the target position.
  • egressPos: Position-2 - (Optional) Position aircraft maneuvers to after initiating an attack run.
  • contactPt: Number - (Optional) Distance from target in meters at which the aircraft begins firing (default: 9/10 of the altitude).
  • pullupPt: Number - (Optional) Distance from target in meters at which the aircraft ends firing and pulls up (default: half of the altitude).
  • weapon: String - (Optional) Weapon to fire (default: first suitable weapon found).
  • magazine: String - (Optional) Ammunition type to fire (default: loaded ammunition).
Return Value:Nothing

Alternative Syntax #2

Syntax:["airstrike", [aircraftClass, aircraftOrd, targetPos, dispDiam, approachDir, altitude, egressDir]] call fn_vbs_closeAirSupport
Parameters:
  • aircraftClass: String - Class name of the aircraft.
  • aircraftOrd: Array - Array of aircraft pylon information, containing an array for each hardpoint / pylon, with ammunition type and number of rounds. See example for more information.
  • targetPos: Position-2 - Position of target area to fire on.
  • dispDiam: Number - Diameter of the circle the ordnance falls in, centered on the target (optional, default: 0).
  • approach direction: Number - Aircraft will be created flying this heading to the target (optional, default: 0).
  • altitude: Number - ASL altitude (in meters) at which the aircraft flies (optional, default: 1000).
  • egressDir: Number - Angle (relative to approach direction) at which the aircraft exits the target area (optional, default: 0).
Return Value:Nothing

Examples

Examples:
// Target Position
_tgtPos = getPosASL2 _myTarget;
// Ingress Point, 5km north of target
_myIP = [_tgtPos, 5000, 0] call fn_vbs_relPos;
// Egress Point, 5km east of target
_myEP = [_tgtPos, 5000, 90] call fn_vbs_relPos;
["strafe", [_myVeh, _tgtPos , 20, 2000, _myIP, _myEP, 1000, 500, "vbs2_HydraLauncher", "vbs2_mag_14rnd_Hydra_HE"]] call fn_vbs_closeAirSupport;

// Creates an Apache Longbow south of the target position. Apache flies at 500m altitude toward target area, and // fires a single Hellfire missile at target area. Once the Apache has fired, it will bank right and exit the // target zone to the east. ["airstrike", ["vbs2_us_ah64d_longbow_x", [["vbs2_ammo_M_Hellfire_AGM114M", 1]], getPosASL2 target, 0, 0, 500, 90]] call fn_vbs_closeAirSupport

// Creates an A-10 Thunderbolt south (default) of target position. A-10 flies at 1000m (default) altitude. A-10 releases a single Mk82 bomb // and 2 Hellfire missiles from pylons 1 and 2, before egressing north (0 degrees relative to approach direction, default). ["airstrike", ["vbs2_us_af_a10a_mk82_hydra", [["vbs2_ammo_Bo_mk82", 1], ["vbs2_ammo_M_Hellfire_AGM114M", 2]], getPosASL2 target]] call fn_vbs_closeAirSupport

// Creates a Tornado GR4 west of the target, equipped with 2 x Hellfires on pylon 1, 1 x Maverick on pylon 2, and 4 x GBU-16 bombs on pylon 3. // Aircraft approaches target at 800m altitude, and releases ordnance. Aircraft then banks left and exits target area north of target. // Ordnance will land in an oval area measuring 150m x 75m (semi major axis aligned with aircraft's heading) around the target position. ["airstrike", ["vbs2_gb_raf_gr4", [["vbs2_ammo_M_Hellfire_AGM114M", 2], ["vbs2_ammo_M_Maverick_AGM65G", 1], ["vbs2_ammo_Bo_gbu16", 4]], getPosASL2 target, 150, 90, 800, -90]] call fn_vbs_closeAirSupport

Additional Information

See also: closeAirSupport
Multiplayer: 
Problems: 

Notes