Module Ops.ArmyGroup

self

ARMYGROUP:AddTaskAttackGroup(TargetGroup, WeaponExpend, WeaponType, Clock, Prio)

Add a scheduled task.

Defined in:

ARMYGROUP

Parameters:

Wrapper.Group#GROUP TargetGroup

Target group.

#number WeaponExpend

How much weapons does are used.

#number WeaponType

Type of weapon. Default auto.

#string Clock

Time when to start the attack.

#number Prio

Priority of the task.

Return value:

The task table.

ARMYGROUP:AddTaskBarrage(Clock, Heading, Alpha, Altitude, Radius, Nshots, WeaponType, Prio)

Add a scheduled task to fire at a given coordinate.

Defined in:

ARMYGROUP

Parameters:

#string Clock

Time when to start the attack.

#number Heading

Heading min in Degrees.

#number Alpha

Shooting angle in Degrees.

#number Altitude

Altitude in meters.

#number Radius

Radius in meters. Default 100 m.

#number Nshots

Number of shots to fire. Default nil.

#number WeaponType

Type of weapon. Default auto.

#number Prio

Priority of the task.

Return value:

The task table.

ARMYGROUP:AddTaskCargoGroup(GroupSet, PickupZone, DeployZone, Clock, Prio)

Add a scheduled task to transport group(s).

Defined in:

ARMYGROUP

Parameters:

Core.Set#SET_GROUP GroupSet

Set of cargo groups. Can also be a singe Wrapper.Group#GROUP object.

Core.Zone#ZONE PickupZone

Zone where the cargo is picked up.

Core.Zone#ZONE DeployZone

Zone where the cargo is delivered to.

#string Clock

Time when to start the attack.

#number Prio

Priority of the task.

Return value:

The task table.

ARMYGROUP:AddTaskFireAtPoint(Coordinate, Clock, Radius, Nshots, WeaponType, Prio)

Add a scheduled task to fire at a given coordinate.

Defined in:

ARMYGROUP

Parameters:

Core.Point#COORDINATE Coordinate

Coordinate of the target.

#string Clock

Time when to start the attack.

#number Radius

Radius in meters. Default 100 m.

#number Nshots

Number of shots to fire. Default 3.

#number WeaponType

Type of weapon. Default auto.

#number Prio

Priority of the task.

Return value:

The task table.

ARMYGROUP:AddTaskWaypointFireAtPoint(Coordinate, Waypoint, Radius, Nshots, WeaponType, Prio)

Add a waypoint task to fire at a given coordinate.

Defined in:

ARMYGROUP

Parameters:

Core.Point#COORDINATE Coordinate

Coordinate of the target.

Ops.OpsGroup#OPSGROUP.Waypoint Waypoint

Where the task is executed. Default is next waypoint.

#number Radius

Radius in meters. Default 100 m.

#number Nshots

Number of shots to fire. Default 3.

#number WeaponType

Type of weapon. Default auto.

#number Prio

Priority of the task.

Return value:

Ops.OpsGroup#OPSGROUP.Waypoint:

The task table.

ARMYGROUP:AddWaypoint(Coordinate, Speed, AfterWaypointWithID, Formation, Updateroute)

Add an a waypoint to the route.

Defined in:

ARMYGROUP

Parameters:

Core.Point#COORDINATE Coordinate

The coordinate of the waypoint.

#number Speed

Speed in knots. Default is default cruise speed or 70% of max speed.

#number AfterWaypointWithID

Insert waypoint after waypoint given ID. Default is to insert as last waypoint.

#string Formation

Formation the group will use.

#boolean Updateroute

If true or nil, call UpdateRoute. If false, no call.

Return value:

Waypoint table.

ARMYGROUP:Cruise(Speed, Formation)

Pseudo Functions ---
Triggers the FSM event "Cruise".

Defined in:

ARMYGROUP

Parameters:

#number Speed

Speed in knots until next waypoint is reached.

#number Formation

Return values:

Wrapper.Group#GROUP:

Closest ammo supplying group or nil if no group is in the given radius.

#number:

Distance to closest group in meters.

Defined in:

ARMYGROUP

Return value:

self

ARMYGROUP:OnAfterCruise(From, Event, To, Speed, Formation)

On after "Cruise" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

ARMYGROUP

Parameters:

#string From

From state.

ARMYGROUP

Parameter:

Core.Event#EVENTDATA EventData

Event data.

Defined in:

ARMYGROUP

ARMYGROUP:Rearm(Coordinate, Formation)

Triggers the FSM event "Rearm".

Defined in:

ARMYGROUP

Parameters:

Core.Point#COORDINATE Coordinate

Coordinate where to rearm.

#number Formation

Group patrols ad inifintum.

If the last waypoint is reached, it will go to waypoint one and repeat its route.

Defined in:

ARMYGROUP

Parameter:

#boolean switch

If true or nil, patrol until the end of time. If false, go along the waypoints once and stop.

Return value:

self

ARMYGROUP:SetRetreatZones(RetreatZoneSet)

Define a set of possible retreat zones.

Defined in:

ARMYGROUP

Parameter:

Core.Set#SET_ZONE RetreatZoneSet

The retreat zone set. Default is an empty set.

Return value:

self

Defined in:

ARMYGROUP

ARMYGROUP:SwitchFormation(Formation, Permanently, NoRouteUpdate)

Switch to a specific formation.

Defined in:

ARMYGROUP

Parameters:

#number Formation

New formation the group will fly in. Default is the setting of SetDefaultFormation().

#boolean Permanently

If true, formation always used from now on.

#boolean NoRouteUpdate

If true, route is not updated.

Return value:

self

ARMYGROUP:_InitGroup(Template)

Initialize group parameters.

Also initializes waypoints if self.waypoints is nil.

Defined in:

ARMYGROUP

Parameter:

#table Template

Template used to init the group. Default is self.template.

Return value:

self

ARMYGROUP:_UpdateEngageTarget()

Update engage target.

Defined in:

ARMYGROUP

ARMYGROUP:__Cruise(delay, Speed, Formation)

Triggers the FSM event "Cruise" after a delay.

Defined in:

ARMYGROUP

Parameters:

#number delay

Delay in seconds.

ARMYGROUP

Parameters:

#number delay

Delay in seconds.

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#number Speed

Speed in knots.

#number Formation

Formation.

ARMYGROUP:onafterDetour(From, Event, To, Coordinate, Speed, Formation, ResumeRoute)

On after "Detour" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

(Optional) Speed to waypoint in knots.

#number Formation

(Optional) Formation to waypoint.

ARMYGROUP:onafterOutOfAmmo(From, Event, To)

On after "OutOfAmmo" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterRTZ(From, Event, To, Zone, Formation)

On after "RTZ" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Core.Zone#ZONE Zone

