DCS task mission - Revision history

Grimes at 22:12, 20 February 2022

2022-02-20T22:12:13Z

Grimes at 02:08, 30 September 2021

2021-09-30T02:08:28Z

Grimes at 02:01, 6 September 2021

2021-09-06T02:01:46Z

Grimes at 22:28, 14 February 2020

2020-02-14T22:28:18Z

Grimes at 22:27, 14 February 2020

2020-02-14T22:27:11Z

Grimes at 22:26, 14 February 2020

2020-02-14T22:26:53Z

Grimes: 1 revision imported

2018-04-12T00:12:18Z

1 revision imported

New page

{{Template:DCS_tasking

|tName= mission

|vNum= 1.2.4

|type= Main task

|for= Airplanes, Helicopters, Ground Vehicles, Ships

|avail= Everything

|desc= The mission task is a collection of waypoints that are assigned to a group. When you create a group in the mission editor and place a route, you are created its mission task.

For ground vehicles and ships the mission task is how you can more directly control where ground/ship forces are going.

|form= This task needs to be in the following format.

Mission = {
id = 'Mission',
params = {
route = {
points = {
[1] = {
type = enum AI.Task.WaypointType,
airdromeId = Airbase.ID,
helipadId = Airbase.ID,
action = enum AI.Task.TurnMethod,
x = Distance,
y = Distance,
alt = Distance,
alt_type = enum AI.Task.AltitudeType,
speed = Distance,
speed_locked = boolean,
ETA = Time,
ETA_locked = boolean,
name = string,
task = Task
},
[2] = {
...
},
...
[N]= {
...
}
}
},
}
}
}

Each waypoint has a number of parameters that define how the group will handle the route.

'''Required parameters''':

''x:'' Vec2 x coordinate waypoint will be placed at.

''y:'' Vec2 y coordinate waypoint will be placed at. If converted from Vec3 this is the z coordinate.

''type:'' Waypoint type. See [[DCS_enum_AI|AI enumerator page]] for more details.

''action:'' Waypoint action type. See [[DCS_enum_AI|AI enumerator page]] for more details.

''alt:'' Altitude of waypoint. If converted from Vec3 this is the y coordinate. This item is required for Aircraft, but is optional for ground vehicles.

'''Optional Parameters''':

''speed:'' Speed in meters per second the group will attempt to travel at. Note each unit has its own maximum achievable speed
.
''speed_locked:'' boolean value that will determine if units will attempt to travel at the specified speed

''eta:'' Time-On-Target of the waypoint. Has effect only if ETA_locked is true. AI will adjust speed to reach TOT accordingly.

''eta_locked:'' Boolean value that will determine if AI will attempt to reach the waypoint at a specified time.

''alt_type:'' Altitude type; Radio or Barometric. Defaults to barometric. If specified the altitude of the waypoint can be defined as AGL or MSL. Only applies to aircraft.

''helipadId:'' Used only for "Land" waypoint type. Specifies the helipadId the helicopter group will attempt to land at. AI will only land if helipad is friendly. If not provided the AI will land at the nearest valid base to the coordinates.

''airdromeId:'' Used only for "Land" waypoint type. Specifies the airbaseId the aircraft group will attempt to land at. AI will only land if airbase is friendly. If not provided the AI will land at the nearest valid base to the coordinates.

''task:'' All tasks, enroute tasks, commands, and options are defined here.

|enum=
{{DCS_enum_AI_turnMethod}}
{{DCS_enum_AI_vehicleFormation}}
{{DCS_enum_AI_altitudeType}}
{{DCS_enum_AI_waypointType}}
|exam=

|notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.

}}

[[Category:Aircraft Task|mission]]
[[Category:Helicopter Task|mission]]
[[Category:Ground Task|mission]]
[[Category:Naval Task|mission]]

@@ Line 29: / Line 29: @@
             timeReFuAr = number,
             helipadId = Airbase.ID,
             action = enum AI.Task.TurnMethod,
             x = Distance,
@@ Line 84: / Line 85: @@
 '''Waypoint Type Specific Parameters'''
-''helipadId:'' Used only for "Land" waypoint type. Specifies the helipadId the helicopter group will attempt to land at. AI will only land if helipad is friendly. If not provided the AI will land at the nearest valid base to the coordinates.
+''helipadId:'' Used when the waypoint is associated with the a static object or a unit placed in the mission editor. Needs to be the unitId associated with the object.
-''airdromeId:'' Used only for "Land" waypoint type. Specifies the airbaseId the aircraft group will attempt to land at. AI will only land if airbase is friendly. If not provided the AI will land at the nearest valid base to the coordinates.
+''linkUnit:'' Used when the waypoint is associated with the a static object or a unit placed in the mission editor. Value is identical to helipadId, but it is required.
 ''timeReFuAr: '' If the waypoint type is a landReFuAr this value determines how long in minutes the unit will be stationary for.

