CMM Wiki - User contributions [en-gb]

CMM Map Marker Commands

2026-06-29T13:55:56Z

Ozdeadmeat: /* Support Aircraft Commands */

This is the definitive list of Map Commands for CMM. The first part of the list will be dedicated to standard user commands. Further down will be Admin or 'special permission' based commands.

== Common Commands ==

===!capture===
Description : Captures a facility using the nearest capture truck, mark needs to be near the facility you want to capture (Currently only Airbases)
Usage : !capture

===!register===
Description : Registers a user to the server
Usage : !register

===!email===
Description : Updates the users Email address in the auth table
Usage : !email:myemailaddress@email.com

===!discord===
Description : Updates the users Discord ID in the auth table
Usage : !discord:067067067067067067067

===!accept===
Description : By executing this command near a mission, it will add you to the mission.
Usage : !accept

===!reject===
Description : Will remove the player from closest accepted mission.
Usage : !reject

=== !myinfo ===
Description : Will create a map marker with information about the player in it.
Currently shows, Name, SlotID, UnitID and UCID.
The mark can be deleted by pressing the red X.
Usage : !myinfo

===!myperms===
Description : Will send a text alert to the player displaying the players current permissions
Usage : !myperms

===!clean===
Description : Will clear wrecks, craters etc from the ground within the defined area
Usage : !clean:<radiusInMetersNumber>

===!survey===
Description : Will check if there are objects (excluding trees), and the ground around the point is flat
Usage : !survey:<radiusInMetersNumber>

===!smoke===
Description : Will add a smoke of a specific colour at the mark point location.
Usage : !smoke:<colour>
Valid Smoke Colours are:
red
green
blue
orange
white
Example1 : !smoke: red

===!spin===
Description : Will place a large pin mark on the map as well as put a smoke in the game
Usage : syntax = !spin:<colour>
Valid Colours are:
red
green
blue
orange
white
yellow (will display white smoke)
black (will display white smoke)
Example1 : !spin:green

===!pin===
Description : Will place a large pin mark on the map (same as spin, just without the smoke)
Usage : !pin:<colour>
Valid Colours are:
red
green
blue
orange
white
yellow
black
Example1 : !pin:green

===!flare===
Description : Will place a flare in the game at the specified location
Usage : !flare:<colour>
Valid Colours are:
red
green
orange
white
Example1 : !flare:green

===!illum===
Description : Will place an illum flare in the game at the specified location
Usage : !illum:<brightness#>
Example1 : !illum:5000

===!scan===
Description : Will scan an area around the specified location
Usage : !scan:<boxrange>
Example1 : !scan

===!topo===
Description : Will draw a vector showing what intercept points to the terrain from the specified locations ground elevation.
Usage : !topo

== Support Aircraft Commands ==

===!isr / !tanker / !awacs===
Description : Will move an ISR / TANKER / AWACS platform into the orbit and location specified
Usage : !isr:<ISRPlatformName> -rt <direction>:<distanceKM> -s <speedKnots> -a <altitude>

====Example1 = place drone orbit location====
Example1 : will put <u>Colt11</u> into a ''circular orbit <u>at</u> the specified location''
Usage : !isr:Colt11

====Example2 = place drone in racetrack at location====
Example2 : will put <u>Colt11</u> into a <u>''RaceTrack''</u> orbit that goes <u>'' west 50km''</u>, <u>from</u> the specified location
Usage : !isr:Colt11
-rt 270 50

====Example3 = change altid orbit location====
Example3 : will ''change the altitude'' of <u>Colt11</u> to <u>''20,000ft''</u>, <u>without</u> changing its orbit location
Usage : !isr:Colt11
-dm -a 20000

====Example4 = change the speed ====
Example4 : will ''change the speed'' of <u>Colt11</u> to <u>''350knots''</u>, <u>without</u> changing its orbit location
Usage : !isr:Colt11
-dm -s 350

====Example5 = changes speed, alt & locn ====
Example5 : will ''change the speed, altitude and location'' of <u>Colt11</u> to <u>''175knots''</u>, <u>''14,000ft''</u> and to a <u>''racetrack''</u> going <u>''south 25km''</u>, <u>from</u> the specified location
Usage : !isr:Colt11
-rt 180 25 -s 175 -a 14000

''All these examples are available for'' '''!isr, !tanker''' and '''!awacs''' ''commands.''

== Elevated Permissions Section ==

===!notify===
Description : Will send a message to all players on the server for the specified time
Usage : !notify:<timetodisplay>
<message>
Example1 : !notify:120
Oz spends too much time documenting his map commands

===!arty===
Description : Will drop an Artillery barrage around the specified location (NOTE: will not hit Runway or Taxiways)
Usage : !arty:<rounds>:<areaofeffectinMeters>
Example1 : !arty:25:500

===!explode===
Description : Will make a single explosion at the specified location
Usage : !explode:<explosionstrength>
Example1 : !explode
Example2 : !explode:500

===!deployfatcow===
Description : Deploys a Fatcow at the closest landed player. Player must be stationary on the ground, will send messages to the player when they can left off.
Usage : !deployfatcow

===!savesupport===
Description : Will save the current support orbits for all support units so that the next time the mission executes they will fly the new orbits in the current mission
Usage : !savesupport

===!savestate===
Description : When executed it will stagger saving all mission persistence data to disk. Average save time is approximately 90 seconds.
Usage : !savestate

===!serverreport===
Description : Gives a report on the amount of units in a mission
Usage : !serverreport

===!effectsmoke===
Description : Will add an Fire / Smoke Effect at the specified location
Usage : !effectsmoke:<smokeEffect#>
Valid smoke effect types are:
1 = small smoke and fire
2 = medium smoke and fire
3 = large smoke and fire
4 = huge smoke and fire
5 = small smoke
6 = medium smoke
7 = large smoke
8 = huge smoke
Example1 : !effectsmoke:3

===!removesmoke===
Description : Will remove the closest effectsmoke. (does not work with smokes added with !smoke command)
Usage :

===!removegroup===
Description : Removes the closest group to the mark
Usage : !removegroup

===!spawn===
Description : Spawns a specified group in the vicinity of the marker in a random direction unless defined in the command.
Usage : !spawn:<type>:<direction>
Example1 : !spawn:list (will put a list of all valid spawn types on screen)
Example2 : !spawn:blist (will put a list of valid spawn types for the Blue team on screen)
Example3 : !spawn:rlist (will put a list of valid spawn types for the Red team on screen)
Example4 : !spawn:capturetruck:90 (will spawn a capture truck fasting East)
Example5 : !spawn:supply:135 (will spawn a supply crate fasting South East)

===!additem / !setitem / !removeitem===
Description : Will modify the item to the closest airbase, ship, fob
Usage : !additem:<itemstringname>:<quantity>
Example1 : !addItem:AH-64D_BLK_II:5
Example2 : !addItem:DagiAH64
Example3 : !addItem:weapons.missiles.AGM_114K:100

===!addfuel / !setfuel / !removefuel===
Description : Will modify the fuel levels of the closest airbase, ship, fob.
Usage : !addfuel:<fueltype#>:<quantityInTonnes>
Valid fuel types are:
0 = JetFuel
1 = Aviation Gas
2 = MW50
3 = Diesel
Example1 : !addfuel:0:5

===!makeadmin / !makemod / !makegm / !makepatreon !makemember===
Description : Will add the permission to the closest player pilot
Usage :