The zone to return to.

#number Formation

Formation of the group.

ARMYGROUP:onafterRearm(From, Event, To, Coordinate, Formation)

On after "Rearm" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

ARMYGROUP

Parameters:

#string From

From state.

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#number n

Next waypoint index. Default is the one coming after that one that has been passed last.

#number N

Waypoint Max waypoint index to be included in the route. Default is the final waypoint.

#number Speed

Speed in knots. Default cruise speed.

#number Formation

Formation of the group.

ARMYGROUP:onbeforeEngageTarget(From, Event, To, Group, Target)

On after "EngageTarget" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Wrapper.Group#GROUP Group

the group to be engaged.

Target

ARMYGROUP:onbeforeRearm(From, Event, To, Coordinate, Formation)

On before "Rearm" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Core.Point#COORDINATE Coordinate

Coordinate where to rearm.

#number Formation

Formation of the group.

ARMYGROUP:onbeforeRetreat(From, Event, To, Zone, Formation)

On before "Retreat" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Core.Zone#ZONE_BASE Zone

(Optional) Zone where to retreat. Default is the closest retreat zone.

#number Formation

(Optional) Formation of the group.

ARMYGROUP:onbeforeUpdateRoute(From, Event, To, n, N, Speed, Formation)

On before "UpdateRoute" event.

Defined in:

ARMYGROUP

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#number n

Next waypoint index. Default is the one coming after that one that has been passed last.

#number N

Waypoint Max waypoint index to be included in the route. Default is the final waypoint.

#number Speed

Speed in knots. Default cruise speed.

#number Formation

Formation of the group.

Field(s)

#boolean ARMYGROUP.adinfinitum

Resume route at first waypoint when final waypoint is reached.

ARMYGROUP.ammo

Group ammo.

#ARMYGROUP.Target ARMYGROUP.engage

Engage target.

#boolean ARMYGROUP.formationPerma

Formation that is used permanently and overrules waypoint formations.

#boolean ARMYGROUP.groupinitialized

Init done.

#boolean ARMYGROUP.isAI

Ground are always AI.

#boolean ARMYGROUP.isDead

Not dead or destroyed yet.

#boolean ARMYGROUP.isDestroyed

ARMYGROUP.isLateActivated

Is (template) group late activated.

#boolean ARMYGROUP.isMobile

If true, group is mobile.

#boolean ARMYGROUP.isUncontrolled

Ground groups cannot be uncontrolled.

ARMYGROUP.lid

Set some string id for output to DCS.log file.

#boolean ARMYGROUP.retreatOnOutOfAmmo

If true, the group will automatically retreat when out of ammo. Needs a retreat zone!

Core.Set#SET_ZONE ARMYGROUP.retreatZones

Set of retreat zones.

ARMYGROUP.speedMax

Max speed in km/h.

ARMYGROUP.speedWp

Current set speed in m/s.

ARMYGROUP.tacan

ARMYGROUP.timerCheckZone

Start check zone timer.

ARMYGROUP.timerQueueUpdate

Start queue update timer.

ARMYGROUP.timerStatus

Start the status monitoring.

#string ARMYGROUP.version

Army Group version.

Function(s)

Defined in:

Parameter:

#number delay

(Optional) Delay in seconds before the group is activated. Default is immediately.

Return value:

self

ARMYGROUP:AddCheckZone(CheckZone)

Add a zone that triggers and event if the group enters or leaves any of the zones.

Defined in:

Parameter:

Core.Zone#ZONE CheckZone

Zone to check.

Return value:

self

Defined in:

Parameter:

Ops.Auftrag#AUFTRAG Mission

Mission for this group.

Return value:

self

ARMYGROUP:AddOpsTransport(OpsTransport)

Create a cargo transport assignment.

Defined in:

Parameter:

Ops.OpsTransport#OPSTRANSPORT OpsTransport

The troop transport assignment.

Return value:

self

ARMYGROUP:AddTask(task, clock, description, prio, duration)

Add a scheduled task.

Defined in:

Parameters:

#table task

DCS task table structure.

#string clock

Mission time when task is executed. Default in 5 seconds. If argument passed as #number, it defines a relative delay in seconds.

#string description

Brief text describing the task, e.g. "Attack SAM".

#number prio

Priority of the task.

#number duration

Duration before task is cancelled in seconds counted after task started. Default never.

Return value:

#OPSGROUP.Task:

The task structure.

ARMYGROUP:AddTaskEnroute(task)

Add an enroute task.

Defined in:

Parameter:

#table task

DCS task table structure.

ARMYGROUP:AddTaskWaypoint(task, Waypoint, description, prio, duration)

Add a waypoint task.

Defined in:

Parameters:

#table task

DCS task table structure.

#OPSGROUP.Waypoint Waypoint

where the task is executed. Default is the at next waypoint.

#string description

Brief text describing the task, e.g. "Attack SAM".

#number prio

Priority of the task. Number between 1 and 100. Default is 50.

#number duration

Duration before task is cancelled in seconds counted after task started. Default never.

Return value:

#OPSGROUP.Task:

The task structure.

ARMYGROUP:AddWeaponRange(RangeMin, RangeMax, BitType)

Add a weapon range for ARTY auftrag.

Defined in:

Parameters:

#number RangeMin

Minimum range in nautical miles. Default 0 NM.

#number RangeMax

Maximum range in nautical miles. Default 10 NM.

#number BitType

Bit mask of weapon type for which the given min/max ranges apply. Default is ENUMS.WeaponFlag.Auto, i.e. for all weapon types.

Return value:

self

ARMYGROUP:AddWeightCargo(UnitName, Weight)

Add weight to the internal cargo of an element of the group.

Defined in:

Parameters:

#string UnitName

Name of the unit. Default is of the whole group.

#number Weight

Cargo weight to be added in kg.

ARMYGROUP:CanCargo(CargoGroup)

Check if the group can in principle be carrier of a cargo group.

This checks the max cargo capacity of the group but not how much cargo is already loaded (if any). Note that the cargo group cannot be split into units, i.e. the largest cargo bay of any element of the group must be able to load the whole cargo group in one piece.

Defined in:

Parameter:

#OPSGROUP CargoGroup

Cargo group, which needs a carrier.

Return value:

#boolean:

If true, there is an element of the group that can load the whole cargo group.

ARMYGROUP:CheckTaskDescriptionUnique(description)

Check if task description is unique.

Defined in:

Parameter:

#string description

Task destription

Return value:

#boolean:

If true, no other task has the same description.

ARMYGROUP:ClearTasks()

Clear DCS tasks.

Defined in:

Return value:

self

ARMYGROUP:ClearWaypoints(IndexMin, IndexMax)

Clear waypoints.

Defined in:

Parameters:

#number IndexMin

Clear waypoints up to this min WP index. Default 1.

