JoinsUp and Follows a CLIENT.

Defines a menu slot to let the escort attack its detected targets using assisted attack from another escort joined also with the client.

This menu will appear under Request assistance from. Note that this method needs to be preceded with the method MenuReportTargets.

Defines a menu to let the escort set its evasion when under threat.

All rules of engagement will appear under the menu Evasion.

Defines a menu slot to let the escort disperse a flare in a certain color.

This menu will appear under Navigation. The flare will be fired from the first unit in the group.

Defines a menu slot to let the escort Join and Follow you at a certain distance.

This menu will appear under Navigation.

Defines a menu slot to let the escort hold at their current position and stay low with a specified height during a specified time in seconds.

This menu will appear under Hold position.

Defines a menu slot to let the escort hold at the client position and stay low with a specified height during a specified time in seconds.

This menu will appear under Navigation.

Defines a menu to let the escort set its rules of engagement.

All rules of engagement will appear under the menu ROE.

Defines a menu slot to let the escort report their current detected targets with a specified time interval in seconds.

This menu will appear under Report targets. Note that if a report targets menu is not specified, no targets will be detected by the escort, and the attack and assisted attack menus will not be displayed.

Defines a menu to let the escort resume its mission from a waypoint on its route.

All rules of engagement will appear under the menu Resume mission from.

Defines a menu slot to let the escort scan for targets at a certain height for a certain time in seconds.

This menu will appear under Scan targets.

Defines a menu slot to let the escort disperse a smoke in a certain color.

This menu will appear under Navigation. Note that smoke menu options will only be displayed for ships and ground units. Not for air units. The smoke will be fired from the first unit in the group.

Defines the default menus

ESCORT class constructor for an AI group

-- Declare a new EscortPlanes object as follows:

-- First find the GROUP object and the CLIENT object.
local EscortClient = CLIENT:FindByName( "Unit Name" ) -- The Unit Name is the name of the unit flagged with the skill Client in the mission editor.
local EscortGroup = GROUP:FindByName( "Group Name" ) -- The Group Name is the name of the group that will escort the Escort Client.

-- Now use these 2 objects to construct the new EscortPlanes object.
EscortPlanes = ESCORT:New( EscortClient, EscortGroup, "Desert", "Welcome to the mission. You are escorted by a plane with code name 'Desert', which can be instructed through the F10 radio menu." )

Registers the waypoints

Set a Detection method for the EscortClient to be reported upon.

Detection methods are based on the derived classes from DETECTION_BASE.

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 #ESCORT self @param Functional.Detection#DETECTION_BASE.DetectedItem DetectedItem

@param #MENUPARAM MenuParam

@param Functional.Escort#ESCORT self

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

Report Targets Scheduler.

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

@param #MENUPARAM MenuParam

Clear the state of an object.

Creation of a Birth Event.

Creation of a Crash Event.

Creation of a Dead Event.

Creation of a S_EVENT_DYNAMIC_CARGO_LOADED event.

Creation of a S_EVENT_DYNAMIC_CARGO_REMOVED event.

Creation of a S_EVENT_DYNAMIC_CARGO_UNLOADED event.

Creation of a S_EVENT_NEW_DYNAMIC_CARGO event.

Creation of a S_EVENT_PLAYER_ENTER_AIRCRAFT event.

Creation of a Remove Unit Event.

Creation of a Takeoff Event.

Creation of a Crash Event.

Log an exception which will be traced always.

Can be anywhere within the function logic.

Returns the event dispatcher

Remove all subscribed events

Trace a function call.

Must be at the beginning of the function logic.

Trace a function call level 2.

Must be at the beginning of the function logic.

Trace a function call level 3.

Must be at the beginning of the function logic.

Get the ClassID of the class instance.

Get the ClassName of the class instance.

Get the ClassName + ClassID of the class instance.

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

Get the Class Core.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.

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()

Get a Value given a Key from the Object.

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

Subscribe to a DCS Event.

Log an information which will be traced always.

Can be anywhere within the function logic.

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

This is the worker method to check if an object is an (sub)instance of a class.

Examples:

• ZONE:New( 'some zone' ):IsInstanceOf( ZONE ) will return true

• ZONE:New( 'some zone' ):IsInstanceOf( 'ZONE' ) will return true

• ZONE:New( 'some zone' ):IsInstanceOf( 'zone' ) will return true

• ZONE:New( 'some zone' ):IsInstanceOf( 'BASE' ) will return true

• ZONE:New( 'some zone' ):IsInstanceOf( 'GROUP' ) will return false

Enquires if tracing is on (for the class).

BASE constructor.

This is an example how to use the BASE:New() constructor in a new class definition when inheriting from BASE.

function EVENT:New()
  local self = BASE:Inherit( self, BASE:New() ) -- #EVENT
  return self
end

Occurs when an Event for an object is triggered.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that triggered the event.

BDA.

Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when a ground unit captures either an airbase or a farp.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that captured the base place: The airbase that was captured, can be a FARP or Airbase. When calling place:getCoalition() the faction will already be the new owning faction.

Occurs when any object is spawned into the mission.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that was spawned

Occurs when any aircraft crashes into the ground and is completely destroyed.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that has crashed

Occurs when an object is dead.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is dead.

Unknown precisely what creates this event, likely tied into newer damage model.

Will update this page when new information become available.

• initiator: The unit that had the failure.

Discard chair after ejection.

Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when a player loads a dynamic cargo object with the F8 ground crew menu into a helo.

* NOTE * this is a workarounf for DCS not creating these events as of Aug 2024.

Occurs when a dynamic cargo crate is removed.

* NOTE * this is a workarounf for DCS not creating these events as of Aug 2024.

