Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.


Extremly

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