#number IndexMax

Clear waypoints up to this max WP index. Default #self.waypoints.

ARMYGROUP:CountElements(States)

Count elements of the group.

Defined in:

Parameter:

#table States

(Optional) Only count elements in specific states. Can also be a single state passed as #string.

Return value:

#number:

Number of elements.

ARMYGROUP:CountRemainingMissison()

Count remaining missons.

Defined in:

Return value:

#number:

Number of missions to be done.

ARMYGROUP:CountRemainingTasks()

Count the number of tasks that still pending in the queue.

Defined in:

Return values:

#number:

Total number of tasks remaining.

#number:

Number of SCHEDULED tasks remaining.

#number:

Number of WAYPOINT tasks remaining.

ARMYGROUP:CountRemainingTransports()

Count remaining cargo transport assignments.

Defined in:

Return value:

#number:

Number of unfinished transports in the queue.

ARMYGROUP:CountTasksWaypoint(uid, id)

Count remaining waypoint tasks.

Defined in:

Parameters:

#number uid

Unique waypoint ID.

Return value:

#number:

Number of waypoint tasks.

ARMYGROUP:Deactivate(delay)

Deactivate the group.

Group will be respawned in late activated state.

Defined in:

Parameter:

#number delay

(Optional) Delay in seconds before the group is deactivated. Default is immediately.

Return value:

self

ARMYGROUP:DelOpsTransport(CargoTransport)

Delete a cargo transport assignment from the cargo queue.

Defined in:

Parameter:

Ops.OpsTransport#OPSTRANSPORT CargoTransport

Cargo transport do be deleted.

Return value:

self

ARMYGROUP:Despawn(Delay, NoEventRemoveUnit)

Despawn the group.

The whole group is despawned and a "Remove Unit" event is generated for all current units of the group. If no Remove Unit event should be generated, the second optional parameter needs to be set to true. If this group belongs to an AIRWING, BRIGADE or FLEET, it will be added to the warehouse stock if the NoEventRemoveUnit parameter is false or nil.

Defined in:

Parameters:

#number Delay

Delay in seconds before the group will be despawned. Default immediately.

#boolean NoEventRemoveUnit

If true, no event "Remove Unit" is generated.

Return value:

self

ARMYGROUP:DespawnElement(Element, Delay, NoEventRemoveUnit)

Despawn an element/unit of the group.

Defined in:

Parameters:

#OPSGROUP.Element Element

The element that will be despawned.

#number Delay

Delay in seconds before the element will be despawned. Default immediately.

#boolean NoEventRemoveUnit

If true, no event "Remove Unit" is generated.

Return value:

self

ARMYGROUP:DespawnUnit(UnitName, Delay, NoEventRemoveUnit)

Despawn a unit of the group.

A "Remove Unit" event is generated by default.

Defined in:

Parameters:

#string UnitName

Name of the unit

#number Delay

Delay in seconds before the group will be despawned. Default immediately.

#boolean NoEventRemoveUnit

If true, no event "Remove Unit" is generated.

Return value:

self

ARMYGROUP:Destroy(Delay)

Destroy group.

The whole group is despawned and a Unit Lost for aircraft or Dead event for ground/naval units is generated for all current units.

Defined in:

Parameter:

#number Delay

#table:

Cargo ops groups.

ARMYGROUP:GetCargoOpsGroups()

Get OPSGROUPs in the cargo bay.

Defined in:

Return value:

#table:

Cargo OPSGROUPs.

ARMYGROUP:GetCoalition()

Get coalition.

Defined in:

Return value:

#number:

Coalition side of carrier.

ARMYGROUP:GetCoordinate(NewObject)

Get current coordinate of the group.

If the current position cannot be determined, the last known position is returned.

Defined in:

Parameter:

Distance in meters.

ARMYGROUP:GetEPLRS()

Get current EPLRS state.

Defined in:

Return value:

#boolean:

If true, EPLRS is on.

ARMYGROUP:GetElementAlive()

Get the first element of a group, which is alive.

#boolean:

If true, emission is on.

ARMYGROUP:GetExpectedSpeed()

Returns the currently expected speed.

Defined in:

Return value:

#number:

Expected speed in m/s.

ARMYGROUP:GetFreeCargobay(UnitName, IncludeReserved)

Get free cargo bay weight.

Defined in:

Parameters:

#string UnitName

#number:

Current heading of the group in degrees.

ARMYGROUP:GetHighestThreat()

Get highest threat.

Defined in:

Return values:

Wrapper.Unit#UNIT:

The highest threat unit.

#number:

Threat level of the unit.

Returns the absolute (average) life points of the group.

Defined in:

Parameter:

#OPSGROUP.Element Element

(Optional) Only get life points of this element.

Return values:

#number:

Life points. If group contains more than one element, the average is given.

#number:

Initial life points.

ARMYGROUP:GetMissionByID(id)

Get mission by its id (auftragsnummer).

Defined in:

Parameter:

#number id

Mission id (auftragsnummer).

Return value:

Ops.Auftrag#AUFTRAG:

The mission.

ARMYGROUP:GetMissionByTaskID(taskid)

Get mission by its task id.

Defined in:

Parameter:

Number of elements.

ARMYGROUP:GetNextWaypointCoordinate(cyclic)

Get coordinate of next waypoint of the group.

Defined in:

Parameter:

#boolean cyclic

If true, return first waypoint if last waypoint was reached.

Return value:

Core.Point#COORDINATE:

Coordinate of the next waypoint.

ARMYGROUP:GetOpsTransportByUID(uid)

Get cargo transport assignment from the cargo queue by its unique ID.

Defined in:

Parameter:

Radio frequency in MHz or nil.

#number:

Radio modulation or nil.

#boolean:

If true, the radio is on. Otherwise, radio is turned off.

ARMYGROUP:GetSpeedCruise()

Get default cruise speed.

Defined in:

Return value:

#number:

Cruise speed (>0) in knots.

ARMYGROUP:GetSpeedToWaypoint(indx)

Returns a non-zero speed to the next waypoint (even if the waypoint speed is zero).

Defined in:

Parameter:

#number indx

Waypoint index.

Return value:

#number:

Speed to next waypoint (>0) in knots.

ARMYGROUP:GetTACAN()

Get current TACAN parameters.

Defined in:

Return values:

#number:

TACAN channel.

#string:

TACAN Morse code.

#string:

TACAN band ("X" or "Y").

#boolean:

TACAN is On (true) or Off (false).

#string:

UnitName Name of the unit acting as beacon.

ARMYGROUP:GetTaskByID(id, status)

Get task by its id.

Defined in:

Parameters:

#number id

#table:

Table of tasks. Table could also be empty {}.

ARMYGROUP:GetThreat(ThreatLevelMin, ThreatLevelMax)

