Revert "Merge branch 'develop' into FF/Develop"

This reverts commit 1f282693b3, reversing
changes made to e16f306e1d.

Moose Development/Moose/AI/AI_Formation.lua

@@ -1,26 +1,26 @@
 --- **AI** -- Build large airborne formations of aircraft.
---
+-- 
 -- **Features:**
 --
 --   * Build in-air formations consisting of more than 40 aircraft as one group.
 --   * Build different formation types.
 --   * Assign a group leader that will guide the large formation path.
---
+-- 
 -- ===
---
+-- 
 -- ### [Demo Missions](https://github.com/FlightControl-Master/MOOSE_MISSIONS/tree/master/FOR%20-%20Formation)
---
+-- 
 -- ===
---
+-- 
 -- ### [YouTube Playlist](https://www.youtube.com/playlist?list=PL7ZUrU4zZUl0bFIJ9jIdYM22uaWmIN4oz)
---
+-- 
 -- ===
---
+-- 
 -- ### Author: **FlightControl**
--- ### Contributions:
---
+-- ### Contributions: 
+-- 
 -- ===
---
+--   
 -- @module AI.AI_Formation
 -- @image AI_Large_Formations.JPG
 
@@ -36,6 +36,7 @@
 -- @field #boolean ReportTargets If true, nearby targets are reported.
 -- @Field DCSTypes#AI.Option.Air.val.ROE OptionROE Which ROE is set to the FollowGroup.
 -- @field DCSTypes#AI.Option.Air.val.REACTION_ON_THREAT OptionReactionOnThreat Which REACTION_ON_THREAT is set to the FollowGroup.
