Demo Missions
-AI_A2A_DISPATCHER Demo Mission
- -AI_A2A_DISPATCHER Mission, only for beta testers
- -ALL Demo Missions pack of the last release
+AI_A2A_DISPATCHER Demo Missions
@@ -1042,7 +1038,7 @@ DetectionSetGroup = SET_GROUP:New() DetectionSetGroup:FilterPrefixes( { "DF CCCP AWACS", "DF CCCP EWR" } ) DetectionSetGroup:FilterStart() --- Setup the detection. +-- Setup the detection and group targets to a 30km range! Detection = DETECTION_AREAS:New( DetectionSetGroup, 30000 ) -- Setup the A2A dispatcher, and initialize it. @@ -1072,41 +1068,60 @@ Typically I suggest to use 30000 for new generation planes and 10000 for older e
Note that detected targets are constantly re-grouped, that is, when certain detected aircraft are moving further than the group radius, then these aircraft will become a separate group being detected. This may result in additional GCI being started by the dispatcher! So don't make this value too small!
-3. Set the Engage radius:
+3. Set the Engage Radius:
-Define the radius to engage any target by airborne friendlies, which are executing cap or returning from an intercept mission.
+Define the Engage Radius to engage any target by airborne friendlies, +which are executing cap or returning from an intercept mission.
So, if there is a target area detected and reported, +
If there is a target area detected and reported, then any friendlies that are airborne near this target area, -will be commanded to (re-)engage that target when available (if no other tasks were commanded). -For example, if 100000 is given as a value, then any friendly that is airborne within 100km from the detected target, -will be considered to receive the command to engage that target area. -You need to evaluate the value of this parameter carefully. -If too small, more intercept missions may be triggered upon detected target areas. -If too large, any airborne cap may not be able to reach the detected target area in time, because it is too far.
+will be commanded to (re-)engage that target when available (if no other tasks were commanded). -In this example an engage radius is set to 80 km.
+For example, if 50000 or 50km is given as a value, then any friendly that is airborne within 50km from the detected target, +will be considered to receive the command to engage that target area.
+ +You need to evaluate the value of this parameter carefully:
+ +-
+
- If too small, more intercept missions may be triggered upon detected target areas. +
- If too large, any airborne cap may not be able to reach the detected target area in time, because it is too far. +
The default Engage Radius is defined as 100000 or 100km. +Use the method AIA2ADISPATCHER.SetEngageRadius() to set a specific Engage Radius. +The Engage Radius is defined for ALL squadrons which are operational.
+ +In this example an Engage Radius is set to 80km.
-- Initialize the dispatcher, setting up a radius of 80km where any airborne friendly
-- without an assignment within 80km radius from a detected target, will engage that target.
A2ADispatcher:SetEngageRadius( 80000 )
4. Set the Intercept radius or Gci radius:
+4. Set the Ground Controlled Intercept Radius or Gci radius:
When targets are detected that are still really far off, you don't want the AIA2ADISPATCHER to launch intercepts just yet. -You want it to wait until a certain intercept range is reached, which is the distance of the closest airbase to targer being smaller than the Gci radius. -The Gci radius is by default defined as 200km. This value can be overridden using the method AIA2ADISPATCHER.SetGciRadius(). -Override the default Gci radius when the era of the warfare is early, or, when you don't want to let the AIA2ADISPATCHER react immediately when -a certain border or area is not being crossed.
+You want it to wait until a certain Gci range is reached, which is the distance of the closest airbase to target +being smaller than the Ground Controlled Intercept radius or Gci radius. -In this example, the GCI radius is setto 150 km:
+The default Gci radius is defined as 200000 or 200km. Override the default Gci radius when the era of the warfare is early, or, +when you don't want to let the AIA2ADISPATCHER react immediately when a certain border or area is not being crossed.
--- Initialize the dispatcher, setting up a GCI radius of 150km where no GCI will be started if the target is further than 150 km from the closest airabse.
-A2ADispatcher:SetGciRadius( 80000 )
-Use the method AIA2ADISPATCHER.SetGciRadius() to set a specific controlled ground intercept radius. +The Ground Controlled Intercept radius is defined for ALL squadrons which are operational.
+ +In these examples, the Gci Radius is set to various values:
+ +-- Now Setup the A2A dispatcher, and initialize it using the Detection object. + A2ADispatcher = AIA2ADISPATCHER:New( Detection )
+ +-- Set 100km as the radius to ground control intercept detected targets from the nearest airbase. + A2ADispatcher:SetGciRadius( 100000 )
+ +-- Set 200km as the radius to ground control intercept. + A2ADispatcher:SetGciRadius() -- 200000 is the default value.
5. Set the borders:
@@ -1115,7 +1130,8 @@ They should be laid out such that a border area is created between the two coali
Define a border area to simulate a cold war scenario and use the method AIA2ADISPATCHER.SetBorderZone() to create a border zone for the dispatcher.
+Define a border area to simulate a cold war scenario. +Use the method AIA2ADISPATCHER.SetBorderZone() to create a border zone for the dispatcher.
A cold war is one where CAP aircraft patrol their territory but will not attack enemy aircraft or launch GCI aircraft unless enemy aircraft enter their territory. In other words the EWR may detect an enemy aircraft but will only send aircraft to attack it if it crosses the border. A hot war is one where CAP aircraft will intercept any detected enemy aircraft and GCI aircraft will launch against detected enemy aircraft without regard for territory. In other words if the ground radar can detect the enemy aircraft then it will send CAP and GCI aircraft to attack it.
@@ -1229,7 +1245,7 @@ And for a couple of squadrons overrides this default method. -6.1.1. Takeoff Altitude when spawning new aircraft in the air.
+6.1. Set Squadron takeoff altitude when spawning new aircraft in the air.
In the case of the AIA2ADISPATCHER.SetSquadronTakeoffInAir() there is also an other parameter that can be applied. That is modifying or setting the altitude from where planes spawn in the air. @@ -1585,12 +1601,12 @@ This time can easily take 2 to 3 minutes, and even then the defenders still need
Use the method AIA2ADISPATCHER.SetIntercept() to modify the assumed intercept delay time to calculate a valid interception.
-10.8.2. Default disengage radius.
+10.8.2. Default Disengage Radius.
The radius to disengage any target when the distance of the defender to the home base is larger than the specified meters. -The default disengage radius is 300km (300000 meters). Note that the disengage radius is applicable to ALL squadrons!
+The default Disengage Radius is 300km (300000 meters). Note that the Disengage Radius is applicable to ALL squadrons! -Use the method AIA2ADISPATCHER.SetDisengageRadius() to modify the default disengage radius to another distance setting.
+Use the method AIA2ADISPATCHER.SetDisengageRadius() to modify the default Disengage Radius to another distance setting.
11. Q & A:
@@ -3959,10 +3975,10 @@ A string defining the group name of the Tanker as defined within the Mission EdiUsage:
- -- Set 50km as the disengage radius.
+ -- Set 50km as the Disengage Radius.
Dispatcher:SetDisengageRadius( 50000 )
- -- Set 100km as the disengage radius.
+ -- Set 100km as the Disengage Radius.
Dispatcher:SetDisngageRadius() -- 300000 is the default value.
Define the radius to engage any target by airborne friendlies, which are executing cap or returning from an intercept mission.
-So, if there is a target area detected and reported, -then any friendlies that are airborne near this target area, -will be commanded to (re-)engage that target when available (if no other tasks were commanded). -For example, if 100000 is given as a value, then any friendly that is airborne within 100km from the detected target, -will be considered to receive the command to engage that target area. -You need to evaluate the value of this parameter carefully. -If too small, more intercept missions may be triggered upon detected target areas. -If too large, any airborne cap may not be able to reach the detected target area in time, because it is too far.
+If there is a target area detected and reported, then any friendlies that are airborne near this target area, +will be commanded to (re-)engage that target when available (if no other tasks were commanded).
+ +For example, if 100000 is given as a value, then any friendly that is airborne within 100km from the detected target, +will be considered to receive the command to engage that target area.
+ +You need to evaluate the value of this parameter carefully:
+ +-
+
- If too small, more intercept missions may be triggered upon detected target areas. +
- If too large, any airborne cap may not be able to reach the detected target area in time, because it is too far. +
**Use the method AIA2ADISPATCHER.SetEngageRadius() to modify the default Engage Radius for ALL squadrons.**
+Parameter
-
@@ -4026,14 +4049,16 @@ If too large, any airborne cap may not be able to reach the detected target area
Define the radius to check if a target can be engaged by an ground controlled intercept.
-So, if there is a target area detected and reported, -and a GCI is to be executed, -then it will be check if the target is within the GCI from the nearest airbase. -For example, if 150000 is given as a value, then any airbase within 150km from the detected target, -will be considered to receive the command to GCI. -You need to evaluate the value of this parameter carefully. -If too small, intercept missions may be triggered too late. -If too large, intercept missions may be triggered when the detected target is too far.
+When targets are detected that are still really far off, you don't want the AIA2ADISPATCHER to launch intercepts just yet. +You want it to wait until a certain Gci range is reached, which is the distance of the closest airbase to target +being smaller than the Ground Controlled Intercept radius or Gci radius.
+ +The default Gci radius is defined as 200000 or 200km. Override the default Gci radius when the era of the warfare is early, or, +when you don't want to let the AIA2ADISPATCHER react immediately when a certain border or area is not being crossed.
+ +Use the method AIA2ADISPATCHER.SetGciRadius() to set a specific controlled ground intercept radius. +The Ground Controlled Intercept radius is defined for ALL squadrons which are operational.
+Parameter
-
@@ -4052,7 +4077,7 @@ If too large, intercept missions may be triggered when the detected target is to
Usage:
-- Now Setup the A2A dispatcher, and initialize it using the Detection object.
- A2ADispatcher = AI_A2A_DISPATCHER:New( Detection ) --
+ A2ADispatcher = AI_A2A_DISPATCHER:New( Detection )
-- Set 100km as the radius to ground control intercept detected targets from the nearest airbase.
A2ADispatcher:SetGciRadius( 100000 )
@@ -5171,7 +5196,7 @@ Provide a value of true to display every 30 seconds a tactical
-
-AI_A2A_DISPATCHER:onafterENGAGE(From, Event, To, Target, AIGroups)
+AI_A2A_DISPATCHER:onafterENGAGE(From, Event, To, Target, Defenders)
-
@@ -5202,7 +5227,7 @@ Provide a value of true to display every 30 seconds a tactical
-
-
AIGroups :
+ Defenders :
diff --git a/docs/Documentation/AI_Patrol.html b/docs/Documentation/AI_Patrol.html
index fa84b7673..1e25ded90 100644
--- a/docs/Documentation/AI_Patrol.html
+++ b/docs/Documentation/AI_Patrol.html
@@ -926,6 +926,9 @@ Use the method AIPATROLZONE.M
+
+ This table contains the targets detected during patrol.
+
diff --git a/docs/Documentation/Designate.html b/docs/Documentation/Designate.html
index 36c6d0e0f..c80c67564 100644
--- a/docs/Documentation/Designate.html
+++ b/docs/Documentation/Designate.html
@@ -923,7 +923,6 @@ function below will use the range 1-7 just in case
-
-
DESIGNATE.LaserCodes
diff --git a/docs/Documentation/Detection.html b/docs/Documentation/Detection.html
index d30bf87be..e4dbeaf3a 100644
--- a/docs/Documentation/Detection.html
+++ b/docs/Documentation/Detection.html
@@ -2477,6 +2477,7 @@ The index of the DetectedItem.
-
+ #number
DETECTION_BASE.DetectedItemMax
diff --git a/docs/Documentation/Fsm.html b/docs/Documentation/Fsm.html
index e0276d335..177f34281 100644
--- a/docs/Documentation/Fsm.html
+++ b/docs/Documentation/Fsm.html
@@ -1598,7 +1598,7 @@ A string defining the start state.
-
-
+ #string
FSM._StartState
@@ -1897,7 +1897,6 @@ A string defining the start state.
-
-
FSM.current
diff --git a/docs/Documentation/Positionable.html b/docs/Documentation/Positionable.html
index 78befb2bf..82d94f58f 100644
--- a/docs/Documentation/Positionable.html
+++ b/docs/Documentation/Positionable.html
@@ -1838,6 +1838,7 @@ self
-
+ Core.Spot#SPOT
POSITIONABLE.Spot
diff --git a/docs/Documentation/Settings.html b/docs/Documentation/Settings.html
index 6836574d8..318968720 100644
--- a/docs/Documentation/Settings.html
+++ b/docs/Documentation/Settings.html
@@ -1142,7 +1142,7 @@ true if metric.
-
- #boolean
+
SETTINGS.Metric
diff --git a/docs/Documentation/Spawn.html b/docs/Documentation/Spawn.html
index d7a5ea071..97ff2d108 100644
--- a/docs/Documentation/Spawn.html
+++ b/docs/Documentation/Spawn.html
@@ -822,6 +822,12 @@ and any spaces before and after the resulting name are removed.
SPAWN:_TranslateRotate(SpawnIndex, SpawnRootX, SpawnRootY, SpawnX, SpawnY, SpawnAngle)
+
+
By default, no InitLimit
+