← Older revision		Revision as of 22:28, 14 February 2020
Line 93:		Line 93:

	\|notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.		\|notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.
		+

	As of 2.5.6 a new parameter of airborne has been added to the root tasking for a flight. This is so the game knows that the aircraft group you are assigning a bunch of aircraft specific waypoint information is in fact being assigned to an aircraft group. This parameter is required if the group is assigned the task after spawn they are spawned in. This fixes a long standing bug where AI would ignore waypoint information and default to "Fly Over" waypoint type or airport Id if it was different from where it took off from.		As of 2.5.6 a new parameter of airborne has been added to the root tasking for a flight. This is so the game knows that the aircraft group you are assigning a bunch of aircraft specific waypoint information is in fact being assigned to an aircraft group. This parameter is required if the group is assigned the task after spawn they are spawned in. This fixes a long standing bug where AI would ignore waypoint information and default to "Fly Over" waypoint type or airport Id if it was different from where it took off from.

← Older revision		Revision as of 22:27, 14 February 2020
Line 93:		Line 93:

	\|notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.		\|notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.
		+
	As of 2.5.6 a new parameter of airborne has been added to the root tasking for a flight. This is so the game knows that the aircraft group you are assigning a bunch of aircraft specific waypoint information is in fact being assigned to an aircraft group. This parameter is required if the group is assigned the task after spawn they are spawned in. This fixes a long standing bug where AI would ignore waypoint information and default to "Fly Over" waypoint type or airport Id if it was different from where it took off from.		As of 2.5.6 a new parameter of airborne has been added to the root tasking for a flight. This is so the game knows that the aircraft group you are assigning a bunch of aircraft specific waypoint information is in fact being assigned to an aircraft group. This parameter is required if the group is assigned the task after spawn they are spawned in. This fixes a long standing bug where AI would ignore waypoint information and default to "Fly Over" waypoint type or airport Id if it was different from where it took off from.

@@ Line 63: / Line 63: @@
 ''type:'' Waypoint type. See [[DCS_enum_AI|AI enumerator page]] for more details.
 ''action:'' Waypoint action type. See [[DCS_enum_AI|AI enumerator page]] for more details.
@@ Line 70: / Line 72: @@
 '''Optional Parameters''':
-''speed:'' Speed in meters per second the group will attempt to travel at. Note each unit has its own maximum achievable speed
 ''speed_locked:'' boolean value that will determine if units will attempt to travel at the specified speed

@@ Line 26: / Line 26: @@
           [1] = {
             type = enum AI.Task.WaypointType,
             airdromeId = Airbase.ID,
             helipadId = Airbase.ID,
             action = enum AI.Task.TurnMethod,
@@ Line 38: / Line 39: @@
             ETA_locked = boolean,
             name = string,
-            task = Task
+            task = Task,
           },
           [2] = {
@@ Line 78: / Line 79: @@
 ''alt_type:'' Altitude type; Radio or Barometric. Defaults to barometric. If specified the altitude of the waypoint can be defined as AGL or MSL. Only applies to aircraft.
 ''helipadId:'' Used only for "Land" waypoint type. Specifies the helipadId the helicopter group will attempt to land at. AI will only land if helipad is friendly. If not provided the AI will land at the nearest valid base to the coordinates.
@@ Line 83: / Line 88: @@
 ''airdromeId:'' Used only for "Land" waypoint type. Specifies the airbaseId the aircraft group will attempt to land at. AI will only land if airbase is friendly. If not provided the AI will land at the nearest valid base to the coordinates.
-''task:'' All tasks, enroute tasks, commands, and options are defined here.
+''timeReFuAr: '' If the waypoint type is a landReFuAr this value determines how long in minutes the unit will be stationary for.
 |enum=

@@ Line 21: / Line 21: @@
     id = 'Mission',
     params = {
       route = {
         points = {
@@ Line 64: / Line 65: @@
 ''action:'' Waypoint action type. See [[DCS_enum_AI|AI enumerator page]] for more details.
-''alt:'' Altitude of waypoint. If converted from Vec3 this is the y coordinate. This item is required for Aircraft, but is optional for ground vehicles.
+''alt:'' Altitude of waypoint. If converted from Vec3 this is the y coordinate. This item is required for Aircraft, but is optional for ground vehicles. As of 2.5.6 this value can be set to negative numbers. Specifically this will submerge submarines.
 '''Optional Parameters''':
@@ Line 83: / Line 84: @@
 ''task:'' All tasks, enroute tasks, commands, and options are defined here.
 |enum=
@@ Line 93: / Line 93: @@
 |notes= See article [[Mission Editor: AI Tasking]] for more information on how AI tasking is handled within DCS.