+-- @field #number dtFollow Time step between position updates.
 
 
 --- Build large formations, make AI follow a @{Wrapper.Client#CLIENT} (player) leader or a @{Wrapper.Unit#UNIT} (AI) leader.
@@ -43,33 +44,33 @@
 -- AI_FORMATION makes AI @{GROUP}s fly in formation of various compositions.
 -- The AI_FORMATION class models formations in a different manner than the internal DCS formation logic!!!
 -- The purpose of the class is to:
---
+-- 
 --   * Make formation building a process that can be managed while in flight, rather than a task.
 --   * Human players can guide formations, consisting of larget planes.
 --   * Build large formations (like a large bomber field).
 --   * Form formations that DCS does not support off the shelve.
---
+-- 
 -- A few remarks:
---
+-- 
 --   * Depending on the type of plane, the change in direction by the leader may result in the formation getting disentangled while in flight and needs to be rebuild.
 --   * Formations are vulnerable to collissions, but is depending on the type of plane, the distance between the planes and the speed and angle executed by the leader.
 --   * Formations may take a while to build up.
---
+-- 
 -- As a result, the AI_FORMATION is not perfect, but is very useful to:
---
+-- 
 --   * Model large formations when flying straight line. You can build close formations when doing this.
 --   * Make humans guide a large formation, when the planes are wide from each other.
---
+--   
 -- ## AI_FORMATION construction
---
+-- 
 -- Create a new SPAWN object with the @{#AI_FORMATION.New} method:
 --
 --   * @{#AI_FORMATION.New}(): Creates a new AI_FORMATION object from a @{Wrapper.Group#GROUP} for a @{Wrapper.Client#CLIENT} or a @{Wrapper.Unit#UNIT}, with an optional briefing text.
 --
 -- ## Formation methods
---
+-- 
 -- The following methods can be used to set or change the formation:
---
+-- 
 --  * @{#AI_FORMATION.FormationLine}(): Form a line formation (core formation function).
 --  * @{#AI_FORMATION.FormationTrail}(): Form a trail formation.
 --  * @{#AI_FORMATION.FormationLeftLine}(): Form a left line formation.
@@ -79,9 +80,9 @@
 --  * @{#AI_FORMATION.FormationCenterWing}(): Form a center wing formation.
 --  * @{#AI_FORMATION.FormationCenterVic}(): Form a Vic formation (same as CenterWing.
 --  * @{#AI_FORMATION.FormationCenterBoxed}(): Form a center boxed formation.
---
+--  
 -- ## Randomization
---
+-- 
 -- Use the method @{AI.AI_Formation#AI_FORMATION.SetFlightRandomization}() to simulate the formation flying errors that pilots make while in formation. Is a range set in meters.
 --
 -- @usage
@@ -91,8 +92,8 @@
 -- local LargeFormation = AI_FORMATION:New( LeaderUnit, FollowGroupSet, "Center Wing Formation", "Briefing" )
 -- LargeFormation:FormationCenterWing( 500, 50, 0, 250, 250 )
 -- LargeFormation:__Start( 1 )
---
--- @field #AI_FORMATION
+-- 
+-- @field #AI_FORMATION 
 AI_FORMATION = {
   ClassName = "AI_FORMATION",
   FollowName = nil, -- The Follow Name
@@ -106,6 +107,7 @@ AI_FORMATION = {
   FollowScheduler = nil,
   OptionROE = AI.Option.Air.val.ROE.OPEN_FIRE,
   OptionReactionOnThreat = AI.Option.Air.val.REACTION_ON_THREAT.ALLOW_ABORT_MISSION,
+  dtFollow = 0.5,
 }
 
 --- AI_FORMATION.Mode class
@@ -133,14 +135,14 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
 
   self.FollowUnit = FollowUnit -- Wrapper.Unit#UNIT
   self.FollowGroupSet = FollowGroupSet -- Core.Set#SET_GROUP
-
+  
   self:SetFlightRandomization( 2 )
-
-  self:SetStartState( "None" )
+  
+  self:SetStartState( "None" ) 
 
   self:AddTransition( "*", "Stop", "Stopped" )
 
-  self:AddTransition( "None", "Start", "Following" )
+  self:AddTransition( {"None", "Stopped"}, "Start", "Following" )
 
   self:AddTransition( "*", "FormationLine", "*" )
   --- FormationLine Handler OnBefore for AI_FORMATION
@@ -157,7 +159,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationLine Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationLine
   -- @param #AI_FORMATION self
@@ -171,7 +173,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLine Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationLine
   -- @param #AI_FORMATION self
@@ -181,7 +183,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLine Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationLine
   -- @param #AI_FORMATION self
@@ -192,7 +194,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   self:AddTransition( "*", "FormationTrail", "*" )
   --- FormationTrail Handler OnBefore for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnBeforeFormationTrail
@@ -204,7 +206,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number XSpace The space between groups on the X-axis in meters for each sequent group.
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @return #boolean
-
+  
   --- FormationTrail Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationTrail
   -- @param #AI_FORMATION self
@@ -214,14 +216,14 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number XStart The start position on the X-axis in meters for the first group.
   -- @param #number XSpace The space between groups on the X-axis in meters for each sequent group.
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
-
+  
   --- FormationTrail Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationTrail
   -- @param #AI_FORMATION self
   -- @param #number XStart The start position on the X-axis in meters for the first group.
   -- @param #number XSpace The space between groups on the X-axis in meters for each sequent group.
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
-
+  
   --- FormationTrail Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationTrail
   -- @param #AI_FORMATION self
@@ -242,7 +244,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationStack Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationStack
   -- @param #AI_FORMATION self
@@ -253,7 +255,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number XSpace The space between groups on the X-axis in meters for each sequent group.
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
-
+  
   --- FormationStack Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationStack
   -- @param #AI_FORMATION self
@@ -261,7 +263,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number XSpace The space between groups on the X-axis in meters for each sequent group.
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
-
+  
   --- FormationStack Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationStack
   -- @param #AI_FORMATION self
@@ -271,7 +273,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
 
-  self:AddTransition( "*", "FormationLeftLine", "*" )
+  self:AddTransition( "*", "FormationLeftLine", "*" )  
   --- FormationLeftLine Handler OnBefore for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnBeforeFormationLeftLine
   -- @param #AI_FORMATION self
@@ -284,7 +286,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationLeftLine Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationLeftLine
   -- @param #AI_FORMATION self
@@ -296,7 +298,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLeftLine Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationLeftLine
   -- @param #AI_FORMATION self
@@ -304,7 +306,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLeftLine Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationLeftLine
   -- @param #AI_FORMATION self
@@ -314,7 +316,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
 
-  self:AddTransition( "*", "FormationRightLine", "*" )
+  self:AddTransition( "*", "FormationRightLine", "*" )  
   --- FormationRightLine Handler OnBefore for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnBeforeFormationRightLine
   -- @param #AI_FORMATION self
@@ -327,7 +329,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationRightLine Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationRightLine
   -- @param #AI_FORMATION self
@@ -339,7 +341,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationRightLine Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationRightLine
   -- @param #AI_FORMATION self
@@ -347,7 +349,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationRightLine Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationRightLine
   -- @param #AI_FORMATION self
@@ -371,7 +373,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationLeftWing Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationLeftWing
   -- @param #AI_FORMATION self
@@ -384,7 +386,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLeftWing Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationLeftWing
   -- @param #AI_FORMATION self
@@ -393,7 +395,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationLeftWing Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationLeftWing
   -- @param #AI_FORMATION self
@@ -403,7 +405,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   self:AddTransition( "*", "FormationRightWing", "*" )
   --- FormationRightWing Handler OnBefore for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnBeforeFormationRightWing
@@ -418,7 +420,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationRightWing Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationRightWing
   -- @param #AI_FORMATION self
@@ -431,7 +433,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationRightWing Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationRightWing
   -- @param #AI_FORMATION self
@@ -440,7 +442,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationRightWing Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationRightWing
   -- @param #AI_FORMATION self
@@ -450,7 +452,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer YStart The start position on the Y-axis in meters for the first group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   self:AddTransition( "*", "FormationCenterWing", "*" )
   --- FormationCenterWing Handler OnBefore for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnBeforeFormationCenterWing
@@ -466,7 +468,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationCenterWing Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationCenterWing
   -- @param #AI_FORMATION self
@@ -480,7 +482,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationCenterWing Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationCenterWing
   -- @param #AI_FORMATION self
@@ -490,7 +492,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationCenterWing Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationCenterWing
   -- @param #AI_FORMATION self
@@ -516,7 +518,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @return #boolean
-
+  
   --- FormationVic Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationVic
   -- @param #AI_FORMATION self
@@ -529,7 +531,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationVic Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationVic
   -- @param #AI_FORMATION self
@@ -539,7 +541,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number YSpace The space between groups on the Y-axis in meters for each sequent group.
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
-
+  
   --- FormationVic Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationVic
   -- @param #AI_FORMATION self
@@ -566,7 +568,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @param #number ZLevels The amount of levels on the Z-axis.
   -- @return #boolean
-
+  
   --- FormationBox Handler OnAfter for AI_FORMATION
   -- @function [parent=#AI_FORMATION] OnAfterFormationBox
   -- @param #AI_FORMATION self
@@ -580,7 +582,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @param #number ZLevels The amount of levels on the Z-axis.
-
+  
   --- FormationBox Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] FormationBox
   -- @param #AI_FORMATION self
@@ -591,7 +593,7 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @param #number ZLevels The amount of levels on the Z-axis.
-
+  
   --- FormationBox Asynchronous Trigger for AI_FORMATION
   -- @function [parent=#AI_FORMATION] __FormationBox
   -- @param #AI_FORMATION self
@@ -603,12 +605,12 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   -- @param #nubmer ZStart The start position on the Z-axis in meters for the first group.
   -- @param #number ZSpace The space between groups on the Z-axis in meters for each sequent group.
   -- @param #number ZLevels The amount of levels on the Z-axis.
-
-
+  
+ 
   self:AddTransition( "*", "Follow", "Following" )
 
   self:FormationLeftLine( 500, 0, 250, 250 )
-
+  
   self.FollowName = FollowName
   self.FollowBriefing = FollowBriefing
 
@@ -621,6 +623,16 @@ function AI_FORMATION:New( FollowUnit, FollowGroupSet, FollowName, FollowBriefin
   return self
 end
 
+
+--- Set time interval between updates of the formation.
+-- @param #AI_FORMATION self
+-- @param #number dt Time step in seconds between formation updates. Default is every 0.5 seconds.
+-- @return #AI_FORMATION
+function AI_FORMATION:SetFollowTimeInterval(dt) --R2.1
+  self.dtFollow=dt or 0.5
+  return self
+end
+
 --- This function is for test, it will put on the frequency of the FollowScheduler a red smoke at the direction vector calculated for the escort to fly to.
 -- This allows to visualize where the escort is flying to.
 -- @param #AI_FORMATION self
@@ -648,23 +660,23 @@ function AI_FORMATION:onafterFormationLine( FollowGroupSet, From , Event , To, X
   self:F( { FollowGroupSet, From , Event ,To, XStart, XSpace, YStart, YSpace, ZStart, ZSpace } )
 
   FollowGroupSet:Flush( self )
-
+  
   local FollowSet = FollowGroupSet:GetSet()
-
+  
   local i = 1  --FF i=0 caused first unit to have no XSpace! Probably needs further adjustments. This is just a quick work around.
-
+  
   for FollowID, FollowGroup in pairs( FollowSet ) do
-
+  
     local PointVec3 = POINT_VEC3:New()
     PointVec3:SetX( XStart + i * XSpace )
     PointVec3:SetY( YStart + i * YSpace )
     PointVec3:SetZ( ZStart + i * ZSpace )
-
+  
     local Vec3 = PointVec3:GetVec3()
     FollowGroup:SetState( self, "FormationVec3", Vec3 )
     i = i + 1
   end
-
+  
   return self
 
 end
@@ -800,25 +812,25 @@ end
 function AI_FORMATION:onafterFormationCenterWing( FollowGroupSet, From , Event , To, XStart, XSpace, YStart, YSpace, ZStart, ZSpace ) --R2.1
 
   local FollowSet = FollowGroupSet:GetSet()
-
+  
   local i = 0
-
+  
   for FollowID, FollowGroup in pairs( FollowSet ) do
-
+  
     local PointVec3 = POINT_VEC3:New()
-
+    
     local Side = ( i % 2 == 0 ) and 1 or -1
     local Row = i / 2 + 1
-
+    
     PointVec3:SetX( XStart + Row * XSpace )
     PointVec3:SetY( YStart )
     PointVec3:SetZ( Side * ( ZStart + i * ZSpace ) )
-
+  
     local Vec3 = PointVec3:GetVec3()
     FollowGroup:SetState( self, "FormationVec3", Vec3 )
     i = i + 1
   end
-
+  
   return self
 end
 
@@ -838,7 +850,7 @@ end
 function AI_FORMATION:onafterFormationVic( FollowGroupSet, From , Event , To, XStart, XSpace, YStart, YSpace, ZStart, ZSpace ) --R2.1
 
   self:onafterFormationCenterWing(FollowGroupSet,From,Event,To,XStart,XSpace,YStart,YSpace,ZStart,ZSpace)
-
+  
   return self
 end
 
@@ -858,21 +870,21 @@ end
 function AI_FORMATION:onafterFormationBox( FollowGroupSet, From , Event , To, XStart, XSpace, YStart, YSpace, ZStart, ZSpace, ZLevels ) --R2.1
 
   local FollowSet = FollowGroupSet:GetSet()
-
+  
   local i = 0
-
+  
   for FollowID, FollowGroup in pairs( FollowSet ) do
-
+  
     local PointVec3 = POINT_VEC3:New()
-
+    
     local ZIndex = i % ZLevels
     local XIndex = math.floor( i / ZLevels )
     local YIndex = math.floor( i / ZLevels )
-
+    
     PointVec3:SetX( XStart + XIndex * XSpace )
     PointVec3:SetY( YStart + YIndex * YSpace )
     PointVec3:SetZ( -ZStart - (ZSpace * ZLevels / 2 ) + ZSpace * ZIndex )
-
+  
     local Vec3 = PointVec3:GetVec3()
     FollowGroup:SetState( self, "FormationVec3", Vec3 )
     i = i + 1
@@ -889,7 +901,7 @@ end
 function AI_FORMATION:SetFlightRandomization( FlightRandomization ) --R2.1
 
   self.FlightRandomization = FlightRandomization
-
+  
   return self
 end
 
@@ -939,16 +951,16 @@ function AI_FORMATION:onenterFollowing( FollowGroupSet ) --R2.1
       CT2 = timer.getTime()
       CV1 = ClientUnit:GetState( self, "CV1" )
       CV2 = ClientUnit:GetPointVec3()
-
+      
       ClientUnit:SetState( self, "CT1", CT2 )
       ClientUnit:SetState( self, "CV1", CV2 )
     end
-
+        
     FollowGroupSet:ForEachGroup(
       --- @param Wrapper.Group#GROUP FollowGroup
       -- @param Wrapper.Unit#UNIT ClientUnit
       function( FollowGroup, Formation, ClientUnit, CT1, CV1, CT2, CV2 )
-
+        
         FollowGroup:OptionROTEvadeFire()
         FollowGroup:OptionROEReturnFire()
 
@@ -956,21 +968,21 @@ function AI_FORMATION:onenterFollowing( FollowGroupSet ) --R2.1
         local FollowFormation = FollowGroup:GetState( self, "FormationVec3" )
         if FollowFormation then
           local FollowDistance = FollowFormation.x
-
+          
           local GT1 = GroupUnit:GetState( self, "GT1" )
-
+      
           if CT1 == nil or CT1 == 0 or GT1 == nil or GT1 == 0 then
             GroupUnit:SetState( self, "GV1", GroupUnit:GetPointVec3() )
-            GroupUnit:SetState( self, "GT1", timer.getTime() )
+            GroupUnit:SetState( self, "GT1", timer.getTime() ) 
           else
             local CD = ( ( CV2.x - CV1.x )^2 + ( CV2.y - CV1.y )^2 + ( CV2.z - CV1.z )^2 ) ^ 0.5
             local CT = CT2 - CT1
-
+      
             local CS = ( 3600 / CT ) * ( CD / 1000 ) / 3.6
 
             local CDv = { x = CV2.x - CV1.x, y = CV2.y - CV1.y, z = CV2.z - CV1.z }
             local Ca = math.atan2( CDv.x, CDv.z )
-
+      
             local GT1 = GroupUnit:GetState( self, "GT1" )
             local GT2 = timer.getTime()
             local GV1 = GroupUnit:GetState( self, "GV1" )
@@ -980,29 +992,29 @@ function AI_FORMATION:onenterFollowing( FollowGroupSet ) --R2.1
             GV2:AddZ( math.random( -Formation.FlightRandomization / 2, Formation.FlightRandomization / 2 ) )
             GroupUnit:SetState( self, "GT1", GT2 )
             GroupUnit:SetState( self, "GV1", GV2 )
-
-
+            
+      
             local GD = ( ( GV2.x - GV1.x )^2 + ( GV2.y - GV1.y )^2 + ( GV2.z - GV1.z )^2 ) ^ 0.5
             local GT = GT2 - GT1
-
+      
 
             -- Calculate the distance
             local GDv =  { x = GV2.x - CV1.x, y =  GV2.y - CV1.y, z = GV2.z - CV1.z }
-            local Alpha_T = math.atan2( GDv.x, GDv.z ) - math.atan2( CDv.x, CDv.z )
+            local Alpha_T = math.atan2( GDv.x, GDv.z ) - math.atan2( CDv.x, CDv.z ) 
             local Alpha_R = ( Alpha_T < 0 ) and Alpha_T + 2 * math.pi or Alpha_T
             local Position = math.cos( Alpha_R )
             local GD = ( ( GDv.x )^2 + ( GDv.z )^2 ) ^ 0.5
             local Distance = GD * Position + - CS * 0.5
-
+      
             -- Calculate the group direction vector
             local GV = { x = GV2.x - CV2.x, y = GV2.y - CV2.y, z = GV2.z - CV2.z  }
-
+      
             -- Calculate GH2, GH2 with the same height as CV2.
             local GH2 = { x = GV2.x, y = CV2.y + FollowFormation.y, z = GV2.z }
-
+      
             -- Calculate the angle of GV to the orthonormal plane
             local alpha = math.atan2( GV.x, GV.z )
-
+      
             local GVx = FollowFormation.z * math.cos( Ca ) + FollowFormation.x * math.sin( Ca )
             local GVz = FollowFormation.x * math.cos( Ca ) - FollowFormation.z * math.sin( Ca )
 
@@ -1013,36 +1025,36 @@ function AI_FORMATION:onenterFollowing( FollowGroupSet ) --R2.1
               y = GH2.y - ( Distance + FollowFormation.x ) / 5, -- + FollowFormation.y,
               z = CV2.z + CS * 10 * math.cos(Ca),
             }
-
+      
             -- Calculate the direction vector DV of the escort group. We use CVI as the base and CV2 as the direction.
             local DV = { x = CV2.x - CVI.x, y = CV2.y - CVI.y, z = CV2.z - CVI.z }
-
+      
             -- We now calculate the unary direction vector DVu, so that we can multiply DVu with the speed, which is expressed in meters / s.
             -- We need to calculate this vector to predict the point the escort group needs to fly to according its speed.
             -- The distance of the destination point should be far enough not to have the aircraft starting to swipe left to right...
             local DVu = { x = DV.x / FollowDistance, y = DV.y, z = DV.z / FollowDistance }
-
+      
             -- Now we can calculate the group destination vector GDV.
             local GDV = { x = CVI.x, y = CVI.y, z = CVI.z }
-
+            
             local ADDx = FollowFormation.x * math.cos(alpha) - FollowFormation.z * math.sin(alpha)
             local ADDz = FollowFormation.z * math.cos(alpha) + FollowFormation.x * math.sin(alpha)
-
-            local GDV_Formation = {
-              x = GDV.x - GVx,
-              y = GDV.y,
+            
+            local GDV_Formation = { 
+              x = GDV.x - GVx, 
+              y = GDV.y, 
               z = GDV.z - GVz
             }
-
+            
             if self.SmokeDirectionVector == true then
               trigger.action.smoke( GDV, trigger.smokeColor.Green )
               trigger.action.smoke( GDV_Formation, trigger.smokeColor.White )
             end
-
-
-
+            
+            
+            
             local Time = 60
-
+            
             local Speed = - ( Distance + FollowFormation.x ) / Time
             local GS = Speed + CS
             if Speed < 0 then
@@ -1056,8 +1068,9 @@ function AI_FORMATION:onenterFollowing( FollowGroupSet ) --R2.1
       end,
       self, ClientUnit, CT1, CV1, CT2, CV2
     )
-
-    self:__Follow( -0.5 )
+    
+    self:__Follow( -self.dtFollow )
   end
-
+  
 end
+