Occurs when a player unloads a dynamic cargo object with the F8 ground crew menu from a helo.

* NOTE * this is a workarounf for DCS not creating these events as of Aug 2024.

Occurs when a pilot ejects from an aircraft Have a look at the class Core.Event#EVENT as these are just the prototypes.

initiator : The unit that has ejected

Occurs when any aircraft shuts down its engines.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is stopping its engines.

Occurs when any aircraft starts its engines.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is starting its engines.

Occurs whenever an object is hit by a weapon.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit object the fired the weapon weapon: Weapon object that hit the target target: The Object that was hit.

Occurs when any system fails on a human controlled aircraft.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that had the failure

Occurs on the death of a unit.

Contains more and different information. Similar to unit_lost it will occur for aircraft before the aircraft crash event occurs. Have a look at the class Core.Event#EVENT as these are just the prototypes.

• initiator: The unit that killed the target
• target: Target Object
• weapon: Weapon Object

Occurs when an aircraft lands at an airbase, farp or ship Have a look at the class Core.Event#EVENT as these are just the prototypes.

initiator : The unit that has landed place: Object that the unit landed on. Can be an Airbase Object, FARP, or Ships

Occurs shortly after the landing animation of an ejected pilot touching the ground and standing up.

Event does not occur if the pilot lands in the water and sub combs to Davey Jones Locker. Have a look at the class Core.Event#EVENT as these are just the prototypes.

• initiator: Static object representing the ejected pilot. Place : Aircraft that the pilot ejected from.
• place: may not return as a valid object if the aircraft has crashed into the ground and no longer exists.
• subplace: is always 0 for unknown reasons.

Landing quality mark.

Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when a new mark was added.

Have a look at the class Core.Event#EVENT as these are just the prototypes. MarkID: ID of the mark.

Occurs when a mark text was changed.

Have a look at the class Core.Event#EVENT as these are just the prototypes. MarkID: ID of the mark.

Occurs when a mark was removed.

Have a look at the class Core.Event#EVENT as these are just the prototypes. MarkID: ID of the mark.

Occurs when a mission ends Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when a mission starts Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when a player creates a dynamic cargo object from the F8 ground crew menu.

* NOTE * this is a workarounf for DCS not creating these events as of Aug 2024.

Weapon add.

Fires when entering a mission per pylon with the name of the weapon (double pylons not counted, infinite wep reload not counted. Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when the pilot of an aircraft is killed.

Can occur either if the player is alive and crashes or if a weapon kills the pilot without completely destroying the plane. Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that the pilot has died in.

Occurs when a player enters a slot and takes control of an aircraft.

Have a look at the class Core.Event#EVENT as these are just the prototypes. NOTE: This is a workaround of a long standing DCS bug with the PLAYER_ENTER_UNIT event. initiator : The unit that is being taken control of.

Occurs when any player assumes direct control of a unit.

Note - not Mulitplayer safe. Use PlayerEnterAircraft. Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is being taken control of.

Occurs when any player relieves control of a unit to the AI.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that the player left.

Occurs when an aircraft connects with a tanker and begins taking on fuel.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is receiving fuel.

Occurs when an aircraft is finished taking fuel.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that was receiving fuel.

Occurs when any modification to the "Score" as seen on the debrief menu would occur.

There is no information on what values the score was changed to. Event is likely similar to player_comment in this regard. Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when any unit stops firing its weapon.

Event will always correspond with a shooting start event. Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that was doing the shooting.

Occurs when any unit begins firing a weapon that has a high rate of fire.

Most common with aircraft cannons (GAU-8), autocannons, and machine guns. Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that is doing the shooting. target: The unit that is being targeted.

Occurs whenever any unit in a mission fires a weapon.

But not any machine gun or autocannon based weapon, those are handled by EVENT.ShootingStart. Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when an aircraft takes off from an airbase, farp, or ship.

Have a look at the class Core.Event#EVENT as these are just the prototypes. initiator : The unit that tookoff place: Object from where the AI took-off from. Can be an Airbase Object, FARP, or Ships

Trigger zone.

Have a look at the class Core.Event#EVENT as these are just the prototypes.

Occurs when the game thinks an object is destroyed.

Have a look at the class Core.Event#EVENT as these are just the prototypes.

• initiator: The unit that is was destroyed.

Schedule a new time event.

Note that the schedule will only take place if the scheduler is started. Even for a single schedule event, the scheduler needs to be started also.

Schedule a new time event.

Note that the schedule will only take place if the scheduler is started. Even for a single schedule event, the scheduler needs to be started also.

Stops the Schedule.

Set the Class Core.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.

Set a state or property of the Object given a Key and a Value.

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

Trace a function logic level 1.

Can be anywhere within the function logic.

Trace a function logic level 2.

Can be anywhere within the function logic.

Trace a function logic level 3.

Can be anywhere within the function logic.

Trace all methods in MOOSE

Set tracing for a class

Set tracing for a specific method of class

Set trace level

Set trace off.

-- Switch the tracing Off
BASE:TraceOff()

Set trace on.

-- Switch the tracing On
BASE:TraceOn()

Set trace on or off Note that when trace is off, no BASE.Debug statement is performed, increasing performance! When Moose is loaded statically, (as one file), tracing is switched off by default.

So tracing must be switched on manually in your mission if you are using Moose statically. When moose is loading dynamically (for moose class development), tracing is switched on by default.

  -- Switch the tracing On
  BASE:TraceOnOff( true )

  -- Switch the tracing Off
  BASE:TraceOnOff( false )

UnSubscribe to a DCS event.

Trace a function call.

This function is private.

(Internal) Serialize arguments

Trace a function logic.

The main event handling function...

This function captures all events generated for the class.