===!removeadmin / !removemod / !removegm / !removepatreon===
Description : Will remove the permission to the closest player pilot
Usage :

===!revoke===
Description : Will remove all permissions from the closest pilot
Usage : !revoke

===!refreshauth===
Description : Will reload the CMM.authtable from the CMM.AUTH.File
Usage : !refreshauth

== Development Commands ==

===!gwl===
Description : Will dump a file containing the closest airbases warehouse weapons list into the CMM dump directory and be called 'CMM.WEAPONSLIST.json'
This is more of a mission development command and has no real gameplay value

===!dumpwh===
Description : Will dump a file containing the entire contents of the nearest airbases warehouse (fuel levels, weapons, airframes)
''File will be called '''''<AirbaseName>_Warehouse.json''''' and will be in the CMM dump directory''

===!dumpairb===
Description : Will dump a file containing all data of an airbase
''File will be called '''''<AirbaseName>_AirBase.json''''' and will be in the CMM dump directory''

Data includes but is not limited to:
Callsign, DisplayName, EditorName
AirbaseID#
Runway(s) Information
Warehouse contents
Location

===!point===
Description : Will dump the X,Y,Z of the specified location into the dcs log file
Usage :

GetZone

2026-06-24T12:27:31Z

Ozdeadmeat: GetZone – created via PowerShell script (2026-06-24T22:27:33Z)

{{Template:FunctionInfo|fName= GetZone|fDescription= Returns a zone table by its name|parentFile= cmm.ZoneFunctions.lua|syntax= CMM.GetZone(<string>)|return= table or nil|returnDesc= Returns a zone table if found, otherwise nil.|example= CMM.GetZone("Zone15",1000)|exampleDesc= Returns a zone table for the zone named "Zone15", or nil if not found.|related= |note= |envType= CMM|par1= string zoneName|reqType1= string|reqName1= zoneName|desc1= Name of the zone as defined in the mission editor.}}

GenerateSortieReport

2026-06-24T12:27:30Z

Ozdeadmeat: GenerateSortieReport – created via PowerShell script (2026-06-24T22:27:32Z)

