DCS task strafing

From DCS World Wiki - Hoggitworld.com


Task: Strafing Added with: 2.9.0
Hierarchy: Scripting Root > Tasks > Main task > Strafing
Tasking Type: Main task
For: Airplanes, Helicopters
Available Under:
Description: Assigns a point on the ground for which the AI will do a strafing run with guns or rockets.
Format: This task needs to be in the following format.
Strafing= { 
 id = 'Strafing', 
 params = { 
   point = Vec2,
   weaponType = number, 
   expend = enum AI.Task.WeaponExpend,
   attackQty = number, 
   attackQtyLimit = boolean,
   direction = Azimuth, 
   directionEnabled = boolean,
   groupAttack = boolean, 
   length = number, 
 } 
}

Required parameters: point: vec2 coordinate of the target. Can also be an x and y values directly in params table.

attackQty: Number of times the group will attack if the target.

Optional Parameters: All other variables are optional. Some variables require other entries, for example the boolean values require the corresponding value if the boolean is true.

expend: Enum that defines how much munitions the AI will expend per attack run.

attackQtyLimit: boolean that defines whether or not the attackQty value will be used.

groupAttack: If true then each aircraft in the group will attack the point.

length: The total length of the strafing target.

Enumerators: weaponType is a number associated with a correspond weapons flags

AI.Task.WeaponExpend

"QUARTER" = "Quarter"
"TWO"     = "Two"
"ONE"     = "One"
"FOUR"    = "Four"
"HALF"    = "Half"
"ALL"     = "All"
Examples: The following will make the group "dakka" do a strafing run on a target with a quarter of its rockets.
 local target = {}
 local zone = trigger.misc.getZone("targetPractice")
 target.point = {x = zone.point.x, y = zone.point.z}
 target.expend = "Quarter"
 target.weaponType = 30720
 target.attackQty = 1
 local engage = {id = 'Strafing', params = target}
 Group.getByName('dakka'):getController():setTask(engage)
Notes: See article Mission Editor: AI Tasking for more information on how AI tasking is handled within DCS.
Task List: Task Wrappers: mission, ComboTask, ControlledTask, WrappedAction


Tasks: AttackGroup, AttackUnit, Bombing, Strafing, CarpetBombing, AttackMapObject, BombingRunway, orbit, refueling, land, follow, followBigFormation, escort, Embarking, fireAtPoint, hold, FAC_AttackGroup, EmbarkToTransport, DisembarkFromTransport, CargoTransportation, goToWaypoint, groundEscort, RecoveryTanker

En-route Tasks: engageTargets, engageTargetsInZone, engageGroup, engageUnit, awacs, tanker, ewr, FAC_engageGroup, FAC

Commands: script, setCallsign, setFrequency, setFrequencyForUnit, switchWaypoint, stopRoute, switchAction, setInvisible, setImmortal, setUnlimitedFuel, activateBeacon, deactivateBeacon, activateICLS, deactivateICLS, eplrs, start, transmitMessage, stopTransmission, smoke_on_off, ActivateLink4, deactivateLink4, activateACLS, deactivateACLS, LoadingShip

Options: ROE, Reaction To Threat, Radar Using, Flare Using, Formation, RTB On Bingo, silence, Disperse on Attack, Alarm State, RTB on Out of Ammo, ECM Using, Prohibit AA, Prohibit Jettison, Prohibit Afterburner, Prohibit AG, Missile Attack Range, Prohibit WP Pass Report, Engage Air Weapons, Option Radio Usage Contact, Option Radio Usage Engage, Option Radio Usage Kill, AC Engagement Range Restriction, jett tanks if empty, forced attack, Altitude Restriction for AAA Min, restrict targets, Altitude Restriction for AAA Max, Prefer Vertical, Evasion Of ARM, Formation Interval