Difference between revisions of "DCS task escort"

From DCS World Wiki - Hoggitworld.com
(Undo revision 13803 by Grimes (talk))
 
Line 1: Line 1:
 
{{Template:DCS_tasking
 
{{Template:DCS_tasking
  
|tName= Ground Escort
+
|tName= Escort
  
|vNum= 2.7.7
+
|vNum= 1.2.4
  
 
|type= Main task
 
|type= Main task
  
|for= Helicopters
+
|for= Airplanes, Helicopters
  
|avail= CAS, Escort, Ground Attack
+
|avail= Escort, SEAD
  
|desc= The assigned helicopter group will orbit above the assigned ground group at a low altitude. Any valid detected targets will be engaged. If multiple helicopters are in the group then the aircraft will be distributed throughout the orbit. The orbit pattern is roughly just flying back and forth.
+
|desc= Controlled aircraft will follow the assigned group along their route in formation and will engage threats within a defined distance from the followed group. If the assigned group is on the ground the AI will orbit overhead. If assigned to a flight lead or group its wingmen will stay in their specified formation.
  
 
|form=  This task needs to be in the following format.  
 
|form=  This task needs to be in the following format.  
  
 
   Escort = {
 
   Escort = {
   id = 'GroundEscort',
+
   id = 'Escort',
 
   params = {
 
   params = {
 
     groupId = Group.ID,
 
     groupId = Group.ID,
     engagementDistMax, Distance,
+
     pos = Vec3,
 
     lastWptIndexFlag = boolean,
 
     lastWptIndexFlag = boolean,
     lastWptIndex = number,
+
     lastWptIndex = number
     targetTypes = array of AttributeName,
+
    engagementDistMax = Distance,
    lastWptIndexFlagChangedManually = boolean,
+
     targetTypes = array of AttributeName
 
   }     
 
   }     
 
  }
 
  }
Line 31: Line 31:
 
groupId: unique groupId.
 
groupId: unique groupId.
  
engagementDistMax: With his task it does not appear to actually define the range AI are allowed to attack at, rather it defines the size length of the orbit. The helicopters will fly up to this set distance before returning to the escorted group.  
+
pos: Vec3 point defining the relative position the controlled flight will form up on. For racetrack orbits, it is best to be back and to the right.
 +
 
 +
engagementDistMax: Maximum distance of targets from the followed aircraft that the AI will actively engage. If the AI is currently engaging a threat and the followed aircraft gets more than 1.5* the max engagement distance, then the escort aircraft will disengage and re-form on the aircraft they are escorting.
  
 
targetTypes: Is an array of object attributes which the AI will engage
 
targetTypes: Is an array of object attributes which the AI will engage
  
 +
--Need to add more details on the xyz coords so people better understand the positioning.
  
 
'''Optional Parameters''':  
 
'''Optional Parameters''':  
Line 41: Line 44:
 
   
 
   
 
lastWptIndex : '''(Default: -1)''' Identifies the waypoint at which the following group will stop its task. Must be set if lastWPIndexFlag is not changed to false. Otherwise the AI will immediately abandon the task.  
 
lastWptIndex : '''(Default: -1)''' Identifies the waypoint at which the following group will stop its task. Must be set if lastWPIndexFlag is not changed to false. Otherwise the AI will immediately abandon the task.  
 
lastWptIndexFlagChangedManually : I have no idea what this is, but the value in the task with the mission editor is set to true, so it might be required. 
 
  
 
|enum= N/A
 
|enum= N/A
Line 51: Line 52:
  
 
}}
 
}}
 
+
[[Category:Aircraft Task|Escort]]
[[Category:Helicopter Task|Ground Escort]]
+
[[Category:Helicopter Task|Escort]]

Latest revision as of 00:47, 21 October 2021


Task: Escort Added with: 1.2.4
Hierarchy: Scripting Root > Tasks > Main task > Escort
Tasking Type: Main task
For: Airplanes, Helicopters
Available Under: Escort, SEAD
Description: Controlled aircraft will follow the assigned group along their route in formation and will engage threats within a defined distance from the followed group. If the assigned group is on the ground the AI will orbit overhead. If assigned to a flight lead or group its wingmen will stay in their specified formation.
Format: This task needs to be in the following format.
 Escort = {
  id = 'Escort',
  params = {
    groupId = Group.ID,
    pos = Vec3,
    lastWptIndexFlag = boolean,
    lastWptIndex = number
    engagementDistMax = Distance,
    targetTypes = array of AttributeName
  }    
}

Required parameters:

groupId: unique groupId.

pos: Vec3 point defining the relative position the controlled flight will form up on. For racetrack orbits, it is best to be back and to the right.

engagementDistMax: Maximum distance of targets from the followed aircraft that the AI will actively engage. If the AI is currently engaging a threat and the followed aircraft gets more than 1.5* the max engagement distance, then the escort aircraft will disengage and re-form on the aircraft they are escorting.

targetTypes: Is an array of object attributes which the AI will engage

--Need to add more details on the xyz coords so people better understand the positioning.

Optional Parameters:

lastWptIndexFlag : (Default: True) if true the AI will follow the group until it reaches a specified waypoint.

lastWptIndex : (Default: -1) Identifies the waypoint at which the following group will stop its task. Must be set if lastWPIndexFlag is not changed to false. Otherwise the AI will immediately abandon the task.

Enumerators: N/A
Examples:
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