Get highest detected threat.

Detection must be turned on. The threat level is a number between 0 and 10, where 0 is the lowest, e.g. unarmed units.

Defined in:

Parameters:

#number ThreatLevelMin

Only consider threats with level greater or equal to this number. Default 1 (so unarmed units wont be considered).

#number ThreatLevelMax

Only consider threats with level smaller or queal to this number. Default 10.

Return values:

Defined in:

Return value:

#OPSGROUP.Waypoint:

Final waypoint table.

ARMYGROUP:GetWaypointID(indx)

Get unique ID of waypoint given its index.

Defined in:

Parameter:

#number indx

Waypoint index.

Return value:

#number:

Unique ID.

ARMYGROUP:GetWaypointIndex(uid)

Get the waypoint index (its position in the current waypoints table).

Defined in:

Parameter:

#number uid

Waypoint unique ID.

Return value:

Get the waypoint UID from its index, i.e.

its current position in the waypoints table.

Defined in:

Parameter:

Weapon range data.

ARMYGROUP:GetWeightCargo(UnitName, IncludeReserved)

Get weight of the internal cargo the group is carriing right now.

Defined in:

Parameters:

#string UnitName

Name of the unit. Default is of the whole group.

#boolean IncludeReserved

If false, cargo weight that is only reserved is not counted. By default (true or nil), the reserved cargo is included.

Return value:

#number:

Cargo weight in kg.

ARMYGROUP:GetWeightCargoMax(UnitName)

Get max weight of the internal cargo the group can carry.

Optionally, the max cargo weight of a specific unit can be requested.

Defined in:

Parameter:

#string UnitName

Name of the unit. Default is of the whole group.

Return value:

#number:

Max cargo weight in kg. This does not include any cargo loaded or reserved currently.

ARMYGROUP:GetWeightTotal(UnitName, IncludeReserved)

Get total weight of the group including cargo.

Optionally, the total weight of a specific unit can be requested.

Defined in:

Parameters:

#string UnitName

Name of the unit. Default is of the whole group.

#boolean IncludeReserved

If false, cargo weight that is only reserved is not counted. By default (true or nil), the reserved cargo is included.

Return value:

#number:

Total weight in kg.

ARMYGROUP:HasLoS(Coordinate, Element, OffsetElement, OffsetCoordinate)

Check if an element of the group has line of sight to a coordinate.

Defined in:

Parameters:

Core.Point#COORDINATE Coordinate

The position to which we check the LoS.

#OPSGROUP.Element Element

The (optinal) element. If not given, all elements are checked.

DCS#Vec3 OffsetElement

#boolean:

If true, group is awaiting transport lift..

ARMYGROUP:IsBoarding(CarrierGroupName)

Check if the group is currently boarding a carrier.

Defined in:

Parameter:

#string CarrierGroupName

(Optional) Additionally check if group is boarding this particular carrier group.

Return value:

#boolean:

If true, group is boarding.

ARMYGROUP:IsBusy()

Check if the group is currently busy doing something.

Boarding
Rearming
Returning
Pickingup, Loading, Transporting, Unloading
Engageing

Defined in:

Return value:

#boolean:

If true, group is busy.

ARMYGROUP:IsCargo(CheckTransport)

Check if the group is assigned as cargo.

Defined in:

Parameter:

#boolean CheckTransport

If true or nil, also check if cargo is associated with a transport assignment. If not, we consider it not cargo.

Return value:

#boolean:

If true, group is cargo.

ARMYGROUP:IsCarrier()

Check if the group is a carrier.

Defined in:

Return value:

#boolean:

If true, group is a carrier.

ARMYGROUP:IsDead()

ARMYGROUP:IsInUtero()

Check if group is in state in utero.

Note that dead groups are also in utero but will return false here.

Defined in:

Return value:

#boolean:

If true, group is not spawned yet.

ARMYGROUP:IsInZone(Zone)

Check if group is currently inside a zone.

Defined in:

Parameter:

The GROUP object. Can also be given by its group name as #string.

Return value:

self

ARMYGROUP:NewTaskScheduled(task, clock, description, prio, duration)

Create a scheduled task.

Defined in:

Parameters:

#table task

DCS task table structure.

#string clock

Mission time when task is executed. Default in 5 seconds. If argument passed as #number, it defines a relative delay in seconds.

#string description

Parameter:

#table DCSTask

DCS task structure.

Return value:

self

ARMYGROUP:RadioTransmission(Text, Delay)

Send a radio transmission via SRS Text-To-Speech.

Defined in:

Parameters:

#string Text

Text of transmission.

#number Delay

Delay in seconds before the transmission is started.

Return value:

self

ARMYGROUP:RedWeightCargo(UnitName, Weight)

Reduce weight to the internal cargo of an element of the group.

Defined in:

Parameters:

Table of waypoints.

#number delay

Delay in seconds.

Return value:

self

ARMYGROUP:RouteToMission(mission, delay)

Route group to mission.

Defined in:

Parameters:

Ops.Auftrag#AUFTRAG mission

The mission table.

#number delay

Delay in seconds.

ARMYGROUP:SelfDestruction(Delay, ExplosionPower)

ARMYGROUP:SetCheckZones(CheckZonesSet)

Define a SET of zones that trigger and event if the group enters or leaves any of the zones.

Defined in:

Parameter:

Core.Set#SET_ZONE CheckZonesSet

Set of zones.

Return value:

self

ARMYGROUP:SetDefaultAlarmstate(alarmstate)

Set the default Alarm State for the group.

This is the state gets when the group is spawned or to which it defaults back after a mission.

Defined in:

Parameter:

#number alarmstate

Alarm state of group. Default is AI.Option.Ground.val.ALARM_STATE.AUTO (0).

Return value:

self

ARMYGROUP:SetDefaultAltitude(Altitude)

Set default cruise altitude.

Defined in:

Parameter:

#number Altitude

Altitude in feet. Default is 10,000 ft for airplanes and 1,500 feet for helicopters.

Return value:

self

ARMYGROUP:SetDefaultCallsign(CallsignName, CallsignNumber)

self

ARMYGROUP:SetDefaultICLS(Channel, Morse, UnitName, OffSwitch)

Set default ICLS parameters.

Defined in:

Parameters:

#number Channel

ICLS channel. Default is 1.

#string Morse

Morse code. Default "XXX".

#string UnitName

Name of the unit acting as beacon.

#boolean OffSwitch

If true, TACAN is off by default.

Return value:

self

ARMYGROUP:SetDefaultROE(roe)

Set the default ROE for the group.

This is the ROE state gets when the group is spawned or to which it defaults back after a mission.

Defined in:

Parameter:

#number roe

ROE of group. Default is ENUMS.ROE.ReturnFire.

Return value:

self