{{Template:FunctionInfo|fName= GenerateSortieReport|fDescription= Adds a sortie event to the sortie tracking system using a custom event table, enabling post-event processing such as scoring, notifications, and sortie bank scheduling. The function accepts a table with event data and processes it accordingly. Can be executed during a sortie|parentFile= cmm.XpFunctions.lua|syntax= CMM.GenerateSortieReport(Aircraft <table>, UCID <string>)|return= string or nil,number or nil,number or nil|returnDesc= Returns a string containing the sortie report message, the total sortie time in seconds, and the total score earned during the sortie.|example= CMM.GenerateSortieReport(Unit.getByName("PlayerUnit"), "UCID")|exampleDesc= This would generate a sortie report for the specified player's aircraft, including a breakdown of events, total sortie time, and score earned, which can then be used for notifications and banking the sortie score.|related= |note= |envType= CMM|par1= table Aircraft|reqType1= table|reqName1= Aircraft|desc1= Aircraft (unit) table containing the unit data of the aircraft for which the sortie report is being generated.|par2= string UCID|reqType2= string|reqName2= UCID|desc2= The unique client ID of the player for whom the sortie report}}

GatherDebugEventData

2026-06-24T12:27:30Z

Ozdeadmeat: GatherDebugEventData – created via PowerShell script (2026-06-24T22:27:32Z)

{{Template:FunctionInfo|fName= GatherDebugEventData|fDescription= Adds a sortie event to the sortie tracking system using a custom event table, enabling post-event processing such as scoring, notifications, and sortie bank scheduling. The function accepts a table with event data and processes it accordingly.|parentFile= cmm.XpFunctions.lua|syntax= CMM.GatherDebugEventData(EventData <table>)|return= table|returnDesc= Returns a table containing processed event information into a human readable format, including timestamps, event types, and relevant metadata for debugging purposes.|example= CMM.GatherDebugEventData({id = world.event.S_EVENT_LAND, initiator = unit, place = location})|exampleDesc= This would return an event events and schedules a sortie bank task after a land event, ensuring proper scoring and notification logic is applied.|related= |note= |envType= CMM|par1= table EventData|reqType1= table|reqName1= EventData|desc1= Table containing event data from a DCS event, including initiator and other items}}

AWARD CARRIERLANDING

2026-06-24T12:27:29Z

Ozdeadmeat: AWARD_CARRIERLANDING – created via PowerShell script (2026-06-24T22:27:31Z)

{{Template:FunctionInfo|fName= AWARD_CARRIERLANDING|fDescription= Checks if a player earned a refueling bonus during a sortie by measuring the time between the start of refueling and its end, awarding the bonus if it exceeds 30 seconds and the player hasn't already received it.|parentFile= cmm.XpFunctions.lua|syntax= CMM.AWARD_CARRIERLANDING(PlayerAircraft <table>)|return= |returnDesc= |example= CMM.AWARD_CARRIERLANDING(PlayerAircraft)|exampleDesc= Sets the Sortie Bonus for a Carrier Landing for all crew members in the airframe.|related= |note= --TODO Code review required|envType= CMM|par1= table PlayerAircraft|reqType1= table|reqName1= PlayerAircraft|desc1= Event table from a refueling stopped event containing initiator, time, and position; used to determine the duration of refueling and trigger award logic.}}

AWARD REFUEL

2026-06-24T12:27:29Z

Ozdeadmeat: AWARD_REFUEL – created via PowerShell script (2026-06-24T22:27:31Z)

{{Template:FunctionInfo|fName= AWARD_REFUEL|fDescription= Checks if a player earned a refueling bonus during a sortie by measuring the time between the start of refueling and its end, awarding the bonus if it exceeds 30 seconds and the player hasn't already received it.|parentFile= cmm.XpFunctions.lua|syntax= CMM.AWARD_REFUEL(EventData <TBL>)|return= |returnDesc= |example= CMM.AWARD_REFUEL({initiator = 12345, time = 1640995200})|exampleDesc= Processes a refueling stop event to verify if the refueling duration exceeds 30 seconds and awards a bonus if valid, otherwise notifies the player that the bonus was already earned.|related= |note= --TODO Code review required|envType= CMM|par1= table PlayerAircraft|reqType1= table|reqName1= PlayerAircraft|desc1= Event table from a refueling stopped event containing initiator, time, and position; used to determine the duration of refueling and trigger award logic.}}

Dump.AllPlayerData

2026-06-24T12:27:28Z

Ozdeadmeat: dump.AllPlayerData – created via PowerShell script (2026-06-24T22:27:30Z)

{{Template:FunctionInfo|fName= dump.AllPlayerData|fDescription= |parentFile= cmm.tools.lua|syntax= CMM.dump.AllPlayerData()|return= nil|returnDesc= Writes an audit entry to CMM.dump.Directory/cmm.AllPlayerData.json|example= CMM.dump.AllPlayerData()|exampleDesc= |related= |note= |envType= CMM}}

Tools.drawGlobalPoly

2026-06-24T12:27:27Z

Ozdeadmeat: tools.drawGlobalPoly – created via PowerShell script (2026-06-24T22:27:29Z)

{{Template:FunctionInfo|fName= tools.drawGlobalPoly|fDescription= Draws a set of global vec3 points as a single drawing.|parentFile= cmm.tools.lua|syntax= CMM.tools.drawPoly(PointsArray <TBL>)|return= nil|returnDesc= Returns nothing, triggers a marker overlay on the map with the polygon shape.|example= CMM.tools.drawPoly({x=100, y=200, z=0}, {{dir={x=1, y=0, z=0}, range=50}, {dir={x=0, y=1, z=0}, range=30}})|exampleDesc= Creates a polygon with two relative points, one to the right and one upward from the base position, drawing a visible shape with default line and fill colors.|related= |note= |envType= CMM|par1= table PointsArray|reqType1= table|reqName1= PointsArray|desc1= Table of relative point definitions, each containing 'dir' and 'range' fields specifying direction and distance to offset from the base position.|par2= table Line|reqType2= table|reqName2= Line|desc2= R,G,B,A values for line color (0-1 range)|par3= table Fill|reqType3= table|reqName3= Fill|desc3= R,G,B,A values for fill color (0-1 range}}

Tools.BuildWPpointTable

2026-06-24T12:27:27Z

Ozdeadmeat: tools.BuildWPpointTable – created via PowerShell script (2026-06-24T22:27:29Z)

{{Template:FunctionInfo|fName= tools.BuildWPpointTable|fDescription= Constructs a table of waypoints based on a group's waypoints and a specified mode. It calculates positions relative to a unit or origin point, supporting different modes for position derivation. Returns a table of vectors or nil if group or mode is invalid.|parentFile= cmm.tools.lua|syntax= CMM.tools.BuildWPpointTable(GroupName <string>, Mode <number>, SkipFirst <boolean>)|return= table or nil|returnDesc= Returns a table of vectors representing the waypoints, or nil if group not found or no waypoints exist.|example= CMM.tools.BuildWPpointTable("WhyUbreakMyShitED",2,true)|exampleDesc= Extracts relative positions from the group "WhyUbreakMyShitED", skipping the first waypoint, using mode 2 for relative positioning.|related= |note= |envType= CMM|par1= string GroupName|reqType1= string|reqName1= GroupName|desc1= Name of the group containing waypoints to extract. Must be a valid group name defined in the mission editor.|par2= number or nil Mode|optType2= number or nil|optName2= Mode|desc2= Mode for position calculation (0 = raw positions, 1 = relative to first unit, 2 = relative to unit position using CMM.GetRelativePosition). Defaults to 1 if not provided.|par3= boolean or nil SkipFirst|optType3= boolean or nil|optName3= SkipFirst|desc3= If true, skips the first waypoint in the group. Defaults to false.}}

Tools.BuildNewMarkerPointTable

2026-06-24T12:27:27Z

Ozdeadmeat: tools.BuildNewMarkerPointTable – created via PowerShell script (2026-06-24T22:27:29Z)

{{Template:FunctionInfo|fName= tools.BuildNewMarkerPointTable|fDescription= Creates a table of marker points from a specified group, with options to define position mode and skip the first waypoint. The function uses internal waypoint processing to derive positions either as world coordinates, relative to the first unit, or via heading and distance. Returns a table of waypoints or nil if invalid input.|parentFile= cmm.tools.lua|syntax= CMM.tools.BuildNewMarkerPointTable(GroupName <string>, Mode <number>, SkipFirst <boolean>)|return= table or nil|returnDesc= Returns a table containing the processed waypoints or nil if group not found or no waypoints exist.|example= CMM.tools.BuildNewMarkerPointTable("DebrisArea",1,false)|exampleDesc= Generates a table of waypoints from the group "DebrisArea" using relative positioning to the first unit, without skipping the first point.|related= |note= |envType= CMM|par1= string GroupName|reqType1= string|reqName1= GroupName|desc1= Name of the group in the mission editor containing waypoints to extract. Must be valid and defined in the mission.|par2= number or nil Mode|optType2= number or nil|optName2= Mode|desc2= Mode for position derivation: 0 = world positions, 1 = relative to first unit (default), 2 = heading and distance from first unit. Defaults to 1 if not specified.|par3= boolean or nil SkipFirst|optType3= boolean or nil|optName3= SkipFirst|desc3= If true, the first waypoint in the group is skipped. Defaults to false.|par4= boolean or nil WriteToFile|optType4= boolean or nil|optName4= WriteToFile|desc4= If true, will write the CMM.DEV}}

TemplateBuilder

2026-06-24T12:27:22Z

Ozdeadmeat: TemplateBuilder – created via PowerShell script (2026-06-24T22:27:24Z)

{{Template:FunctionInfo|fName= TemplateBuilder|fDescription= Builds Saved Tempates|parentFile= cmm.templates.lua|syntax= CMM.TemplateBuilder(pos <TBL>, dir <number>, TemplateName <string>, BuildSide <number>, BuildTime <number>)|return= string or nil|returnDesc= Returns the name prefix for the template or nil if error|example= CMM.TemplateBuilder({x,y,z}, 33,"FOB_01", 81, 300)|exampleDesc= Build a template named FOB_01 in the direction of 33 facing the country side 81 and have it complete the build process in 300 seconds|related= |note= |envType= CMM|par1= table pos|reqType1= table|reqName1= pos|desc1= vec3 table|par2= number dir|reqType2= number|reqName2= dir|desc2= Direction the template will face when deployed|par3= string DeploymentName|reqType3= string|reqName3= DeploymentName|desc3= Name of the Deployment, (Do Check if unique against CMM.DEPLOYED)|par4= string TemplateName|reqType4= string|reqName4= TemplateName|desc4= Name of the template to lookup|par5= number BuildCountry|reqType5= number|reqName5= BuildCountry|desc5= The country side to build the template for|par6= number BuildTime|reqType6= number|reqName6= BuildTime|desc6= How long you want the build to take to complete|par7= table or nil FARPSettings|optType7= table or nil|optName7= FARPSettings|desc7= How long you want the build to take to complete}}

ScheduleSpawnFARPObject

2026-06-24T12:27:22Z

Ozdeadmeat: ScheduleSpawnFARPObject – created via PowerShell script (2026-06-24T22:27:24Z)

{{Template:FunctionInfo|fName= ScheduleSpawnFARPObject|fDescription= Spawns a FARP object with a set of parameters supplied|parentFile= cmm.templates.lua|syntax= CMM.ScheduleSpawnFARPObject(argTable <TBL>)|return= nil|returnDesc= Returns nothing but spawns a static object based on the arguments provided and adds it to the CMM.DEPLOYED table for tracking|example= CMM.ScheduleSpawnFARPObject({TemplateTBL = "FOB_01#01245", GroupName = "FOB_01#01245_FARP", Country = 82, SpawnPoint = {x=0,y=0,z=0}, Heading = 33, DynamicSpawn = true, Hotstart = false})|exampleDesc= Returns nothing but spawns the FARP object and then adds it to the CMM.DEPLOYED table for tracking under the "FOB_01#01245" template|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= Argument table for spawning FARP objects, {TemplateTBL <string>, GroupName <string>, Country <number>, SpawnPoint <table vec3>, Heading <number>, DynamicSpawn <boolean>, Hotstart <boolean>, DynamicCargo <boolean>}}}

GetNewMarkerID

2026-06-24T12:27:18Z

Ozdeadmeat: GetNewMarkerID – created via PowerShell script (2026-06-24T22:27:20Z)

{{Template:FunctionInfo|fName= GetNewMarkerID|fDescription= Generates a unique convoy group name by incrementing a counter until a name not already in use is found, ensuring no name conflicts with existing groups.|parentFile= cmm.spawnFunctions.lua|syntax= CMM.GetNewMarkerID()|return= string|returnDesc= Returns a new available convoy group name in the format "Convoy#XXXX" where XXXX is a zero-padded number, or "NO-NEW-CONVOY-NAME" if no unique name can be found after maximum retries.|example= CMM.GetNewMarkerID()|exampleDesc= Invokes the function to generate a unique convoy name, such as "Convoy#0001", ensuring it does not conflict with existing group names in the mission.|related= |note= --TODO CODE REVIEW REQUIRED|envType= CMM}}

SpawnGroundUnitInZoneScheduledTaskFunction

2026-06-24T12:27:17Z

Ozdeadmeat: SpawnGroundUnitInZoneScheduledTaskFunction – created via PowerShell script (2026-06-24T22:27:19Z)

{{Template:FunctionInfo|fName= SpawnGroundUnitInZoneScheduledTaskFunction|fDescription= Scheduled task function that spawns ground units in a specified zone using a provided unit type table, country, and optional limits and road constraints. It validates input parameters and delegates execution to CMM.SpawnGroundUnitInZone.|parentFile= cmm.spawnFunctions.lua|syntax= CMM.SpawnGroundUnitInZoneScheduledTaskFunction(<argTable table>)|return= nil|returnDesc= Returns nothing, as the function performs spawning and does not return a value.|example= CMM.SpawnGroundUnitInZoneScheduledTaskFunction({"Area-10", 1, {"T-72", "BTR-80"}, 100, true})|exampleDesc= Schedules the spawning of up to 100 units in "Area-10" using T-72 and BTR-80 units, assigned to BLUFOR, with all spawns forced to occur on roads.|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= {ZoneName <string>, Country <number>, UnitTypeTable <TBL>, UnitLimit <number>, ForceRoad <boolean>} – Table containing zone name, country ID, list of unit types, maximum unit count, and whether to force spawns on roads.}}

GetRouteDistancePoints

2026-06-24T12:27:16Z

Ozdeadmeat: GetRouteDistancePoints – created via PowerShell script (2026-06-24T22:27:18Z)

{{Template:FunctionInfo|fName= GetRouteDistancePoints|fDescription= Calculates a series of points along a road path at a specified distance, starting from the first point and progressing sequentially until the target distance is reached. It adds each point to a table, stopping when the cumulative distance exceeds the specified value or reaches the end of the path.|parentFile= cmm.spawnFunctions.lua|syntax= CMM.PointsOnRoad(PathOnRoadsTbl <TBL>, distance <number>)|return= table|returnDesc= Returns a set of vec2 points where the numbers are less than|example= CMM.PointsOnRoad({{x=100,y=200},{x=300,y=400},{x=500,y=600}}, 3000)|exampleDesc= Retrieves points along a road path from (100,200) to (500,600), measuring 3000 units, and returns a table of points that lie within that distance.|related= |note= |envType= CMM|par1= table PathOnRoadsTbl|reqType1= table|reqName1= PathOnRoadsTbl|desc1= Array of road points, each containing x and y coordinates, representing a path to traverse.|par2= table percPoints|reqType2= table|reqName2= percPoints|desc2= Table of numbers from 0.01 - 0.99 as percentages}}

GetRouteDistance

2026-06-24T12:27:15Z

Ozdeadmeat: GetRouteDistance – created via PowerShell script (2026-06-24T22:27:17Z)

{{Template:FunctionInfo|fName= GetRouteDistance|fDescription= Calculates a series of points along a road path at a specified distance, starting from the first point and progressing sequentially until the target distance is reached. It adds each point to a table, stopping when the cumulative distance exceeds the specified value or reaches the end of the path.|parentFile= cmm.spawnFunctions.lua|syntax= CMM.GetRouteDistance(PathOnRoadsTbl <TBL>)|return= number|returnDesc= Table containing the points along the path that are at or within the specified distance from the start.|example= CMM.GetRouteDistance({{x=100,y=200},{x=300,y=400},{x=500,y=600}})|exampleDesc= Measures the total distance along the path defined by the points (100,200), (300,400), and (500,600) by calculating the 2D distance between each consecutive point and summing them up, returning the total distance as a number.|related= |note= |envType= CMM|par1= table PathOnRoadsTbl|reqType1= table|reqName1= PathOnRoadsTbl|desc1= Array of vec2 road points, each containing x and y coordinates, representing a path to traverse.}}

OutSoundForCoalition

2026-06-24T12:27:13Z

Ozdeadmeat: outSoundForCoalition – created via PowerShell script (2026-06-24T22:27:15Z)

{{Template:FunctionInfo|fName= outSoundForCoalition|fDescription= Plays a randomly selected sound from a table or a single sound string, with support for both string and table inputs. If a table is provided, a random entry is chosen; if a string is provided, that sound is played directly.|parentFile= cmm.soundFunctions.lua|syntax= CMM.outSoundForCoalition(SOUND <table|string>)|return= nil|returnDesc= Returns nothing, plays the selected sound using trigger.action.outSound.|example= CMM.outSoundForCoalition({"SOUNDS/CMM/XP_Banked_1.ogg", "SOUNDS/CMM/XP_Banked_2.ogg"})|exampleDesc= Plays a randomly selected sound from the provided list of sound files, simulating a banked event with varied audio feedback.|related= |note= |envType= CMM|par1= table or string SOUND|reqType1= table or string|reqName1= SOUND|desc1= REQUIRED, either a string path to a sound file or a table of sound file paths. If a table, a random entry is selected; if a string, the sound is played directly.}}

OutSoundForCoalition

2026-06-24T12:27:13Z

Ozdeadmeat: outSoundForCoalition – created via PowerShell script (2026-06-24T22:27:15Z)

{{Template:FunctionInfo|fName= outSoundForCoalition|fDescription= Plays a sound specific to a coalition, with support for either a single sound string or a table of sound strings. The coalition is defined by a number (0=NEUTRAL, 1=RED, 2=BLUE), defaulting to BLUE if invalid. A random sound is selected from a table or played directly if a string is provided.|parentFile= cmm.soundFunctions.lua|syntax= CMM.outSoundForCoalition(COAL <number>, SOUND <table|string>)|return= nil|returnDesc= Returns nothing, plays the selected sound using trigger.action.outSoundForCoalition.|example= CMM.outSoundForCoalition(2, "SOUNDS/CMM/XP_Banked_3.ogg") or CMM.outSoundForCoalition(2, CMM.SOUNDS.XPBanked)|exampleDesc= Plays a BLUE-specific sound, either a single file or a randomly selected file from a predefined list, simulating a banked event with coalition-aware audio feedback.|related= |note= |envType= CMM|par1= number COAL|reqType1= number|reqName1= COAL|desc1= REQUIRED, coalition value (0 = NEUTRAL, 1 = RED, 2 = BLUE); defaults to 2 if outside valid range.|par2= table or string SOUND|reqType2= table or string|reqName2= SOUND|desc2= REQUIRED, either a string path to a sound file or a table of sound file paths. If a table, a random entry is selected; if a string, the sound is played directly.}}

GetCargoState

2026-06-24T12:27:12Z

Ozdeadmeat: GetCargoState – created via PowerShell script (2026-06-24T22:27:14Z)

{{Template:FunctionInfo|fName= GetCargoState|fDescription= Gets the Max Wounded, Personnel , maxmass and current weight of cargo on board the player's current airframe. Returns a table with the cargo state information or nil if an error occurs. Logs informational messages for errors or successful retrievals.|parentFile= cmm.sideMissionFunctions.lua|syntax= CMM.GetCargoState(UnitObject <table>)|return= nil or table|returnDesc= Returns a table containing the cargo state information (max wounded, max personnel, max,cargo, max weight, current weight) or nil if an error occurs.|example= CMM.Miz.CheckAirFrame(player, "CargoMission")|exampleDesc= Verifies that the player's airframe has the required cargo capacity for a cargo mission, returning true if valid and logging the match details.|related= |note= |envType= CMM|par1= table UnitObject|reqType1= table|reqName1= UnitObject|desc1= Player object}}

Miz.CheckAirFrame

2026-06-24T12:27:12Z

Ozdeadmeat: Miz.CheckAirFrame – created via PowerShell script (2026-06-24T22:27:14Z)

{{Template:FunctionInfo|fName= Miz.CheckAirFrame|fDescription= Checks if a player's airframe is compatible with a specified mission type by comparing the airframe's cargo capacity against the mission's required cargo type. Returns true if the airframe has sufficient cargo capacity, otherwise returns false. Logs informational messages for errors or successful matches.|parentFile= cmm.sideMissionFunctions.lua|syntax= CMM.Miz.CheckAirFrame(playerObject <object>, MissionType <string>)|return= boolean|returnDesc= Returns true if the airframe meets the mission's cargo requirement, false otherwise.|example= CMM.Miz.CheckAirFrame(player, "CargoMission")|exampleDesc= Verifies that the player's airframe has the required cargo capacity for a cargo mission, returning true if valid and logging the match details.|related= |note= |envType= CMM|par1= table playerObject|reqType1= table|reqName1= playerObject|desc1= Player object to retrieve the airframe type from, must have a getTypeName method.|par2= string MissionType|reqType2= string|reqName2= MissionType|desc2= The mission type string, case-insensitive, used to determine cargo requirements from sidequest data.}}

GetTerrainHeightFlatness

2026-06-24T12:27:12Z

Ozdeadmeat: GetTerrainHeightFlatness – created via PowerShell script (2026-06-24T22:27:14Z)

{{Template:FunctionInfo|fName= GetTerrainHeightFlatness|fDescription= Returns a height difference value|parentFile= cmm.positionFunctions.lua|syntax= CMM.GetTerrainHeightFlatness(vec3<table>)|return= number or boolean or nil|returnDesc= Returns a number if all items are valid, if a limit number is defined it will return a boolean if it is within the limit or not, if the vec3 is invalid it will return nil|example= CMM.GetTerrainHeightFlatness({x=100, y=50, z=10})|exampleDesc= Returns the closest point on the road network to the given position, or the original position if no roads are found.|related= |note= |envType= CMM|par1= table vec3|reqType1= table|reqName1= vec3|desc1= Vec3 table with x, y, z coordinates|par2= number or nil radius|optType2= number or nil|optName2= radius|desc2= A number representing the radius in meters around the point to sample terrain heights [DEFAULT: 30]|par3= number or nil limit|optType3= number or nil|optName3= limit|desc3= An optional number representing a maximum acceptable height difference; if provided, the function will return a boolean indicating whether the height difference is within this limit.}}

GetClosestPointOnRoads

2026-06-24T12:27:12Z

Ozdeadmeat: GetClosestPointOnRoads – created via PowerShell script (2026-06-24T22:27:14Z)

{{Template:FunctionInfo|fName= GetClosestPointOnRoads|fDescription= Converts a heading in degrees into a forward Vec3 vector.|parentFile= cmm.positionFunctions.lua|syntax= CMM.GetClosestPointOnRoads(vec3<table>)|return= table or nil|returnDesc= Closest Road Vec3 vector {x, y, z}|example= CMM.GetClosestPointOnRoads({x=100, y=50, z=10})|exampleDesc= Returns the closest point on the road network to the given position, or the original position if no roads are found.|related= |note= |envType= CMM|par1= table vec3|reqType1= table|reqName1= vec3|desc1= Vec3 table with x, y, z coordinates}}

IsDegrees

2026-06-24T12:27:08Z

Ozdeadmeat: IsDegrees – created via PowerShell script (2026-06-24T22:27:10Z)

{{Template:FunctionInfo|fName= IsDegrees|fDescription= Checks whether a given number is within the valid degree range of 0 to 360 inclusive.|parentFile= cmm.positionFunctions.lua|syntax= CMM.IsDegrees(value <number>)|return= boolean|returnDesc= Returns true if the value is a number between 0 and 360 (inclusive), otherwise false.|example= CMM.IsDegrees(270)|exampleDesc= Checks if 270 is a valid degree value, returning true.|related= |note= |envType= CMM|par1= number value|reqType1= number|reqName1= value|desc1= The numeric value to validate as a degree measurement.}}

LogPointsTransaction

2026-06-24T12:27:06Z

Ozdeadmeat: LogPointsTransaction – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= LogPointsTransaction|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.CreatePlayerTransactionLogFile(ArgTable<table>)|return= nil|returnDesc= Returns nothing, but creates the Player Transaction Log entry at CMM.POINTS.AuditLogPath with the details of the transaction|example= CMM.CreatePlayerTransactionLogFile({true, "12345", "Ned Flanders", 9001, 10001, "Ned had 1000 points before this transaction"})|exampleDesc= Enters a transaction into the Player Transaction Log, with the details of a successful transaction for player Ned Flanders (12345) where 9001 points were added to his balance of 10001, with the note "Ned had 1000 points before this transaction"|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= ArgTable = {Success<boolean>, UCID<string>, Name<string>, Value<number>, Balance<number>, Note<string>}}}

CreatePlayerTransactionLogFile

2026-06-24T12:27:06Z

Ozdeadmeat: CreatePlayerTransactionLogFile – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= CreatePlayerTransactionLogFile|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.CreatePlayerTransactionLogFile()|return= nil|returnDesc= Returns nothing, but creates the Player Transaction Log file if it does not already exist at CMM.POINTS.AuditLogPath|example= CMM.CreatePlayerTransactionLogFile()|exampleDesc= Creates the Player Transaction Log file if it does not already exist at <CMM.PDIR>\POINTS\PlayerPointsTransaction.log|related= |note= |envType= CMM}}

AwardPlayerPoints

2026-06-24T12:27:06Z

Ozdeadmeat: AwardPlayerPoints – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= AwardPlayerPoints|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.AwardPlayerPoints()|return= boolean,number,string or nil|returnDesc= Returns boolean true if the operation succeeded, false if it failed, can be accompained by a string message describing the failure reason, or nil if no message is provided.|example= CMM.ModifyPlayerPoints({[1] = Unit.getByName("PlayerUnit"), [2] = "PlayerUCID", [3] = -1000, [4] = "Spent on a new plane!"})|exampleDesc= Saves the ServerPoints out to <CMM.PDIR>\POINTS\PlayerServerPoints.json|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= ArgTable = {Unit_GIFTER, Unit_GIFTEE, Points, Note}}}

ModifyPlayerPoints

2026-06-24T12:27:06Z

Ozdeadmeat: ModifyPlayerPoints – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= ModifyPlayerPoints|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.ModifyPlayerPoints()|return= boolean,number,string or nil|returnDesc= Returns boolean true if the operation succeeded, false if it failed, can be accompained by a string message describing the failure reason, or nil if no message is provided.|example= CMM.ModifyPlayerPoints({[1] = Unit.getByName("PlayerUnit"), [2] = "PlayerUCID", [3] = -1000, [4] = "Spent on a new plane!"})|exampleDesc= Saves the ServerPoints out to <CMM.PDIR>\POINTS\PlayerServerPoints.json|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= ArgTable = {Unit, UCID, Points, Note}}}

SaveServerPoints

2026-06-24T12:27:06Z

Ozdeadmeat: SaveServerPoints – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= SaveServerPoints|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.SaveServerPoints()|return= nil|returnDesc= Returns nothing but saves the ServerPoints out to CMM\SERVER_PERSISTENCE\POINTS\PlayerServerPoints.json|example= CMM.SaveServerPoints()|exampleDesc= Saves the ServerPoints out to <CMM.PDIR>\POINTS\PlayerServerPoints.json|related= |note= |envType= CMM}}

GetPlayerPoints

2026-06-24T12:27:06Z

Ozdeadmeat: GetPlayerPoints – created via PowerShell script (2026-06-24T22:27:08Z)

{{Template:FunctionInfo|fName= GetPlayerPoints|fDescription= |parentFile= cmm.pointsFunctions.lua|syntax= CMM.GetPlayerPoints({Unit <table>, UCID <string>})|return= number|returnDesc= Returns the current Points balance for the player, if no record exists for the player, one is created with a balance of 0 and returned.|example= CMM.GetPlayerPoints({[1] = Unit.getByName("PlayerUnit"), [2] = "PlayerUCID"})|exampleDesc= Returns the player points for player with UCID of "PlayerUCID"|related= |note= |envType= CMM|par1= table argTable|reqType1= table|reqName1= argTable|desc1= ArgTable = {Unit, UCID}}}

ClearPersistence

2026-06-24T12:27:05Z

Ozdeadmeat: ClearPersistence – created via PowerShell script (2026-06-24T22:27:07Z)

{{Template:FunctionInfo|fName= ClearPersistence|fDescription= Removes all Persistence Files from PERSISTENCE directory|parentFile= cmm.persistence.lua|syntax= CMM.ClearPersistence()|return= nil|returnDesc= Returns nothing|example= CMM.ClearPersistence()|exampleDesc= Removes all files within the PERSISTENCE directory|related= |note= |envType= CMM}}

SavePersistence

2026-06-24T12:27:05Z

Ozdeadmeat: SavePersistence – created via PowerShell script (2026-06-24T22:27:07Z)

{{Template:FunctionInfo|fName= SavePersistence|fDescription= Saves All Persistence Files to default locations|parentFile= cmm.persistence.lua|syntax= CMM.SavePersistence()|return= nil|returnDesc= Returns nothing|example= CMM.SavePersistence()|exampleDesc= Saves all persistence files to their default locations, including groups, POI state, banked tables, support tables, FOB persistence, and airbase persistence, ensuring all campaign data is stored for future missions.|related= |note= |envType= CMM|par1= number or nil time2save|optType1= number or nil|optName1= time2save|desc1= Optional time in seconds to save, defaults to 30 seconds if not provided or invalid.|par2= table or nil savefunctions|optType2= table or nil|optName2= savefunctions|desc2= Optional table of specific save functions to call instead of the default set; if nil, all default persistence save functions will be called.}}

SavePlayerBankTable

2026-06-24T12:27:04Z

Ozdeadmeat: SavePlayerBankTable – created via PowerShell script (2026-06-24T22:27:06Z)

{{Template:FunctionInfo|fName= SavePlayerBankTable|fDescription= Saves the current player bank data to a JSON persistence file in the mission directory, ensuring data is stored for future missions.|parentFile= cmm.persistence.lua|syntax= CMM.SavePlayerBankTable()|return= nil|returnDesc= Returns nothing, writes the player bank data to the persistence file and logs completion.|example= CMM.SavePlayerTBankTable()|exampleDesc= Saves the current player bank data to CMM.PERSISTENCE_PLAYERDATA.json in the mission directory.|related= |note= |envType= CMM}}

SaveSupportTable

2026-06-24T12:27:03Z

Ozdeadmeat: SaveSupportTable – created via PowerShell script (2026-06-24T22:27:05Z)

{{Template:FunctionInfo|fName= SaveSupportTable|fDescription= Saves the current AirSupportTable configuration to a JSON file in the mission directory, ensuring the directory exists and handling errors gracefully if the table or path is invalid.|parentFile= cmm.persistence.lua|syntax= CMM.SaveSupportTable(FilePath <string>)|return= nil|returnDesc= Returns nothing.|example= CMM.SaveSupportTable("Custom/CMM.PERSISTENCE_SUPPORTAIRCRAFT.json")|exampleDesc= Saves the current air support configuration to a custom JSON file, creates the directory if needed, and logs warnings if the table is missing or the path is invalid.|related= |note= |envType= CMM|par1= string or nil FilePath|optType1= string or nil|optName1= FilePath|desc1= Optional path to save the CMM.PERSISTENCE_SUPPORTAIRCRAFT.json file; if not provided, defaults to CMM.MISSION.PDir .. "CMM.PERSISTENCE_SUPPORTAIRCRAFT.json".|par2= boolean or nil DumpLua|optType2= boolean or nil|optName2= DumpLua|desc2= Optional, will save out the SUPPORT_TABLE.lua file to the CMM.DUMPDIR if true, defaults to false if not provided.}}

LoadSupportTable

2026-06-24T12:27:02Z

Ozdeadmeat: LoadSupportTable – created via PowerShell script (2026-06-24T22:27:04Z)

{{Template:FunctionInfo|fName= LoadSupportTable|fDescription= Loads an air support configuration table from a JSON file in the mission directory, clears specific marker fields to prevent conflicts, and falls back to default values if the file is missing or invalid.|parentFile= cmm.persistence.lua|syntax= CMM.LoadSupportTable(FilePath <string>)|return= nil|returnDesc= Returns nothing.|example= CMM.LoadSupportTable("Custom/CMM.PERSISTENCE_SUPPORTAIRCRAFT.json")|exampleDesc= Loads a custom air support table from a specified JSON file, clears MarkerIdName and MarkerIdOrbit fields to avoid data corruption, and uses defaults if the file is missing.|related= |note= |envType= CMM|par1= string FilePath|reqType1= string|reqName1= FilePath|desc1= Optional path to the CMM.PERSISTENCE_SUPPORTAIRCRAFT.json file; if not provided, defaults to CMM.MISSION.PDir .. "CMM.PERSISTENCE_SUPPORTAIRCRAFT.json".}}

SaveBankedTable

2026-06-24T12:27:02Z

Ozdeadmeat: SaveBankedTable – created via PowerShell script (2026-06-24T22:27:04Z)

{{Template:FunctionInfo|fName= SaveBankedTable|fDescription= Saves the current campaign banked data to a JSON file in the mission directory, formatting it as pretty-printed JSON for readability and ensuring persistence across mission reloads.|parentFile= cmm.persistence.lua|syntax= CMM.SaveBankedTable()|return= nil|returnDesc= Returns nothing.|example= CMM.SaveBankedTable()|exampleDesc= Saves the current CMM.BANKED table to CMM.PERSISTENCE_CAMPAIGNBANK.json in the mission directory with pretty-printed formatting.|related= |note= |envType= CMM}}

LoadBankedTable

2026-06-24T12:27:02Z

Ozdeadmeat: LoadBankedTable – created via PowerShell script (2026-06-24T22:27:04Z)

{{Template:FunctionInfo|fName= LoadBankedTable|fDescription= Loads the campaign banked data from a JSON persistence file located in the mission directory, or initialises default values if the file is missing, then saves the data to ensure persistence.|parentFile= cmm.persistence.lua|syntax= CMM.LoadBankedTable()|return= nil|returnDesc= Returns nothing.|example= CMM.LoadBankedTable()|exampleDesc= Loads the campaign banked data from the CMM.PERSISTENCE_CAMPAIGNBANK.json file in the mission directory, using default values if the file does not exist.|related= |note= |envType= CMM}}

SaveGroupsToFile

2026-06-24T12:27:02Z

Ozdeadmeat: SaveGroupsToFile – created via PowerShell script (2026-06-24T22:27:04Z)

{{Template:FunctionInfo|fName= SaveGroupsToFile|fDescription= Saves current group data for RED and BLUE sides to persistence files, with optional file paths and save flags. If no file path is provided, defaults are used. Returns true if both files were saved successfully.|parentFile= cmm.persistence.lua|syntax= CMM.SaveGroupsToFile(RedGroundFile <string|nil>, BlueGroundFile <string|nil>, SaveRed <boolean|nil>, SavedBlue <boolean|nil>)|return= boolean|returnDesc= Returns true if both RED and BLUE persistence files were saved successfully, false otherwise.|example= CMM.SaveGroupsToFile("custom_red.json", "custom_blue.json", true, false)|exampleDesc= Saves RED group data to custom_red.json and skips saving BLUE data, using custom file paths.|related= |note= |envType= CMM|par1= boolean or nil SaveRed|optType1= boolean or nil|optName1= SaveRed|desc1= Flag indicating whether to save RED group data (defaults to true if not provided).|par2= boolean or nil SaveBlue|optType2= boolean or nil|optName2= SaveBlue|desc2= Flag indicating whether to save BLUE group data (defaults to true if not provided).}}

ClearPOIState

2026-06-24T12:27:01Z

Ozdeadmeat: ClearPOIState – created via PowerShell script (2026-06-24T22:27:03Z)

{{Template:FunctionInfo|fName= ClearPOIState|fDescription= Deletes persistent POI and POI names data files from specified locations, clearing associated variables. If default paths are provided, a warning is issued and no files are deleted.|parentFile= cmm.persistence.lua|syntax= CMM.ClearPOIState(ACTIVEPOI <string|nil>, ACTIVEPOINAMES <string|nil>)|return= nil|returnDesc= Returns nothing after attempting to delete the specified persistence files, or issuing a warning if default paths are used.|example= CMM.ClearPOIState("CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOI.json", "CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOINAMES.json")|exampleDesc= Deletes custom persistent POI and POI names files, removes stored data, and logs removal actions while avoiding deletion of default files.|related= |note= |envType= CMM}}

LoadPOIState

2026-06-24T12:27:01Z

Ozdeadmeat: LoadPOIState – created via PowerShell script (2026-06-24T22:27:03Z)

{{Template:FunctionInfo|fName= LoadPOIState|fDescription= Loads persistent POI and POI names data from specified JSON files, initializing markers and setting their coalition colors. If default paths are detected, a warning is issued and no data is loaded.|parentFile= cmm.persistence.lua|syntax= CMM.LoadPOIState(ACTIVEPOI <string|nil>, ACTIVEPOINAMES <string|nil>)|return= nil|returnDesc= Returns nothing after loading and initializing POI markers and their coalition colors, or issuing a warning if default paths are used.|example= CMM.LoadPOIState("CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOI.json", "CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOINAMES.json")|exampleDesc= Loads custom persistent POI and POI names data, creates markers with correct coalition colors, and logs success messages while skipping default path loading.|related= |note= |envType= CMM}}

SavePOIState

2026-06-24T12:27:01Z

Ozdeadmeat: SavePOIState – created via PowerShell script (2026-06-24T22:27:03Z)

{{Template:FunctionInfo|fName= SavePOIState|fDescription= Saves the current state of CMM.ACTIVEPOI and CMM.ACTIVEPOINAMES to persistent JSON files, using provided file paths or default locations. If default paths are detected, a warning is issued and no saving occurs.|parentFile= cmm.persistence.lua|syntax= CMM.SavePOIState(ACTIVEPOI <string|nil>, ACTIVEPOINAMES <string|nil>)|return= nil|returnDesc= Returns nothing after saving both persistence files or issuing a warning if default paths are used.|example= CMM.SavePOIState("CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOI.json", "CMM.TEMP\PERSISTENCE\CUSTOM.ACTIVEPOINAMES.json")|exampleDesc= Saves CMM.ACTIVEPOI and CMM.ACTIVEPOINAMES to custom persistence files, logging success messages and avoiding default path warnings.|related= |note= |envType= CMM}}

FindPlayerUnitID

2026-06-24T12:27:00Z

Ozdeadmeat: FindPlayerUnitID – created via PowerShell script (2026-06-24T22:27:02Z)

{{Template:FunctionInfo|fName= FindPlayerUnitID|fDescription= Retrieves the unitID (or slotID) of a player by their name from the mission player list, returning the unitID if found or -1 if not present.|parentFile= cmm.netFunctions.lua|syntax= CMM.FindPlayerUnitID(PlayerName <string>)|return= number or string|returnDesc= Returns the unitID or slotID of the player if found, otherwise returns -1.|example= CMM.FindPlayerUnitID("OzDeaDMeaT")|exampleDesc= Looks up the unitID for the player named "OzDeaDMeaT" in the player list and returns it if found, otherwise returns -1.|related= |note= |envType= CMM|par1= string PlayerName|reqType1= string|reqName1= PlayerName|desc1= The name of the player as it appears in the mission editor or in-game.}}

FindPlayerNetID

2026-06-24T12:27:00Z

Ozdeadmeat: FindPlayerNetID – created via PowerShell script (2026-06-24T22:27:02Z)

{{Template:FunctionInfo|fName= FindPlayerNetID|fDescription= Retrieves the netID of a player by their name from the mission player list, returning the netID if found or -1 if not present.|parentFile= cmm.netFunctions.lua|syntax= CMM.FindPlayerNetID(PlayerName <string>)|return= number or string|returnDesc= Returns the netID of the player if found, otherwise returns -1.|example= CMM.FindPlayerNetID("OzDeaDMeaT")|exampleDesc= Looks up the netID for the player named "OzDeaDMeaT" in the player list and returns it if found, otherwise returns -1.|related= |note= |envType= CMM|par1= string PlayerName|reqType1= string|reqName1= PlayerName|desc1= The name of the player as it appears in the mission editor or in-game.}}

GetNewMarkerID

2026-06-24T12:26:58Z

Ozdeadmeat: GetNewMarkerID – created via PowerShell script (2026-06-24T22:27:00Z)

{{Template:FunctionInfo|fName= GetNewMarkerID|fDescription= Generates a new unused marker ID by checking against existing allocated IDs and returning the first available one, with a fallback to -1 if no ID can be found after extensive retries.|parentFile= cmm.markerFunctions.lua|syntax= CMM.GetNewMarkerID()|return= number|returnDesc= A new unused marker ID that has not been allocated in the MarkerPanels table, or -1 if no valid ID could be found.|example= CMM.GetNewMarkerID()|exampleDesc= Returns a unique marker ID such as 205, which has not been previously used in the mission, ensuring no conflicts with existing markers.|related= |note= |envType= CMM}}

MarkerDeployFatcow

2026-06-24T12:26:58Z

Ozdeadmeat: MarkerDeployFatcow – created via PowerShell script (2026-06-24T22:27:00Z)

{{Template:FunctionInfo|fName= MarkerDeployFatcow|fDescription= Finds nearest player, and deploys a coalition specific fatcow|parentFile= cmm.MapCommandFunctions.lua|syntax= CMM.MarkerDeployFatcow(EventData <TBL>)|return= nil|returnDesc= Returns Nothing|example= CMM.MarkerDeployFatcow()|exampleDesc= Deploys a Fatcow|related= |note= |envType= CMM}}

MarkerNotifyAll

2026-06-24T12:26:58Z

Ozdeadmeat: MarkerNotifyAll – created via PowerShell script (2026-06-24T22:27:00Z)

{{Template:FunctionInfo|fName= MarkerNotifyAll|fDescription= Sends a notification to all players with trigger.action.outText|parentFile= cmm.MapCommandFunctions.lua|syntax= CMM.MarkerNotifyAll(EventData <TBL>)|return= nil|returnDesc= Returns Nothing (sends a notification to all players with trigger.action.outText)|example= CMM.MarkerNotifyAll({initiator = "Player1", text = "Satellite sensors are now ready for use! :20"})|exampleDesc= Triggers the end of scan cooldown and notifies players that satellite sensors are now ready for use.|related= |note= |envType= CMM}}

MarkerRemoveGroup

2026-06-24T12:26:57Z

Ozdeadmeat: MarkerRemoveGroup – created via PowerShell script (2026-06-24T22:26:59Z)

{{Template:FunctionInfo|fName= MarkerRemoveGroup|fDescription= Removes a group nearest to the marker position of a given coaltion if provided|parentFile= cmm.MapCommandFunctions.lua|syntax= CMM.MarkerRemoveGroup(EventData <TBL>)|return= nil|returnDesc= Returns Nothing after processing the event and removing the group based on coalition and text.|example= CMM.MarkerRemoveGroup({pos = <vec3>, text = "Remove: blue")|exampleDesc= Processes a marker removal event a BLUE side group at positions, reports the name of the group removed to the executer of the command.|related= |note= |envType= CMM|par1= table EventData|reqType1= table|reqName1= EventData|desc1= S_EVENT_MARK_REMOVED Event Table containing position, text, and initiator data; used to determine coalition, side, and group name to remove.}}

DrawCity

2026-06-24T12:26:51Z

Ozdeadmeat: DrawCity – created via PowerShell script (2026-06-24T22:26:53Z)

{{Template:FunctionInfo|fName= DrawCity|fDescription= Draws a city on the map using a predefined set of points from CMM.CITY. It allows customization of coalition ownership and marker colors. Returns the marker ID of the created city marker.|parentFile= cmm.drawFunctions.lua|syntax= CMM.DrawCity(name <string>, coal <number>, colourfill <table>, colourline <table>)|return= number or nil|returnDesc= Returns the marker ID of the created city marker, or nil if the city name is invalid.|example= CMM.DrawCity("Krymsk", 2, {0,0,0.7,0.5}, {0,0,0,1})|exampleDesc= Draws a city marker for "Krymsk" with blue fill and black outline, owned by the blue coalition.|related= |note= |envType= CMM|par1= string name|reqType1= string|reqName1= name|desc1= Name of the city to draw. Must correspond to a key in the CMM.CITY table.|par2= number coal|reqType2= number|reqName2= coal|desc2= Coalition number for the marker (0 = neutral, 1 = red, 2 = blue). If invalid, defaults to -1 (all).|par3= table colourfill|reqType3= table|reqName3= colourfill|desc3= RGBA color table for the marker fill|par4= table colourline|reqType4= table|reqName4= colourline|desc4= RGBA color table for the marker outline}}

DrawRoad

2026-06-24T12:26:50Z

Ozdeadmeat: DrawRoad – created via PowerShell script (2026-06-24T22:26:52Z)

{{Template:FunctionInfo|fName= DrawRoad|fDescription= Draws a road marker between two world positions, consisting of a dashed line with an optional directional arrow.|parentFile= cmm.drawFunctions.lua|syntax= CMM.DrawRoad(vec3Start<vec3 table>, vec3End<vec3 table>, colour<table>, skipOffRoad<boolean>)|return= table|returnDesc= A table of MarkerID numbers|example= CMM.DrawRoad(vec3start, vec3start)|exampleDesc= Deletes the pin with circle mark ID 42 and its associated marker from the map and clears any pending scheduled removal task for it.|related= |note= |envType= CMM|par1= table vec3Start|reqType1= table|reqName1= vec3Start|desc1= Start location vec3 table|par2= table vec3End|reqType2= table|reqName2= vec3End|desc2= End location vec3 table|par3= number or nil coal|optType3= number or nil|optName3= coal|desc3= Coalition number for the marker (-1 for all, 1 for Redfor, 2 for Bluefor, 3 for Neutral), default -1 (all).|par4= number or nil lineType|optType4= number or nil|optName4= lineType|desc4= LineType Number (default 3) 0 No Line , 1 Solid , 2 Dashed , 3 Dotted , 4 Dot Dash , 5 Long Dash , 6 Two Dash|par5= table or nil colour|optType5= table or nil|optName5= colour|desc5= Marker Colour Table {r,g,b,a}, default {1,1,1,0.85} (white).|par6= string or nil routeName|optType6= string or nil|optName6= routeName|desc6= Marker Colour Table {r,g,b,a}, default {1,1,1,0.85} (white).}}

DrawHomePlate

2026-06-24T12:26:48Z

Ozdeadmeat: DrawHomePlate – created via PowerShell script (2026-06-24T22:26:50Z)

{{Template:FunctionInfo|fName= DrawHomePlate|fDescription= Draws a circular home‑plate marker at the supplied world position.|parentFile= cmm.drawFunctions.lua|syntax= CMM.DrawHomePlate(<argTbl table>)|return= table or nil|returnDesc= Returns a one‑element table containing the created Marker ID.|example= CMM.DrawHomePlate{vec={x=0,y=0,z=0}, size=300}|exampleDesc= Draws a 300 m radius home plate centered at the origin and returns its Marker ID.|related= |note= |envType= CMM|par1= table argTbl|reqType1= table|reqName1= argTbl|desc1= Marker Argument Table (vec – required; optional size, fillColour, lineColour, lineType, coalition).}}

DrawZone

2026-06-24T12:26:47Z

Ozdeadmeat: DrawZone – created via PowerShell script (2026-06-24T22:26:49Z)

{{Template:FunctionInfo|fName= DrawZone|fDescription= Creates a zone marker on the map using the parameters supplied in *argTbl*.|parentFile= cmm.drawFunctions.lua|syntax= CMM.DrawZone(<argTbl table>)|return= table or nil|returnDesc= Table of Marker ID's created for the zone.|example= CMM.DrawZone{zoneName="Alpha", fillColour={r=1,g=0,b=0,a=0.3}, lineType=2}|exampleDesc= Draws a red‑filled zone named “Alpha” with a dashed outline and returns the IDs of the created markers.|related= |note= |envType= CMM|par1= table argTbl|reqType1= table|reqName1= argTbl|desc1= Table items are at the start of the function. Required field: zoneName. Optional fields: fillColour, lineColour, labelColour, useZoneColour, lineType, labelSize, coalition, and label.}}