ARMYGROUP:SetDefaultROT(rot)

Set the default ROT for the group.

This is the ROT state gets when the group is spawned or to which it defaults back after a mission.

Defined in:

Parameter:

#number rot

ROT of group. Default is ENUMS.ROT.PassiveDefense.

Return value:

self

ARMYGROUP:SetDefaultRadio(Frequency, Modulation, OffSwitch)

Set default Radio frequency and modulation.

Defined in:

Parameters:

#number Frequency

Radio frequency in MHz. Default 251 MHz.

#number Modulation

Radio modulation. Default radio.Modulation.AM.

#boolean OffSwitch

If true, radio is OFF by default.

Return value:

self

ARMYGROUP:SetDefaultSpeed(Speed)

Set default cruise speed.

Defined in:

Parameter:

#number Speed

Speed in knots.

Return value:

self

ARMYGROUP:SetDefaultTACAN(Channel, Morse, UnitName, Band, OffSwitch)

Set default TACAN parameters.

Defined in:

Parameters:

#number Channel

TACAN channel. Default is 74.

#string Morse

Morse code. Default "XXX".

#string UnitName

Name of the unit acting as beacon.

#string Band

TACAN mode. Default is "X" for ground and "Y" for airborne units.

#boolean OffSwitch

If true, TACAN is off by default.

Return value:

self

ARMYGROUP:SetDetection(Switch)

Set detection on or off.

If detection is on, detected targets of the group will be evaluated and FSM events triggered.

Defined in:

Parameter:

#boolean Switch

If true, detection is on. If false or nil, detection is off. Default is off.

Return value:

self

ARMYGROUP:SetEngageDetectedOff()

Disable to automatically engage detected targets.

Defined in:

Return value:

self

ARMYGROUP:SetEngageDetectedOn(RangeMax, TargetTypes, EngageZoneSet, NoEngageZoneSet)

Enable to automatically engage detected targets.

Defined in:

Parameters:

#number RangeMax

Max range in NM. Only detected targets within this radius from the group will be engaged. Default is 25 NM.

#table TargetTypes

Types of target attributes that will be engaged. See DCS enum attributes. Default "All".

Core.Set#SET_ZONE EngageZoneSet

Set of zones in which targets are engaged. Default is anywhere.

Core.Set#SET_ZONE NoEngageZoneSet

Set of zones in which targets are not engaged. Default is nowhere.

Return value:

self

ARMYGROUP:SetLaser(Code, CheckLOS, IROff, UpdateTime)

Set LASER parameters.

Defined in:

Parameters:

#number Code

Laser code. Default 1688.

#boolean CheckLOS

Check if lasing unit has line of sight to target coordinate. Default is true.

#boolean IROff

If true, then dont switch on the additional IR pointer.

#number UpdateTime

Time interval in seconds the beam gets up for moving targets. Default every 0.5 sec.

Return value:

self

ARMYGROUP:SetLaserTarget(Target)

Set LASER target.

Defined in:

Parameter:

Wrapper.Positionable#POSITIONABLE Target

The target to lase. Can also be a COORDINATE object.

ARMYGROUP:SetRearmOnOutOfAmmo()

Set that group is going to rearm once it runs out of ammo.

Defined in:

Return value:

self

ARMYGROUP:SetSRS(PathToSRS, Gender, Culture, Voice, Port)

Use SRS Simple-Text-To-Speech for transmissions.

Defined in:

Parameters:

#string PathToSRS

Path to SRS directory.

#string Gender

Gender: "male" or "female" (default).

#string Culture

Culture, e.g. "en-GB" (default).

#string Voice

Specific voice. Overrides Gender and Culture.

#number Port

SRS port. Default 5002.

Return value:

self

ARMYGROUP:SetTask(DCSTask)

Set DCS task.

Enroute tasks are injected automatically.

Defined in:

Parameter:

#table DCSTask

DCS task structure.

Return value:

self

ARMYGROUP:SetVerbosity(VerbosityLevel)

Set verbosity level.

Defined in:

Parameter:

#number VerbosityLevel

Level of output (higher=more). Default 0.

Return value:

self

ARMYGROUP:Status()

Triggers the FSM event "Status".

Defined in:

ARMYGROUP:SwitchAlarmstate(alarmstate)

Set current Alarm State of the group.

0 = "Auto"
1 = "Green"
2 = "Red"

Defined in:

Parameter:

#number alarmstate

Alarm state of group. Default is 0="Auto".

Return value:

self

ARMYGROUP:SwitchCallsign(CallsignName, CallsignNumber)

self

ARMYGROUP:SwitchICLS(Channel, Morse, UnitName)

Activate/switch ICLS beacon settings.

Defined in:

Parameters:

#number Channel

ICLS Channel. Default is what is set in SetDefaultICLS() so usually channel 1.

Parameters:

#number Frequency

Radio frequency in MHz. Default is value set in SetDefaultRadio (usually 251 MHz).

#number Modulation

Radio modulation. Default is value set in SetDefaultRadio (usually radio.Modulation.AM).

Return value:

self

ARMYGROUP:SwitchTACAN(Channel, Morse, UnitName, Band)

Activate/switch TACAN beacon settings.

Defined in:

Parameters:

#number Channel

TACAN Channel.

#string Morse

TACAN morse code. Default is the value set in OPSGROUP.SetDefaultTACAN or if not set "XXX".

#string UnitName

Add OPSGROUP to cargo bay of a carrier.

Defined in:

Parameters:

#OPSGROUP CargoGroup

#OPSGROUP.Waypoint waypoint

Waypoint data.

#number wpnumber

Waypoint index/number. Default is as last waypoint.

ARMYGROUP:_AllSameStatus(unitname, status)

Check if all elements of the group have the same status (or are dead).

Defined in:

Parameters:

#string unitname

Name of unit.

status

ARMYGROUP:_AllSimilarStatus(status)

Check if all elements of the group have the same status (or are dead).

Defined in:

Parameter:

#string status

Status to check.

Return value:

#boolean:

If true, all elements have a similar status.

ARMYGROUP:_CheckAmmoFull()

Check ammo is full.

Defined in:

Return value:

#boolean:

If true, ammo is full.

ARMYGROUP:_CheckAmmoStatus()

Check ammo status.

Ops.OpsTransport#OPSTRANSPORT CargoTransport

The next due cargo transport or nil.

Return value:

#boolean:

If true, all cargo was delivered.

ARMYGROUP:_CheckDetectedUnits()

Check detected units.

Defined in:

ARMYGROUP:_CheckGoPickup(CargoTransport)

Check if all cargo of this transport assignment was delivered.

Defined in:

Parameter:

Ops.OpsTransport#OPSTRANSPORT CargoTransport

The next due cargo transport or nil.

Return value:

#boolean:

If true, all cargo was delivered.

ARMYGROUP:_CheckGroupDone(delay)

Check if passed the final waypoint and, if necessary, update route.

Defined in:

Parameter:

#number delay

Delay in seconds.

ARMYGROUP:_CheckInZones()

Check if group is in zones.

Defined in:

ARMYGROUP:_CheckStuck()

Check if group got stuck.

Defined in:

ARMYGROUP:_CoordinateFromObject(Object)

Get coordinate from an object.

Defined in:

Parameter:

Wrapper.Object#OBJECT Object

The object.

Return value:

Core.Point#COORDINATE:

The coordinate of the object.

ARMYGROUP:_CreateWaypoint(Waypoint, waypoint)

Enhance waypoint table.

Defined in:

Parameters:

Parameter:

#OPSGROUP CargoGroup

Cargo group.

Return values:

#OPSGROUP.MyCargo:

Cargo bay item or nil if the group is not in the carrier.

#number:

CargoBayIndex Index of item in the cargo bay table.

#OPSGROUP.Element:

Carrier element.

ARMYGROUP:_GetDetectedTarget()

Get target group.

Defined in:

Return values:

Wrapper.Group#GROUP:

Detected target group.

#number:

Distance to target.

ARMYGROUP:_GetElementZoneLoader(Element, Zone, Loader)

Get/update the (un-)loading zone of the element.

Defined in:

Parameters:

#OPSGROUP.Element Element

Element.

Core.Zone#ZONE_POLYGON Zone

The zone.

#OPSGROUP.CarrierLoader Loader

Loader parameters.

Return value:

Core.Zone#ZONE_POLYGON:

Bounding box polygon zone.

ARMYGROUP:_GetMyCarrier()

Get my carrier.

Defined in:

Return values:

Carrier group.

#boolean:

If true, space for me was reserved.

ARMYGROUP:_MissileCategoryName(categorynumber)

Returns a name of a missile category.

Defined in:

Parameter:

#number categorynumber

Number of missile category from weapon missile category enumerator. See https://wiki.hoggitworld.com/view/DCS_Class_Weapon

Return value:

#string:

Missile category name.

ARMYGROUP:_NewCargoStatus(Status)

Set (new) cargo status.

Defined in:

Parameter:

#string Status

self

ARMYGROUP:_SetMissionOptions(mission)

Set mission specific options for ROE, Alarm state, etc.

Defined in:

Parameter:

Ops.Auftrag#AUFTRAG mission

The mission table.

ARMYGROUP:_SetMyCarrier(CarrierGroup, CarrierElement, Reserved)

Set my carrier.

Defined in:

Parameters:

#OPSGROUP CarrierGroup

Carrier group.

#OPSGROUP.Element CarrierElement

Carrier element.

#boolean Reserved

If true, reserve space for me.

ARMYGROUP:_SetTemplate(Template)

Set the template of the group.

Defined in:

Parameter:

#table Template

Template to set. Default is from the GROUP.

Return value:

self

ARMYGROUP:_SetWaypointTasks(Waypoint)

Set tasks at this waypoint

Defined in:

Parameter:

#OPSGROUP.Waypoint Waypoint

The waypoint.

Return value:

#number:

Number of tasks.

ARMYGROUP:_SimpleTaskFunction(Function, uid)

Simple task function.

Can be used to call a function which has the warehouse and the executing group as parameters.

Defined in:

Parameters:

#string Function

The name of the function to call passed as string.

#number uid

Waypoint UID.

ARMYGROUP:_SortTaskQueue()

Sort task queue.

Defined in:

ARMYGROUP:_SwitchICLS(Icls)

Activate/switch ICLS beacon settings.

Defined in:

Parameter:

#OPSGROUP.Beacon Icls

ICLS data table.

Return value:

self

ARMYGROUP:_SwitchTACAN(Tacan)

Activate/switch TACAN beacon settings.

Defined in:

Parameter:

The mission.

ARMYGROUP:__Status(delay)

Triggers the FSM event "Status" after a delay.

Defined in:

Parameter:

#number delay

Delay in seconds.

ARMYGROUP:__Stop(delay)

#string From

From state.

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Ops.OpsTransport#OPSTRANSPORT CargoTransport

The cargo transport assignment.

ARMYGROUP:onafterDestroyed(From, Event, To)

On after "Destroyed" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterDetectedGroup(From, Event, To, Group)

On after "DetectedGroup" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Wrapper.Group#GROUP Group

The detected Group.

ARMYGROUP:onafterDetectedGroupNew(From, Event, To, Group)

On after "DetectedGroupNew" event.

Add newly detected group to detected group set.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Wrapper.Group#GROUP Group

The detected group.

ARMYGROUP:onafterDetectedUnit(From, Event, To, Unit)

On after "DetectedUnit" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Wrapper.Unit#UNIT Unit

The detected unit.

ARMYGROUP:onafterDetectedUnitNew(From, Event, To, Unit)

ARMYGROUP:onafterEnterZone(From, Event, To, Zone)

On after "EnterZone" event.

Sets self.inzones[zonename]=true.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Core.Zone#ZONE Zone

The zone that the group entered.

ARMYGROUP:onafterGotoWaypoint(From, Event, To, UID, Speed)

On after "GotoWaypoint" event.

Group will got to the given waypoint and execute its route from there.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#number UID

The goto waypoint unique ID.

#number Speed

(Optional) Speed to waypoint in knots.

ARMYGROUP:onafterInUtero(From, Event, To)

On after "InUtero" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterLaserCode(From, Event, To, Code)

#string To

To state.

Core.Point#COORDINATE Target

Target Coordinate. Target can also be any POSITIONABLE from which we can obtain its coordinates.

ARMYGROUP:onafterLaserPause(From, Event, To)

On after "LaserPause" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterLaserResume(From, Event, To)

On after "LaserResume" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterLeaveZone(From, Event, To, Zone)

On after "LeaveZone" event.

Sets self.inzones[zonename]=false.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Core.Zone#ZONE Zone

The zone that the group entered.

ARMYGROUP:onafterLoad(From, Event, To, CargoGroup, Carrier)

On after "Load" event.

Carrier loads a cargo group into ints cargo bay.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP CargoGroup

The OPSGROUP loaded as cargo.

#OPSGROUP.Element Carrier

The carrier element/unit.

ARMYGROUP:onafterLoading(From, Event, To)

ARMYGROUP:onafterMissionDone(From, Event, To, Mission)

On after "MissionDone" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Ops.Auftrag#AUFTRAG Mission

The mission that is done.

ARMYGROUP:onafterMissionExecute(From, Event, To, Mission)

On after "MissionExecute" event.

Mission execution began.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

Ops.Auftrag#AUFTRAG Mission

The mission table.

ARMYGROUP:onafterMissionStart(From, Event, To, Mission)

Event.

#string To

To state.

#table Template

The template used to respawn the group. Default is the inital template of the group.

ARMYGROUP:onafterStop(From, Event, To)

On after "Stop" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onafterTaskCancel(From, Event, To, Task)

On after "TaskCancel" event.

Cancels the current task or simply sets the status to DONE if the task is not the current one.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP.Task Task

The task to cancel. Default is the current task (if any).

ARMYGROUP:onafterTaskDone(From, Event, To, Task)

On after "TaskDone" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP.Task Task

ARMYGROUP:onafterTaskExecute(From, Event, To, Task)

To state.

Ops.OpsTransport#OPSTRANSPORT The

transport to be cancelled.

Transport

ARMYGROUP:onafterUnload(From, Event, To, OpsGroup, Coordinate, Activated, Heading)

On after "Unload" event.

Carrier unloads a cargo group from its cargo bay.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP OpsGroup

The OPSGROUP loaded as cargo.

Core.Point#COORDINATE Coordinate

Coordinate were the group is unloaded to.

#boolean Activated

If true, group is active. If false, group is spawned in late activated state.

#number Heading

(Optional) Heading of group in degrees. Default is random heading for each unit.

ARMYGROUP:onafterUnloaded(From, Event, To, OpsGroupCargo)

To state.

#number Duration

Duration in seconds how long the group will be waiting. Default nil (for ever).

ARMYGROUP:onbeforeBoard(From, Event, To, CarrierGroup, Carrier)

On before "Board" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP CarrierGroup

The carrier group.

#OPSGROUP.Element Carrier

The OPSGROUP element

ARMYGROUP:onbeforeDead(From, Event, To)

On before "Dead" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onbeforeElementSpawned(From, Event, To, Element)

On before "ElementSpawned" event.

Check that element is not in status spawned already.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP.Element Element

The flight group element.

ARMYGROUP:onbeforeLaserOff(From, Event, To)

#string To

To state.

Ops.Auftrag#AUFTRAG Mission

The mission table.

ARMYGROUP:onbeforeStop(From, Event, To)

On before "Stop" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

ARMYGROUP:onbeforeTaskDone(From, Event, To, Task)

On before "TaskDone" event.

Deny transition if task status is PAUSED.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#OPSGROUP.Task Task

ARMYGROUP:onbeforeTaskExecute(From, Event, To, Task)

To state.

#OPSGROUP OpsGroup

The OPSGROUP loaded as cargo.

Core.Point#COORDINATE Coordinate

Coordinate were the group is unloaded to.

#number Heading

Heading of group.

ARMYGROUP:onbeforeWait(From, Event, To, Duration)

On before "Wait" event.

Defined in:

Parameters:

#string From

From state.

#string Event

Event.

#string To

To state.

#number Duration

Duration how long the group will be waiting in seconds. Default nil (=forever).

Field(s)

#boolean ARMYGROUP.adinfinitum

Resume route at first waypoint when final waypoint is reached.

ARMYGROUP.ammo

Group ammo.

#ARMYGROUP.Target ARMYGROUP.engage

Engage target.

#boolean ARMYGROUP.formationPerma

Formation that is used permanently and overrules waypoint formations.

#boolean ARMYGROUP.groupinitialized

Init done.

#boolean ARMYGROUP.isAI

Ground are always AI.

#boolean ARMYGROUP.isDead

Not dead or destroyed yet.

#boolean ARMYGROUP.isDestroyed

ARMYGROUP.isLateActivated

Is (template) group late activated.

#boolean ARMYGROUP.isMobile

If true, group is mobile.

#boolean ARMYGROUP.isUncontrolled

Ground groups cannot be uncontrolled.

ARMYGROUP.lid

Set some string id for output to DCS.log file.

#boolean ARMYGROUP.retreatOnOutOfAmmo

If true, the group will automatically retreat when out of ammo. Needs a retreat zone!

Core.Set#SET_ZONE ARMYGROUP.retreatZones

Set of retreat zones.

ARMYGROUP.speedMax

Max speed in km/h.

ARMYGROUP.speedWp

Current set speed in m/s.

ARMYGROUP.tacan

ARMYGROUP.timerCheckZone

Start check zone timer.

ARMYGROUP.timerQueueUpdate

Start queue update timer.

ARMYGROUP.timerStatus

Start the status monitoring.

#string ARMYGROUP.version

Army Group version.

Function(s)

ARMYGROUP:AddEndState(State)

Adds an End state.

Defined in:

Parameter:

#string State

The FSM state.

ARMYGROUP:AddProcess(From, Event, Process, ReturnEvents)

Set the default Process template with key ProcessName providing the ProcessClass and the process object when it is assigned to a Wrapper.Controllable by the task.

Defined in:

Parameters:

#table From

Can contain a string indicating the From state or a table of strings containing multiple From states.

#string Event

The Event name.

Core.Fsm#FSM_PROCESS Process

An sub-process FSM.

#table ReturnEvents

A table indicating for which returned events of the SubFSM which Event must be triggered in the FSM.

Return value:

Core.Fsm#FSM_PROCESS:

The SubFSM.

ARMYGROUP:AddScore(State, ScoreText, Score)

Adds a score for the FSM to be achieved.

Defined in:

Parameters:

#string State

is the state of the process when the score needs to be given. (See the relevant state descriptions of the process).

#string ScoreText

is a text describing the score that is given according the status.

#number Score

is a number providing the score of the status.

Return value:

#FSM:

self

ARMYGROUP:AddScoreProcess(From, Event, State, ScoreText, Score)

Adds a score for the FSM_PROCESS to be achieved.

Defined in:

Parameters:

#string From

is the From State of the main process.

#string Event

is the Event of the main process.

#string State

is the state of the process when the score needs to be given. (See the relevant state descriptions of the process).

#string ScoreText

is a text describing the score that is given according the status.

#number Score

is a number providing the score of the status.

Return value:

#FSM:

self

ARMYGROUP:AddTransition(From, Event, To)

Add a new transition rule to the FSM.

A transition rule defines when and if the FSM can transition from a state towards another state upon a triggered event.

Defined in:

Parameters:

#table From

Can contain a string indicating the From state or a table of strings containing multiple From states.

#string Event

The Event name.

#string To

The To state.

ARMYGROUP:GetCurrentState()

Get current state.

Defined in:

Return value:

#string:

Current FSM state.

ARMYGROUP:GetEndStates()

Returns the End states.

Defined in:

Return value:

#table:

End states.

#boolean:

If true, FSM is in this state.

ARMYGROUP:LoadCallBacks(CallBackTable)

Load call backs.

Defined in:

Parameter:

#table CallBackTable

Table of call backs.

ARMYGROUP:New()

Creates a new FSM object.

Defined in:

Return value:

#FSM:

ARMYGROUP:SetProcess(From, Event, Fsm)

Defined in:

Parameters:

From

Parameters:

#string step

Step "onafter", "onbefore", "onenter", "onleave".

#string trigger

Trigger.

#table params

Parameters.

#string EventName

Event name.

Return value:

ARMYGROUP:_gosub(ParentFrom, ParentEvent)

Go sub.

Defined in:

Parameters:

#string ParentFrom

Parent from state.

#string ParentEvent

Parent event name.

Return value:

#table:

Subs.

ARMYGROUP:_handler(EventName, ...)

Handler.

Defined in:

Parameters:

#string EventName

Event name.

...

Arguments.

ARMYGROUP:_isendstate(Current)

Is end state.

Defined in:

Parameter:

#string Current

Current state name.

Return values:

#table:

FSM parent.

#string:

Event name.

ARMYGROUP:_submap(subs, sub, name)

Sub maps.

Defined in:

Parameters:

#table subs

Subs.

#table sub

Sub.

#string name

Name.

ARMYGROUP:can(e)

Check if can do an event.

Defined in:

Parameter:

#string e

Event name.

Return values:

#boolean:

If true, FSM can do the event.

#string:

To state.

ARMYGROUP:cannot(e)

Check if cannot do an event.

Defined in:

Parameter:

#string e

Event name.

Return value:

#boolean:

If true, FSM cannot do the event.

ARMYGROUP:is(State, state)

Check if FSM is in state.

Defined in:

Parameters:

#string State

State name.

state

Return value:

#boolean:

If true, FSM is in this state.

Field(s)

#boolean ARMYGROUP.adinfinitum

Resume route at first waypoint when final waypoint is reached.

ARMYGROUP.ammo

Group ammo.

#ARMYGROUP.Target ARMYGROUP.engage

Engage target.

#boolean ARMYGROUP.formationPerma

Formation that is used permanently and overrules waypoint formations.

#boolean ARMYGROUP.groupinitialized

Init done.

#boolean ARMYGROUP.isAI

Ground are always AI.

#boolean ARMYGROUP.isDead

Not dead or destroyed yet.

#boolean ARMYGROUP.isDestroyed

ARMYGROUP.isLateActivated

Is (template) group late activated.

#boolean ARMYGROUP.isMobile

If true, group is mobile.

#boolean ARMYGROUP.isUncontrolled

Ground groups cannot be uncontrolled.

ARMYGROUP.lid

Set some string id for output to DCS.log file.

#boolean ARMYGROUP.retreatOnOutOfAmmo

If true, the group will automatically retreat when out of ammo. Needs a retreat zone!

Core.Set#SET_ZONE ARMYGROUP.retreatZones

Set of retreat zones.

ARMYGROUP.speedMax

Max speed in km/h.

ARMYGROUP.speedWp

Current set speed in m/s.

ARMYGROUP.tacan

ARMYGROUP.timerCheckZone

Start check zone timer.

ARMYGROUP.timerQueueUpdate

Start queue update timer.

ARMYGROUP.timerStatus

Start the status monitoring.

#string ARMYGROUP.version

Army Group version.

Function(s)

ARMYGROUP:ClearState(Object, StateName)

Clear the state of an object.

Defined in:

Parameters:

Object

The object that holds the Value set by the Key.

StateName

The key that is should be cleared.

ARMYGROUP:CreateEventBirth(EventTime, Initiator, IniUnitName, place, subplace)

Creation of a Birth Event.

Defined in:

Parameters:

DCS#Time EventTime

The time stamp of the event.

DCS#Object Initiator

The initiating object of the event.

#string IniUnitName

The initiating unit name.

place

subplace

ARMYGROUP:CreateEventCrash(EventTime, Initiator)

Creation of a Crash Event.

Defined in:

Parameters:

DCS#Time EventTime

The time stamp of the event.

DCS#Object Initiator

The initiating object of the event.

ARMYGROUP:CreateEventDead(EventTime, Initiator)

The time stamp of the event.

DCS#Object Initiator

The initiating object of the event.

ARMYGROUP:CreateEventTakeoff(EventTime, Initiator)

Creation of a Takeoff Event.

Defined in:

Parameters:

DCS#Time EventTime

The time stamp of the event.

DCS#Object Initiator

The initiating object of the event.

ARMYGROUP:CreateEventUnitLost(EventTime, Initiator)

Creation of a Crash Event.

Defined in:

Parameters:

DCS#Time EventTime

The time stamp of the event.

DCS#Object Initiator

The initiating object of the event.

ARMYGROUP:E(Arguments)

Log an exception which will be traced always.

Can be anywhere within the function logic.

Defined in:

Parameter:

Arguments

A #table or any field.

ARMYGROUP:EventDispatcher()

Returns the event dispatcher

Defined in:

Return value:

Core.Event#EVENT:

ARMYGROUP:EventRemoveAll()

Remove all subscribed events

Defined in:

ARMYGROUP:GetClassNameAndID()

Get the ClassName + ClassID of the class instance.

The ClassName + ClassID is formatted as '%s#%09d'.

Defined in:

Return value:

#string:

The ClassName + ClassID of the class instance.

ARMYGROUP:GetEventPriority()

Get the Class Event processing Priority.

The Event processing Priority is a number from 1 to 10, reflecting the order of the classes subscribed to the Event to be processed.

Defined in:

Return value:

#number:

The Event processing Priority.

ARMYGROUP:GetParent(Child, FromClass)

This is the worker method to retrieve the Parent class.

Note that the Parent class must be passed to call the parent class method.

self:GetParent(self):ParentMethod()

Defined in:

Parameters:

#BASE Child

This is the Child class from which the Parent class needs to be retrieved.

#BASE FromClass

(Optional) The class from which to get the parent.

Return value:

#BASE:

ARMYGROUP:GetState(Object, Key)

Get a Value given a Key from the Object.

Note that if the Object is destroyed, nillified or garbage collected, then the Values and Keys will also be gone.

Defined in:

Parameters:

Object

The object that holds the Value set by the Key.

Key

The key that is used to retrieve the value. Note that the key can be a #string, but it can also be any other type!

Return value:

The Value retrieved or nil if the Key was not found and thus the Value could not be retrieved.

ARMYGROUP:HandleEvent(EventID, EventFunction)

Subscribe to a DCS Event.

Defined in:

Parameters:

Core.Event#EVENTS EventID

Event ID.

#function EventFunction

(optional) The function to be called when the event occurs for the unit.

Return value:

#BASE:

ARMYGROUP:I(Arguments)

Log an information which will be traced always.

Can be anywhere within the function logic.

Defined in:

Parameter:

Arguments

A #table or any field.

ARMYGROUP:Inherit(Child, Parent)

This is the worker method to inherit from a parent class.

Defined in: