Updated README

Updated manual and README for version 0.3.250914
2026-09-03 09:20:57 +00:00 · 2025-09-14 15:39:25 +02:00 · 2025-09-14 15:39:03 +02:00 · 2025-09-14 15:36:07 +02:00 · 2025-09-14 15:28:32 +02:00 · 2025-09-14 14:55:32 +02:00
71 changed files with 1647 additions and 705 deletions
@@ -1,3 +1,4 @@
 _[Dd]ebug[Oo]utput/
 [Ii]nclude/[Ss]cript.lua
 *.miz
+*.pdf
@@ -1,5 +1,9 @@
 {
  "files.exclude": { "*.miz": true },
  "Lua.workspace.library": ["Libraries/dcs-world-api.lua"],
-  "Lua.diagnostics.disable": ["deprecated"]
+  "Lua.diagnostics.disable": ["deprecated"],
+  "markdown-pdf.convertOnSave": true,
+  "markdown-pdf.convertOnSaveExclude": ["README.md"],
+  "markdown-pdf.headerTemplate": "<span class='title' style='display: none;'></span>",
+  "markdown-pdf.styles": ["docs/style.css"]
 }
@@ -11,15 +11,8 @@
 if not net then net = {} end

 net.allow_unsafe_api = {  -- this defines the secure zones where net.dostring_in() can be called from
-  "userhooks",
-  "scripting",
-  "gui",
 }

 net.allow_dostring_in = { -- and this defines the zones that should be addressed from net.dostring_in()
-  "mission",
-  "scripting",
-  "gui",
-  "export",
-  "config",
+  "mission"
 }
@@ -0,0 +1,6 @@
+-- TODO
+
+-- [DCSEx.enums.unitFamily.GROUND_APC] = { "CHAP_FV107" },
+
+
+-- CHAP_IRISTSLM_CP, CHAP_IRISTSLM_LN, CHAP_IRISTSLM_STR
@@ -24,14 +24,14 @@ do
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_LONG] = { "*SA-2", "*SA-10" },
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_LONG] = { "*SA-10" },
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_MEDIUM] = { "*SA-3", "*SA-6", "*SA-11" },
-        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_SHORT] = { "2S6 Tunguska", "Osa 9A33 ln", "Tor 9A331" },
+        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_SHORT] = { "2S6 Tunguska", "Osa 9A33 ln", "Tor 9A331", "CHAP_PantsirS1", "CHAP_TorM2" },
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_SHORT_IR] = { "Strela-1 9P31", "Strela-10M3" },

-        [DCSEx.enums.unitFamily.GROUND_APC] = { "BMD-1", "BMP-1", "BMP-2", "BMP-3", "Boman", "BRDM-2", "BTR_D", "BTR-80", "BTR-82A", "Grad_FDDM", "MTLB" },
-        [DCSEx.enums.unitFamily.GROUND_ARTILLERY] = { "Grad-URAL", "SAU 2-C9", "SAU Akatsia", "SAU Gvozdika", "SAU Msta", "Smerch", "SpGH_Dana", "Uragan_BM-27" },
+        [DCSEx.enums.unitFamily.GROUND_APC] = { "BMD-1", "BMP-1", "BMP-2", "BMP-3", "Boman", "BRDM-2", "BTR_D", "BTR-80", "BTR-82A", "Grad_FDDM", "MTLB", "CHAP_BMPT" },
+        [DCSEx.enums.unitFamily.GROUND_ARTILLERY] = { "Grad-URAL", "SAU 2-C9", "SAU Akatsia", "SAU Gvozdika", "SAU Msta", "Smerch", "SpGH_Dana", "Uragan_BM-27", "CHAP_TOS1A" },
        [DCSEx.enums.unitFamily.GROUND_INFANTRY] = { "Infantry AK", "Infantry AK ver2", "Infantry AK ver3", "Paratrooper AKS-74", "Paratrooper RPG-16", "Soldier AK" },
        [DCSEx.enums.unitFamily.GROUND_MBT] = { "T-55", "T-72B", "T-80UD", "T-90" },
-        [DCSEx.enums.unitFamily.GROUND_SS_MISSILE] = { "Scud_B" },
+        [DCSEx.enums.unitFamily.GROUND_SS_MISSILE] = { "Scud_B", "CHAP_9K720_HE" },
        [DCSEx.enums.unitFamily.GROUND_UNARMED] = { "Ural-375", "Ural-4320 APA-5D", "Ural-4320T" },

        [DCSEx.enums.unitFamily.HELICOPTER_ATTACK] = { "Ka-50", "Mi-24V", "Mi-28N" },
@@ -52,7 +52,7 @@ do
        [DCSEx.enums.unitFamily.SHIP_CRUISER] = { "MOSCOW", "PIOTR" },
        [DCSEx.enums.unitFamily.SHIP_FRIGATE] = { "NEUSTRASH", "REZKY" },
        [DCSEx.enums.unitFamily.SHIP_LIGHT] = { "speedboat" },
-        [DCSEx.enums.unitFamily.SHIP_MISSILE_BOAT] = { "ALBATROS", "BDK-775", "MOLNIYA" },
+        [DCSEx.enums.unitFamily.SHIP_MISSILE_BOAT] = { "ALBATROS", "BDK-775", "MOLNIYA", "CHAP_Project22160_TorM2KM" },
        [DCSEx.enums.unitFamily.SHIP_SUBMARINE] = { "IMPROVED_KILO", "KILO", "SOM" },

        -- [DCSEx.enums.unitFamily.STATIC_STRUCTURE] = { "af_hq", ".Command Center", "Building01_PBR", "Building02_PBR", "Building03_PBR", "Building04_PBR", "Building05_PBR", "Bunker", "Chemical tank A", "Comms tower M", "FARP Fuel Depot", "outpost", "Sandbox", "Workshop A" },
@@ -21,12 +21,12 @@ do
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_SHORT] = { "rapier_fsa", "Roland ADS" },
        [DCSEx.enums.unitFamily.AIRDEFENSE_SAM_SHORT_IR] = { "M6 Linebacker", "M48 Chaparral", "M1097 Avenger" },

-        [DCSEx.enums.unitFamily.GROUND_APC] = { "AAV7", "Cobra", "LAV-25", "M-2 Bradley", "M-113", "M1045 HMMWV TOW", "M1126 Stryker ICV", "M1128 Stryker MGS", "Marder", "MCV-80", "MLRS FDDM", "TPZ" },
-        [DCSEx.enums.unitFamily.GROUND_ARTILLERY] = { "M-109", "MLRS" },
+        [DCSEx.enums.unitFamily.GROUND_APC] = { "AAV7", "Cobra", "LAV-25", "M-2 Bradley", "M-113", "M1045 HMMWV TOW", "M1126 Stryker ICV", "M1128 Stryker MGS", "Marder", "MCV-80", "MLRS FDDM", "TPZ", "CHAP_M1130", "CHAP_MATV" },
+        [DCSEx.enums.unitFamily.GROUND_ARTILLERY] = { "M-109", "MLRS", "CHAP_M142_ATACMS_M48", "CHAP_M142_GMLRS_M31" },
        [DCSEx.enums.unitFamily.GROUND_INFANTRY] = { "Soldier M4 GRG", "Soldier M4", "Soldier M249", "Soldier RPG" },
        [DCSEx.enums.unitFamily.GROUND_MBT] = { "Challenger2", "Leclerc", "Leopard-2", "Leopard1A3", "M-1 Abrams", "Merkava_Mk4" },
        [DCSEx.enums.unitFamily.GROUND_SS_MISSILE] = { "Scud_B" },
-        [DCSEx.enums.unitFamily.GROUND_UNARMED] = { "Land_Rover_101_FC", "Land_Rover_109_S3", "M 818" },
+        [DCSEx.enums.unitFamily.GROUND_UNARMED] = { "Land_Rover_101_FC", "Land_Rover_109_S3", "M 818", "CHAP_M1083" },

        [DCSEx.enums.unitFamily.HELICOPTER_ATTACK] = { "AH-1W", "AH-64D", "OH-58D", "SA342L", "SA342M", "SA342Minigun", "SA342Mistral" },
        [DCSEx.enums.unitFamily.HELICOPTER_TRANSPORT] = { "CH-47D", "CH-53E", "SH-60B", "UH-60A" },
@@ -1,6 +1,9 @@
@echo off
 cls

+WHERE php >nul 2>nul
+IF %ERRORLEVEL% NEQ 0 goto ERROR-NO-PHP
+
@REM -------------------------------------------
@REM CREATE SCENARIOS
@REM -------------------------------------------
@@ -9,18 +12,17 @@ echo THE ULTIMATE MISSION BUILDER SCRIPT:
 echo - Build [P]ersianGulf debug theater only (default)
 echo - Build all [D]ebug theaters
 echo - Build all [R]elease theaters
+echo - [C]ancel
 echo.
 set /p buildConfig=Your choice:
 echo.

-IF "%buildConfig%" == "d" goto BUILD-DEBUG-ALL
-IF "%buildConfig%" == "D" goto BUILD-DEBUG-ALL
 IF "%buildConfig%" == "p" goto BUILD-DEBUG-PERSIAN
 IF "%buildConfig%" == "P" goto BUILD-DEBUG-PERSIAN
+IF "%buildConfig%" == "d" goto BUILD-DEBUG-ALL
+IF "%buildConfig%" == "D" goto BUILD-DEBUG-ALL
 IF "%buildConfig%" == "r" goto BUILD-RELEASE
 IF "%buildConfig%" == "R" goto BUILD-RELEASE
-IF "%buildConfig%" == "s" goto START-DEBUG
-IF "%buildConfig%" == "S" goto START-DEBUG
 goto CANCEL-END

 :BUILD-DEBUG-ALL
@@ -38,10 +40,16 @@ if exist *.miz del *.miz
 c:\php\php Make.php release
 goto COPY-TO-DCS

-:COPY-TO-DCS
+:BUILD-MANUAL
+WHERE pandoc >nul 2>nul
+IF %ERRORLEVEL% NEQ 0 goto ERROR-NO-PANDOC
+pandoc README.md -o README.pdf
+goto END
+
@REM -------------------------------------------
@REM COPY OUTPUT MIZ FILES TO DCS'S MISSIONS DIRECTORY
@REM -------------------------------------------
+:COPY-TO-DCS
 if not exist "%userprofile%\Saved Games\DCS\Missions\" goto END
 if not exist *.miz goto END
 echo Copying output MIZ files to %userprofile%\Saved Games\DCS\Missions...
@@ -54,5 +62,10 @@ echo.
 echo Build cancelled.
 goto END

+:ERROR-NO-PHP
+echo.
+echo CRITICAL ERROR: PHP not found. Please install PHP and add it to the PATH.
+goto END
+
 :END
 echo.
@@ -95,7 +95,7 @@ mission =
 		},
 	},
 	["pictureFileNameN"] = {},
-	["descriptionNeutralsTask"] = "DictKey_descriptionNeutralsTask_4",
+	["descriptionNeutralsTask"] = "",
 	["pictureFileNameServer"] = {},
 	["weather"] =
 	{
@@ -86,7 +86,7 @@
 										["alt"] = 13,
 										["alt_type"] = "BARO",
 										["livery_id"] = "default",
-										["skill"] = "Player",
+										["skill"] = "Client",
 										["speed"] = 138.88888888889,
 										["AddPropAircraft"] = 
 										{
@@ -65,7 +65,7 @@
 										["alt"] = 22,
 										["alt_type"] = "BARO",
 										["livery_id"] = "default",
-										["skill"] = "Player",
+										["skill"] = "Client",
 										["speed"] = 138.88888888889,
 										["type"] = "Su-25T",
 										["unitId"] = 1,
@@ -1,21 +1,17 @@
 # The Universal Mission for DCS World

-**Current version: open beta 0.2.250729** (see the "version history" section at the end of this file for a list of the latest changes)
+**Current version: open beta 0.3.250914** (see the "version history" section at the end of this file for a list of the latest changes)

 **This is a BETA version, there may be bugs and there WILL be unbalanced stuff.**

-The Universal Mission for DCS World is an attempt to create a fully dynamic single-player/PvE mission giving access to the whole content of DCS World in a structure similar to the one found in old "simulators", like the early Microprose games (think F-117 or the Strike Eagle serie).
-These game had both fun and clear objectives, endless replayability and a career system that made sure that something was at stake: crash and die, and you'll lose all these hard-earned medals.
-
-As the original creator of [Briefing Room](https://github.com/DCS-BR-Tools/briefing-room-for-dcs) (now maintained by the talented John Harvey), I've always wanted to create an easy-to-use, enticing and fun mission generator for DCS, capable of creating CPU-light missions without requiring an external program.
-I think with The Universal Mission is, finally, the proper way to approach this problem. The current version is still an early beta but most core features are already working. I hope you'll like it.
+The Universal Mission for DCS World is a fully dynamic single-player/PvE mission giving access to the whole content of DCS World.

 ### Features

 - Can generate any kind of mission: ground attack, interception, strike, airbase attack, CAS, CAP, and more
 - Completely dynamic, no two missions are ever the same
 - Entirely self-contained inside a .miz file, no need for any external program
- More than 300 voiced radio messages for immersive and realistic coms
+- More than 325 voiced radio messages for immersive and realistic coms
 - Supports both single-player and small-scale PvE on closed servers
 - Persistent single player career mode, with awards and promotions. Dying won't reset your progress, but you have to come back to base alive for your kills and completed objectives to be saved to your profile, so watch out for SAMs on your way home
 - All new AI wingman system, smarter and more immersive than DCS's original wingmen
@@ -26,21 +22,22 @@ I think with The Universal Mission is, finally, the proper way to approach this
 [![Screen shot of the target zone system](./docs/target-zones-tn.jpg)](./docs/target-zones.jpg)
 [![Screen shot of the career mode's medal case display](./docs/career-mode-tn.jpg)](./docs/career-mode.jpg)

-### Limitations of current beta version
+#### Limitations of current beta version

 **Please read the "planned development" section below for more information.**

 - The current version supports only modern (post-Cold War) units and Caucasus, Kola, Marianas, Persian Gulf and Syria theaters
-  - Germany support will come soon, others will follow later
 - Not all mission types are supported yet
 - Career progress may be lost because of future updates, don't get too attached to it

-### Known bugs
+<h4>Known bugs in latest release</h4>

- AWACS datalink info is now displayed on SA pages
+- AWACS datalink info not displayed properly on SA pages

 ## How to use/play The Universal Mission?

+**Please refer to the [User's manual](https://github.com/akaAgar/the-universal-mission-for-dcs-world/blob/main/The%20Universal%20Mission%20-%20User's%20Manual.md) for additional information.**
+
 ### First setup

 - Download the latest release from this GitHub page.
@@ -67,102 +64,31 @@ Please refer to the "Advanced stuff you may want to try" section to learn all th
 - When you're ready, pick the "Begin mission" option, wait a few seconds (precaching all the game assets can take some time, especially if you have a slow CPU), you're ready to go!
 - Use the F10 mission and check the F10 map for additional information about the mission (see "Using the mission menu" below). Don't forget to come back to base alive, all awarded XP and completed objectives will only be saved to your pilot profile once you've landed

-### Using the mission menu
-
-Most features of The Universal Mission require the use of the "F10. Other" menu. To access it, press the "Communication menu" key (check the key bindings), navigate to the root menu by pressing F11 ("Previous menu") if need, then press "F10" to access the "Other" menu.
-The exact content of the menu will depend on the current phase of the mission.
-
-#### On startup/when no mission is active
-
- **Display mission settings**: Displays the current mission settings, that will be applied if you choose to start the mission now.
- **Change mission settings**: Allows you to change the mission settings to your taste.
-  - **Blue coalition**: Who is the blue coalition? Determines the type of units that will be spawned. Available factions (e.g. NATO) depend on the missions's time period and theater.
-  - **Red coalition**: Who is the red coalition? Determines the type of units that will be spawned. Available factions (e.g. USSR) depend on the missions's time period and theater.
-  - **Mission type**: What will your mission be?
-    - **Antiship strike**: Sink enemy warships and cargo ships.
-    - **Ground attack**: Interdiction missions against armor, artillery and convoys.
-    - **Interception**: Shoot down strategic airplanes (bombers, transports...) and enemy attack planes on interdiction missions.
-    - **SEAD**: Destroy enemy SAM sites.
-    - **Strike**: Destroy enemy structures and civilian buildings occupied by enemy forces.
-  - **Target location**: Where on the map will the targets be spawned? Approximate distance to possible regions is displayed in the menu.
-    - Missions taking place in enemy territory award 30% more XP to account for increased SAM threat and proximity of enemy airbases.
-    - Make sure to pick a region not too far away from your starting location if you don't like long ingresses.
-    - Picking a region very close to your starting location (for instance, the one where your airbase is located in) can also be a bad idea, as you might takeoff in range of an enemy SAM.
-    - Be aware that targets of antiship strikes will always be spawned in open seas, which can be quite far if you picked a landlocked target zone.
-  - **Target count**: How many objectives will be spawned. More objectives means potentially more xp in a single sortie, so better medals, but also more work and more risk. Be aware that you can RTB to rearm/refuel at any time between objectives, but you won't accumulate as many single-sortie XP as if you complete objectives without going back to base, because XP is awarded to your profile and reset each time you land.
-  - **Enemy air defense**: Amount, quality and skill of enemy surface-to-air units (AAA, MANPADS and SAM). A higher setting awards more XP.
-  - **Enemy air force**: Amount, quality and skill of enemy combat air patrols. A higher setting awards more XP.
-  - **Wingmen count**: How many wingmen will fly by your side (from zero to three). A small XP penalty is added for each additional wingman. Wingman won't get replaced if they get shot during a mission, but they will (with full payload) each time you land and takeoff again. Only shown in single-player missions.
-  - **Friendly AI CAP**: Should AI fighter aicraft be spawned regularly to patrol the AO and shoot down potential threats? Disabling this option will award you more XP (only if "Enemy air force" is not set to "None") but also means you and your wingmen will be alone against the whole enemy air force.
- **View pilot career stats**: Displays a list of your achievements, as well as your medal case. Only available when playing single-player missions and if the Lua IO module has been unsanitized (see "First setup" above)
- **Begin mission**: Starts a mission with the current settings.
-
-#### During the mission
-
- **Mission status**: Displays a summary of the mission's status (list of objectives and progress on each objective).
- **Objectives**: Displays a list of special commands related to each of the mission's objectives. Be aware that some objectives may have no special commands associated with them.
-  - **Smoke marker on target**: Asks for a friendly JTAC to pop a smoke marker on the target. Makes finding the target easier, but will cost you a small XP penalty. Only available for missions where a JTAC is available (it's pretty hard to throw a smoke grenade at an airplane or a ship in the middle of the sea).
- **Navigation**: Displays a list of commands related to navigational assistance.
-  - **Navigation to objective [OBJECTIVE NAME]**: Displays the coordinates of the objective, its BRA ("fly X for Y") relative to the player's position and an estimated flight time and ETA. Some objectives types (e.g. strike missions) are provided with exact coordinates, but most will only have approximate coordiantes, so you'll have to search for targets yourself once in the objective area.
- **Flight**: Displays a list of commands for your wingmen. Only shown in single-player missions and if wingmen are available for this mission.
-  - **Cover me!**: Tasks your wingmen to immediately engage any nearby air threats.
-  - **Engage**: Tasks your wingmen to engage a certain type of targets. Targets must be detected by your wingmen (see "Report contacts" below), or they won't be able to engage them.
-  - **Report contacts**: Asks your wingmen for a list of all detected contacts. According to range and sensors capabilities, their reports can go from perfect ID (e.g. "Su-27") to very generic descriptions (e.g. "fighter" or even "aircraft")
-  - **Hold position**: Tasks your wingmen to orbit at their current position. All other tasking will be aborted.
-  - **Change altitude**: Asks your wingmen to change their altitude. This altitude will be employed when attacking on orbiting but not when rejoining/forming up with you (in that case, they'll match your altitude).
-  - **Status report**: Asks your wingmen for a complete report (damage sustained, fuel status, available payload).
-  - **Rejoin**: Asks your wingmen to rejoin and follow you. All other tasking will be aborted. This is the default tasking when wingmen take off and when they complete another task.
- **AWACS**: Displays a list of commands for the AWACS. Only shown if an AWACS aircraft is available for this mission.
-  - **Bogey dope**: Asks for the nearest enemy air threat
-  - **Picture**: Asks for a summary of all detected enemy aircraft
- **Display mission score**: Displays the number of XP gained and objectives completed since your last takeoff. They will be added to your flight log (and any promotions/medals be awarded) the next time you land. If you crash, eject or abort the mission, all currently "stowed" XP and objectives will be lost. Only available when playing single-player missions and if the Lua IO module has been unsanitized (see "First setup" above)
- **Abort mission**: Aborts the current mission and forfeit all XP/objectives gained since last landing. The game will ask for confirmation so you don't select this option by mistake.
-
-### Advanced stuff you may want to try
-
-The Universal Mission is designed to be easily editable to suit your preferences. Here are a few things you could do after opening the .miz file in DCS World's mission editor.
-
-#### Player aircraft
-
- Change the player aircraft starting condition (runway, parking or parking hot). Air starts are not recommended as all players must be on the ground to begin a new mission
- Move it to another airbase, change its coalition (make sure blue players are spawned on an airbase located in a BLUFOR zone are red players are spawned on an airbase located in a REDFOR zone)
-  - You may also add an aircraft carrier or a FARP for the player to take off from
- Change its default loadout if you plan to play a specific kind of mission and don't want to lose time asking the ground crew to rearm your aircraft (e.g. if you know you want to play SEAD missions, you may as well stock up on AGM-88s)
- Change the skill level from "Player" to "Client" and add other aircraft to create a multiplayer mission to play with your friends. Keep in mind that the persistent career/player stats system will be disabled in multiplayer missions and that all player aircraft must belong to the same coalition (TUM does not support PvP)
-
-#### Zones
-
- All zones whose names starts with BLUFOR or REDFOR decide the territory (and airbases) controlled by the blue and red coalitions
-  - Be aware that any change to the airbases coalitions will be superseded by the BLUFOR and REFOR zones
- All zones whose names starts with WATER are seas, used to spawn ships
- Zones with a name not starting with BLUFOR, REDFOR or WATER are target zones. These are zones where objectives can be spawned, who can be selected in the "objective location" setting of the intermission F10 menu
-  - Change, add or remove zones to create new possible target areas. A maximum of 10 target areas can be created, so they fit the F10 menu
-
-#### A few notes regarding multiplayer
+### A few notes regarding multiplayer

 While The Universal Mission supports multiplayer and is perfectely suitable (and fun!) for playing with friends on a private server, it is **absolutely not suited for public servers** as missions settings can be edited by anyone at any time Using the mission menu.
 Please also note that PvP is not supported at the moment and that the mission will not launch if both coalitions have player slots.

-#### Other parameters
-
- _(Not yet implemented in this version)_ By changing the year in mission time parameters, the time period will be changed accordingly and the proper factions and AI units will be spawned during the mission. Time periods are:
-  - 1945 and before: World War 2
-  - 1946-1959: Korea War
-  - 1960-1974: Vietnam War
-  - 1975-1989: Late Cold War
-  - 1990-now: Modern
- _(Not yet implemented in this version)_ Changing the weather to make it more cloudy or windy, or setting the mission to nighttime, will make the mission more difficult but also award more points.
-
 ## Planned development

-### VERY high priority
+<h3>Planned for next version (can be subject to change)</h3>

- Additional "navigation" commands (vector to nearest airfield, complete weather report...)
- Bugfix: AWACS datalink info not showing on SA pages
- Improved score multiplier taking into account various aspects of mission difficulty (weather, nighttime ops...)
- New objectives: helicopter (drop/pickup units...), CAP, CAS, OCA (airbase attack)
- Support for the Germany and South America theaters
- Support for more factions and five different time periods (World War 2, Korea war, Vietnam war, late Cold war, Modern)
+- Additional content
+  - [ ] More objectives types
+- Balance improvements
+  - [ ] Tweaked XP requirements for medals/promotions
+- Bug fixes
+  - [ ] AWACS datalinked contacts not showing on SA pages
+- Extras
+  - [ ] GitHub page
+- Improvements
+  - [ ] Better weather reports (cloud cover, rain, etc)
+- New features
+  - [ ] Administrative settings menu
+  - [ ] Friendly air defenses
+- Quality of life/minor tweaks
+  - [ ] AI wingmen "Two was shot down!" call when witnessing another wingman killed
+  - [ ] AI wingmen "Winchester!" call when out of ammo

 ### High priority

@@ -170,11 +96,11 @@ Please also note that PvP is not supported at the moment and that the mission wi
  - More "flavor" radio messages ("fence in" when player approaches the AO, etc) so the world will feel more alive
 - Better balancing of the player career awards and promotions
 - Better use of context for "ambient" radio messages (should only warn of a SAM launch if an AI pilot is there to witness it, etc)
- Friendly air defenses
- GitHub page
+- Improved score multiplier taking into account various aspects of mission difficulty (weather, nighttime ops...)
 - Laser designation of targets by JTAC
- PDF manual
+- New objectives: helicopter (drop/pickup units...), CAP, CAS, OCA (airbase attack)
 - Support for all missing DCS World theaters
+- Support for more factions and five different time periods (World War 2, Korea war, Vietnam war, late Cold war, Modern)

 ### Medium priority

@@ -194,6 +120,7 @@ Please also note that PvP is not supported at the moment and that the mission wi
 ## Misc

 - **Released under the GNU GPL 3.0 licence**
+- Uses YoloWingPixie's [DCS World Schema API](https://github.com/YoloWingPixie/dcs-world-schema)
 - AI use/disclosure
  - [ChatGPT](https://chatgpt.com/): used to generate first draft of radio messages
  - [ElevenLabs](https://elevenlabs.io/fr): used to generate radio messages voiceover
@@ -227,9 +154,32 @@ The core script is quite simple and small, I probably won't need too much help w

 ## Version history

+- **0.3.250914** (09/14/2025)
+  - **MAJOR CHANGE:**
+    - Use of "Client" slot instead of "Player" slot even in single-player missions, allowing the player to respawn on death/ejection instead of having to start the whole mission again
+    - "Player" should not be used anymore. Single-player missions must use a single "Client" slot instead
+  - Additional content
+    - Added new units (Currenthill unit pack) from DCS 2.9.19.13478
+    - Support for "Cold War Germany" theater
+  - Balance improvements
+    - Enemy CAP respawn rate now decreases the more enemy planes are shot
+  - Bug fixes
+    - Some player callsigns were causing a script error at startup
+    - Fixed wrong filename in "enemy infantry killed" messages
+    - Removed unused zones from the "autoexec.cfg" file
+  - Extras
+    - First draft of the PDF manual
+  - New features
+    - Additional commands in the "navigation" menu
+      - Vector to nearest airfield
+      - Weather report
+    - Mission now autostarts (if it wasn't started yet) when all players have taken off
+  - Quality of life/minor tweaks
+    - Increased AWACS aircraft spawn altitude
+    - Target coordinates radio message displayed for a longer time so players have the time to write them down or enter them in their flight computer
 - **0.2.250729** (07/29/2025)
  - **MAJOR CHANGE:** Added all new wingman system
-    - Far for perfect but a lot better than AI's default wingmen
+    - Far for perfect but a lot better than DCS's default wingmen
    - Many more engage/orbit/go to commands (see "Using the mission menu" above)
    - All new contacts report system: more realistic (see "AI units reports" changes below in this changelog) and does not spam the player with "new contact" messages
    - AI wingmen added using mission editor are now despawned on mission start to avoid conflict with TUM's own wingman system
@@ -257,7 +207,7 @@ The core script is quite simple and small, I probably won't need too much help w
  - Moved "Request objective coordinates" radio commands to new "Navigation" submenu, which will include additional navigational assist in future versions
  - Lowered MANPADS count and skill (MANPADS are overpowered in DCS, especially SA-18)
  - "New friendly/enemy aircraft taking off" radio messages now mention their BRAA relative to the player, number of bandits taking off now displayed as a word instead of digits
-  - "Rifle!" and "Missile away!" radio calls now both used for any kind of A/G missiles
+  - "Rifle!" and "Missile away!" radio calls now both used for any kind of A/G missiles (except antiship and antiradiation missiles, who
  - Tons of internal logic bugfixes and tweaks
  - Tweaked XP bonus/penalty for various mission settings
  - Vastly improved the way AI units reports on contact tracks. According to range and sensors capabilities, can go from perfect ID (e.g. "Su-27") to very generic descriptions (e.g. "fighter" or even "aircraft")
@@ -1,6 +1,6 @@
 -- ====================================================================================
-- (DCS LUA ADD-ON) CONVERTER - UNITS CONVERSION FUNCTIONS
--
+-- DCSEX.CONVERTER - UNITS CONVERSION FUNCTIONS
+-- ====================================================================================
 -- DCSEx.converter.celsiusToFahrenheit(t)
 -- DCSEx.converter.degreesToRadians(degrees)
 -- DCSEx.converter.fahrenheitToCelsius(fahrenheit)
@@ -21,6 +21,7 @@ DCSEx.converter = {}

 -------------------------------------
 -- Converts Celsius degrees to Fahrenheit
+-------------------------------------
 -- @param t Temperature in Celsius degrees
 -- @return Temperature in Fahrenheit degrees
 -------------------------------------
@@ -30,6 +31,7 @@ end

 -------------------------------------
 -- Converts angle in degrees to radians.
+-------------------------------------
 -- @param degrees Angle in degrees
 -- @return Angle in radians
 -------------------------------------
@@ -39,6 +41,7 @@ end

 -------------------------------------
 -- Converts Fahrenheit degrees to Celsius
+-------------------------------------
 -- @param fahrenheit Temperature in Fahrenheit degrees
 -- @return Temperature in Celsius degrees
 -------------------------------------
@@ -48,6 +51,7 @@ end

 -------------------------------------
 -- Converts feet to meters.
+-------------------------------------
 -- @param feet Distance in feet
 -- @return Distance in meters
 -------------------------------------
@@ -57,6 +61,7 @@ end

 -------------------------------------
 -- Converts Kelvin degrees to Celsius
+-------------------------------------
 -- @param kelvin Temperature in Kelvin degrees
 -- @return Temperature in Celsius degrees
 -------------------------------------
@@ -66,6 +71,7 @@ end

 -------------------------------------
 -- Converts Kelvin degrees to Fahrenheit
+-------------------------------------
 -- @param kelvin Temperature in Kelvin degrees
 -- @return Temperature in Fahrenheit degrees
 -------------------------------------
@@ -75,6 +81,7 @@ end

 -------------------------------------
 -- Converts kilometers per hour to meters per second.
+-------------------------------------
 -- @param kmph speed in km/h
 -- @return speed in m/s
 -------------------------------------
@@ -84,6 +91,7 @@ end

 -------------------------------------
 -- Converts knots to meters per second.
+-------------------------------------
 -- @param knots speed in knots
 -- @return speed in m/s
 -------------------------------------
@@ -93,6 +101,7 @@ end

 -------------------------------------
 -- Converts meters to feet.
+-------------------------------------
 -- @param meters distance in meters
 -- @return distance in feet
 -------------------------------------
@@ -102,6 +111,7 @@ end

 -------------------------------------
 -- Converts meters to nautical miles.
+-------------------------------------
 -- @param meters distance in meters
 -- @return distance in nautical miles
 -------------------------------------
@@ -111,6 +121,7 @@ end

 -------------------------------------
 -- Converts meters per second to kilometers per hour.
+-------------------------------------
 -- @param mps speed in m/s
 -- @return speed in km/h
 -------------------------------------
@@ -120,6 +131,7 @@ end

 -------------------------------------
 -- Converts meters per second to knots.
+-------------------------------------
 -- @param mps speed in m/s
 -- @return speed in knots
 -------------------------------------
@@ -129,6 +141,7 @@ end

 -------------------------------------
 -- Converts nautical miles to meters.
+-------------------------------------
 -- @param nm distance in nautical miles
 -- @return distance in meters
 -------------------------------------
@@ -138,6 +151,7 @@ end

 -------------------------------------
 -- Converts angle in radians to degrees.
+-------------------------------------
 -- @param degrees Angle in radians
 -- @return Angle in degrees
 -------------------------------------
@@ -1,33 +1,39 @@
 -- ====================================================================================
-- DCSTOOLS - FUNCTIONS LINKED TO DCS WORLD RULES AND TABLES
+-- DCSEX.DCS - FUNCTIONS HANDLING DCS WORLD'S GAME RULES AND TABLES
 -- ====================================================================================
+-- DCSEx.dcs.doNothing()
 -- DCSEx.dcs.getBRAA(point, refPoint, showAltitude, metricSystem, casualFormat)
 -- DCSEx.dcs.getCJTFForCoalition(coalitionID)
 -- DCSEx.dcs.getCoalitionAsString(coalitionID)
 -- DCSEx.dcs.getCoalitionColor(coalitionID, alpha)
+-- DCSEx.dcs.getFirstUnitCallsign(group)
 -- DCSEx.dcs.getGroupCenterPoint(group)
 -- DCSEx.dcs.getGroupIDAsNumber(group)
 -- DCSEx.dcs.getNearestObject(refPoint, objectTable)
 -- DCSEx.dcs.getNearestObjects(refPoint, objectTable, maxCount)
 -- DCSEx.dcs.getNearestPoints(refPoint, pointsTable, maxCount)
+-- DCSEx.dcs.getObjectIDAsNumber(obj)
 -- DCSEx.dcs.getOppositeCoalition(coalitionID)
 -- DCSEx.dcs.getPlayerUnitsInGroup(group)
 -- DCSEx.dcs.getPlayerUnitsInGroupByID(groupID)
 -- DCSEx.dcs.getRadioModulationName(modulationID)
-- DCSEx.dcs.getObjectIDAsNumber(obj)
-- DCSEx.dcs.getUnitTypeFromFamily(unitFamily)
-- DCSEx.dcs.getUnitFamilyForDecade(unitFamily, decade) -- TODO: remove?
+-- DCSEx.dcs.getUnitCategoryFromFamily(unitFamily)
+-- DCSEx.dcs.loadMission(fileName)
+-- DCSEx.dcs.outPicture(fileName, durationSeconds, clearView, startDelay, horizontalAlign, verticalAlign, size, sizeUnits)
 -- ====================================================================================

 DCSEx.dcs = { }

-- TODO: add description and update file header
+-------------------------------------
+-- Does nothing. Used to create commands that do nothing in the F10 menu
+-------------------------------------
 function DCSEx.dcs.doNothing()
 end

 -------------------------------------
 -- Gets a BRAA (bearing, range, altitude, aspect) string about a point
 -- Format is "[bearing to unit] for [distance] at [altitude]"
+-------------------------------------
 -- @param unit A unit
 -- @param refPoint Reference point for the bearing and distance
 -- @param showAltitude Should altitude be displayed?
@@ -86,6 +92,7 @@ end

 -------------------------------------
 -- Returns the CJTF country for a given coalition
+-------------------------------------
 -- @param A coalition ID
 -- @return A country ID (country.id.CJTF_BLUE or country.id.CJTF_RED)
 -------------------------------------
@@ -97,6 +104,7 @@ end

 -------------------------------------
 -- Returns the name of a coalition, as a string ("blue", "red" or "neutral")
+-------------------------------------
 -- @param A coalition ID
 -- @return A string
 -------------------------------------
@@ -109,8 +117,9 @@ end

 -------------------------------------
 -- Returns the RGBA color table for the given coalition, accoding to NATO symbology colors
+-------------------------------------
 -- @param coalitionID A coalition side
-- @param alpha (optional) Alpha. Default is 1
+-- @param alpha (optional) Alpha. Default is 1.0
 -- @return A RGBA color table
 -------------------------------------
 function DCSEx.dcs.getCoalitionColor(coalitionID, alpha)
@@ -123,7 +132,12 @@ function DCSEx.dcs.getCoalitionColor(coalitionID, alpha)
    end
 end

-- TODO: description
+-------------------------------------
+-- Returns the callsign table for the first unit of the group
+-------------------------------------
+-- @param group A group
+-- @return A callsign table, or nil if no units or no group
+-------------------------------------
 function DCSEx.dcs.getFirstUnitCallsign(group)
    if not group then return nil end

@@ -137,6 +151,7 @@ end

 -------------------------------------
 -- Returns a vec3 point at the center of all units of a group
+-------------------------------------
 -- @param group A group object
 -- @return A vec3
 -------------------------------------
@@ -162,6 +177,7 @@ end

 -------------------------------------
 -- Returns the ID of a group as a number (here to fix a bug where sometimes ID is returned as a string)
+-------------------------------------
 -- @param group A group table
 -- @return An ID (as an number) or nil if group is nil or has no ID
 -------------------------------------
@@ -175,6 +191,7 @@ end

 -------------------------------------
 -- Returns the object nearest (in a 2D plane) from a given point
+-------------------------------------
 -- @param refPoint A reference point, as a vec2 or vec3
 -- @param objectTable A table of DCS objects
 -- @return The object nearest from the point, or nil if no object was found
@@ -187,6 +204,7 @@ end

 -------------------------------------
 -- Returns the nearest objects (in a 2D plane) from a given point
+-------------------------------------
 -- @param refPoint A reference point, as a vec2 or vec3
 -- @param objectTable A table of DCS objects
 -- @param maxCount (optional) Maximum number of objects to return
@@ -218,6 +236,7 @@ end

 -------------------------------------
 -- Returns the nearest points (in a 2D plane) from a given point
+-------------------------------------
 -- @param refPoint A reference point, as a vec2 or vec3
 -- @param objectTable A table of points (vec2 or vec3)
 -- @param maxCount (optional) Maximum number of points to return
@@ -249,6 +268,7 @@ end

 -------------------------------------
 -- Returns the coalition opposed to the provided coalition (coalition.side.NEUTRAL still returns NEUTRAL)
+-------------------------------------
 -- @param group A coalition
 -- @return Another coalition
 -------------------------------------
@@ -260,6 +280,7 @@ end

 -------------------------------------
 -- Returns all player-controlled units in a group
+-------------------------------------
 -- @param group A group object
 -- @return A table of unit objects
 -------------------------------------
@@ -280,6 +301,7 @@ end

 -------------------------------------
 -- Returns all player-controlled units in the group with the given ID
+-------------------------------------
 -- @param groupID A group ID
 -- @return A table of unit objects
 -------------------------------------
@@ -289,6 +311,7 @@ end

 -------------------------------------
 -- Returns a radio modulation type as a string
+-------------------------------------
 -- @param modulationID A modulation ID (from radio.modulation enum)
 -- @return A string
 -------------------------------------
@@ -297,66 +320,9 @@ function DCSEx.dcs.getRadioModulationName(modulationID)
    return "AM"
 end

-------------------------------------
-- Returns a remplacement unit family for given family if it's not available in this decade (e.g. SAMs in the 1940s). Else returns the original family.
-- @param unitFamily An unit family
-- @param decade (optional) A decade, or the current decade from env.mission.date.Year
-- @return An unit family
-------------------------------------
-function DCSEx.dcs.getUnitFamilyForDecade(unitFamily, decade)
-    -- TODO
-    -- decade = decade or envMission.getDecade()
-
-    -- if decade < 1990 then
-    --     if unitFamily == DCSEx.enums.unitFamily.UAVs then
-    --         unitFamily = DCSEx.enums.unitFamily.AttackHelicopters
-    --     end
-    -- end
-
-    -- if decade < 1970 then
-    --     if unitFamily == DCSEx.enums.unitFamily.AWACS then
-    --         unitFamily = DCSEx.enums.unitFamily.Transports
-    --     elseif unitFamily == DCSEx.enums.unitFamily.SAMShort then
-    --         unitFamily = DCSEx.enums.unitFamily.MobileAAA
-    --     elseif unitFamily == DCSEx.enums.unitFamily.SAMShortIR then
-    --         unitFamily = DCSEx.enums.unitFamily.MobileAAA
-    --     end
-    -- end
-
-    -- if decade < 1960 then
-    --     if unitFamily == DCSEx.enums.unitFamily.AttackHelicopters then
-    --         unitFamily = DCSEx.enums.unitFamily.Fighters
-    --     elseif unitFamily == DCSEx.enums.unitFamily.MANPADS then
-    --         unitFamily = DCSEx.enums.unitFamily.Infantry
-    --     elseif unitFamily == DCSEx.enums.unitFamily.SAMLong then
-    --         unitFamily = DCSEx.enums.unitFamily.StaticAAA
-    --     elseif unitFamily == DCSEx.enums.unitFamily.SAMMedium then
-    --         unitFamily = DCSEx.enums.unitFamily.StaticAAA
-    --     elseif unitFamily == DCSEx.enums.unitFamily.SSMissiles then
-    --         unitFamily = DCSEx.enums.unitFamily.Artillery
-    --     elseif unitFamily == DCSEx.enums.unitFamily.TransportHelicopters then
-    --         unitFamily = DCSEx.enums.unitFamily.Transports
-    --     end
-    -- end
-
-    -- if decade < 1950 then
-    --     if unitFamily == DCSEx.enums.unitFamily.MobileAAA then
-    --         unitFamily = DCSEx.enums.unitFamily.APC
-    --     elseif unitFamily == DCSEx.enums.unitFamily.Tankers then
-    --         unitFamily = DCSEx.enums.unitFamily.Transports
-    --     end
-    -- end
-
-    return unitFamily
-end
-
-- TODO: description
-function DCSEx.dcs.getUnitTypeFromFamily(unitFamily)
-    return math.floor(unitFamily / 100)
-end
-
 -------------------------------------
 -- Returns the ID of an object as a number (here to fix a bug where sometimes ID is returned as a string)
+-------------------------------------
 -- @param obj An object (unit, static object...)
 -- @return An ID (as an number) or nil if unit is nil or has no ID
 -------------------------------------
@@ -365,21 +331,36 @@ function DCSEx.dcs.getObjectIDAsNumber(obj)
    return tonumber(obj:getID())
 end

-- TODO: description & file header
+-------------------------------------
+-- Returns a the unit category (Unit.Category enum) an unit family (DCSEx.enums.unitFamily) belongs to
+-------------------------------------
+-- @param unitFamily A value from the Unit.Category enum
+-- @return A value from the DCSEx.enums.unitFamily enum
+-------------------------------------
+function DCSEx.dcs.getUnitCategoryFromFamily(unitFamily)
+    return math.floor(unitFamily / 100)
+end
+
+-------------------------------------
+-- Loads another DCS World mission
+-------------------------------------
+-- @param fileName Filename of the mission
+-------------------------------------
 function DCSEx.dcs.loadMission(fileName)
    net.dostring_in("mission", string.format("a_load_mission(\"%s\")", fileName))
 end

-- TODO: description & file header
-- function DCSEx.dcs.isMultiplayer()
--     if #net.get_player_list() > 0 then return true end
--     if dcs and dcs.isServer() == true then return true end
--     return false
-- end
-
-- TODO: a_end_mission
-
-- TODO: description & file header
+-------------------------------------
+-- Displays a picture on the screen of ALL players
+-------------------------------------
+-- @param fileName Filename/ResourceName of the image in the mission resources
+-- @param durationSeconds Duration (in seconds) during which the image should be displayed
+-- @param startDelay After how many seconds should the image be displayed? (default: 0)
+-- @param horizontalAlign Horizontal alignment of the image (0/1/2=left/center/right) (default: 1)
+-- @param verticalAlign Vertical alignment of the image (0/1/2=top/center/bottom) (default: 1)
+-- @param size Size of the image, in pixels or % of the screen (see sizeUnits) (default: 100)
+-- @param sizeUnits If 0, the size parameter is in pixels. If 1, it's in % of screen size (default: 0)
+-------------------------------------
 function DCSEx.dcs.outPicture(fileName, durationSeconds, clearView, startDelay, horizontalAlign, verticalAlign, size, sizeUnits)
    clearView = clearView or false
    startDelay = startDelay or 0
@@ -1,7 +1,19 @@
+-- ====================================================================================
+-- DCSEX.ENUMS - VARIOUS ENUMS
+-- ====================================================================================
+-- DCSEx.enums.lineType
+-- DCSEx.enums.taskEvent
+-- DCSEx.enums.taskFamily
+-- DCSEx.enums.taskFlag
+-- DCSEx.enums.timePeriod
+-- DCSEx.enums.unitFamily
+-- DCSEx.enums.victoryCondition
+-- ====================================================================================
+
 DCSEx.enums = {}

 -------------------------------------
-- Line types for map markers. The enum is missing from DCS
+-- Line types for map markers. This enum is missing from DCS
 -------------------------------------
 DCSEx.enums.lineType = {
    NO_LINE = 0,
@@ -13,16 +25,6 @@ DCSEx.enums.lineType = {
    TWO_DASH = 6,
 }

-------------------------------------
-- Event to check to see if a task/objective is complete
-------------------------------------
-DCSEx.enums.spawnPointType = {
-    LAND_LARGE = 1,
-    LAND_MEDIUM = 2,
-    LAND_SMALL = 3,
-    SEA = 4,
-}
-
 -------------------------------------
 -- Event to check to see if a task/objective is complete
 -------------------------------------
@@ -113,11 +115,13 @@ DCSEx.enums.unitFamily = {
    STATIC_STRUCTURE = 402
 }

+-------------------------------------
+-- Victory conditions for tasks/objectives
+-------------------------------------
 DCSEx.enums.victoryCondition = {
    DESTROY = 1,
    DESTROY_NO_AIR_DEFENSE = 2,
    DESTROY_SCENERY = 3,
    DESTROY_TRACK_RADARS_ONLY = 4, -- for SEAD tasks
-
-    LAND_NEAR = 5,
+    LAND_NEAR = 5
 }
@@ -1,18 +1,20 @@
 -- ====================================================================================
-- (DCS LUA ADD-ON) ENVMISSION - FUNCTIONS RELATED TO THE ENV.MISSION TABLE
--
+-- DCSEX.ENVMISSION - FUNCTIONS RELATED TO THE ENV.MISSION TABLE
+-- ====================================================================================
 -- DCSEx.envMission.getDecade(yearOffset)
-- DCSEx.envMission.getDistanceToNearestPlayerSpawnPoint(point)
+-- DCSEx.envMission.getDistanceToNearestPlayerSpawnPoint(coalition, point)
 -- DCSEx.envMission.getGroup(groupID)
 -- DCSEx.envMission.getGroups(sideID)
 -- DCSEx.envMission.getPlayerGroups(coalitionId)
 -- DCSEx.envMission.getPlayerGroupsCenterPoint(coalitionId)
+-- DCSEx.envMission.setBriefing(side, text, picture)
 -- ====================================================================================

 DCSEx.envMission = {}

 -------------------------------------
 -- Returns the decade during which the mission takes place (1940 to 2010)
+-------------------------------------
 -- @param yearOffset An offset to apply to the actual year
 -- @return The decade, as a number
 -------------------------------------
@@ -22,6 +24,7 @@ end

 -------------------------------------
 -- Returns the distance to the nearest player spawn point
+-------------------------------------
 -- @param coalition Coalition the players belong to
 -- @param point A vec3 or vec2
 -- @return The distance, in meters, to the nearest player spawn point, or nil if no player spawn points are present
@@ -42,6 +45,7 @@ end

 -------------------------------------
 -- Gets information about a group
+-------------------------------------
 -- @param groupID Group ID
 -- @return Missiondata group table or nil if ID doesn't exist
 -------------------------------------
@@ -59,6 +63,7 @@ end

 -------------------------------------
 -- Gets all unit groups
+-------------------------------------
 -- @param sideID Coalition ID (coalition.side.*), or nil to return unit groups from all coalitions
 -- @return Table of missiondata group tables
 -------------------------------------
@@ -98,6 +103,7 @@ end

 -------------------------------------
 -- Gets all player groups
+-------------------------------------
 -- @param coalitionId Coalition ID (coalition.side.*), or nil to return unit groups from all coalitions
 -- @return Table of missiondata group tables
 -------------------------------------
@@ -126,6 +132,7 @@ end

 -------------------------------------
 -- Return the center 2D point of all player groups
+-------------------------------------
 -- @param coalitionId Coalition ID (coalition.side.*), or nil to use unit groups from all coalitions
 -- @return A 2D point, or nil if no player groups
 -------------------------------------
@@ -145,7 +152,13 @@ function DCSEx.envMission.getPlayerGroupsCenterPoint(coalitionId)
    return center
 end

-- TODO: description & file header
+-------------------------------------
+-- Sets the text for the briefing description in the briefing panel
+-------------------------------------
+-- @param side Coalition ID (coalition.side.*) of the coalition
+-- @param text Text of the briefing
+-- @param picture Resource name of the picture to use for the briefing
+-------------------------------------
 function DCSEx.envMission.setBriefing(side, text, picture)
    text = text or ""
    text = text:gsub("\n", "\\n")
@@ -1,106 +1,56 @@
 -- ====================================================================================
-- DCSEx.IO - HANDLES READING/WRITING FILES
+-- DCSEX.IO - HANDLES READING/WRITING FILES
 -- ====================================================================================
 -- DCSEx.io.canReadAndWrite()
 -- DCSEx.io.load(fileName)
-- DCSEx.io.save(fileName, values)
+-- DCSEx.io.save(fileName, str)
 -- ====================================================================================

 DCSEx.io = {}

-do
-    -------------------------------------
-    -- Returns true if the IO table has been unsanitized (allowing IO operations)
-    -- and false if it hasn't been
-    --
-    -- @return A boolean
-    -------------------------------------
-    function DCSEx.io.canReadAndWrite()
-        return io ~= nil
-    end
-
-    -------------------------------------
-    -- Loads a table from a text file
-    --
-    -- @param fileName Name of the file to read
-    -- @param obfuscate Should the file contents be obfuscated?
-    -- @return A table, or nil if something went wrong
-    -------------------------------------
-    -- function DCSEx.io.load(fileName, obfuscate)
-    --     obfuscate = obfuscate or false -- TODO: obfuscation
-
-    --     -- IO table is sanitized, cannot read/write to disk
-    --     if not DCSEx.io.canReadAndWrite() then return nil end
-
-    --     local saveFile = io.open(fileName, "r")
-    --     if not saveFile then return nil end
-
-    --     local values = {}
-    --     local rawText = saveFile:read("*all")
-    --     for k, v in string.gmatch(rawText, "(%w+)=(%w+)") do
-    --         local numval = tonumber(v)
-    --         if numval then
-    --             values[k] = tonumber(v)
-    --         else
-    --             values[k] = v
-    --             -- trigger.action.outText("GET value \""..k.."\" AT \""..tostring(v).."\"", 1)
-    --         end
-    --     end
-    --     saveFile:close()
-
-    --     return values
-    -- end
-
-    function DCSEx.io.load(fileName)
-        -- IO table is sanitized, cannot read/write to disk
-        if not DCSEx.io.canReadAndWrite() then return nil end
-
-        local saveFile = io.open(fileName, "r")
-        if not saveFile then return nil end
-        local str = saveFile:read("*all")
-        saveFile:close()
-
-        return str
-    end
-
-    -------------------------------------
-    -- Saves a table to a text file
-    --
-    -- @param fileName Name of the file to write to
-    -- @param values Key/value table containing the values to save
-    -- @param obfuscate Should the file contents be obfuscated?
-    -- @return True if everything went right, false otherwise
-    -------------------------------------
-    -- function DCSEx.io.save(fileName, values, obfuscate)
-    --     obfuscate = obfuscate or false -- TODO: obfuscation
-
-    --     -- IO table is sanitized, cannot read/write to disk
-    --     if not DCSEx.io.canReadAndWrite() then return false end
-
-    --     -- No values or not a table
-    --     if values == nil then return false end
-    --     if type(values) ~= "table" then return false end
-
-    --     local saveFile = io.open(fileName, "w")
-    --     if not saveFile then return false end
-
-    --     for k,v in pairs(values) do
-    --         saveFile:write(k.."="..tostring(v).."\n")
-    --         -- trigger.action.outText("SET value \""..k.."\" TO \""..tostring(v).."\"", 1)
-    --     end
-    --     saveFile:close()
-
-    --     return true
-    -- end
-    function DCSEx.io.save(fileName, str)
-        -- IO table is sanitized, cannot read/write to disk
-        if not DCSEx.io.canReadAndWrite() then return false end
-
-        local saveFile = io.open(fileName, "w")
-        if not saveFile then return false end
-        saveFile:write(str)
-        saveFile:close()
-
-        return true
-    end
+-------------------------------------
+-- Returns true if the IO table has been unsanitized (allowing IO operations) and false if it hasn't been
+-------------------------------------
+-- @return A boolean
+-------------------------------------
+function DCSEx.io.canReadAndWrite()
+    return io ~= nil
+end
+
+-------------------------------------
+-- Loads a string from a text file
+-------------------------------------
+-- @param fileName Name of the file to read
+-- @return A string, or nil if something went wrong
+-------------------------------------
+function DCSEx.io.load(fileName)
+    -- IO table is sanitized, cannot read/write to disk
+    if not DCSEx.io.canReadAndWrite() then return nil end
+
+    local saveFile = io.open(fileName, "r")
+    if not saveFile then return nil end
+    local str = saveFile:read("*all")
+    saveFile:close()
+
+    return str
+end
+
+-------------------------------------
+-- Writes a string to a text file
+-------------------------------------
+-- @param fileName Name of the file to write to. It will be overwritten if it exists.
+-- @param values Key/value table containing the values to save
+-- @param str String to write
+-- @return True if everything went right, false otherwise
+-------------------------------------
+function DCSEx.io.save(fileName, str)
+    -- IO table is sanitized, cannot read/write to disk
+    if not DCSEx.io.canReadAndWrite() then return false end
+
+    local saveFile = io.open(fileName, "w")
+    if not saveFile then return false end
+    saveFile:write(str)
+    saveFile:close()
+
+    return true
 end
@@ -1,13 +1,14 @@
 -- ====================================================================================
-- (DCS LUA ADD-ON) MATH - EXTENSION TO THE "MATH" TABLE
--
+-- DCSEX.MATH - MATH AND MATH-RELATED FUNCTIONS
+-- ====================================================================================
 -- (Constant) DCSEx.math.TWO_PI
 -- DCSEx.math.addVec(vecA, vecB)
 -- DCSEx.math.clamp(val, min, max)
 -- DCSEx.math.getBearing(point, refPoint, returnAsNESWstring)
 -- DCSEx.math.getDistance2D(vec2a, vec2b)
 -- DCSEx.math.getDistance3D(vec3a, vec3b)
-- DCSEx.math.getRelativeHeading(point, refObject)
+-- DCSEx.math.getLength3D(vec3)
+-- DCSEx.math.getRelativeHeading(point, refObject, format)
 -- DCSEx.math.getVec2FromAngle(angle)
 -- DCSEx.math.isPointInsideCircle(center, radius, vec2)
 -- DCSEx.math.isPointInsidePolygon(polygon, vec2)
@@ -28,12 +29,13 @@
 DCSEx.math = {}

 -------------------------------------
-- Constants
+-- Two times Pi
 -------------------------------------
 DCSEx.math.TWO_PI = math.pi * 2

 -------------------------------------
 -- Returns the sum of two vec2 or vec3
+-------------------------------------
 -- @param vecA A vector
 -- @param vecB Another vector
 -- @return The sum of both vectors
@@ -48,6 +50,7 @@ end

 -------------------------------------
 -- Clamp a number value between min and max
+-------------------------------------
 -- @param value The value to clamp
 -- @param min Minimum allowed value
 -- @param max Maximum allowed value
@@ -59,6 +62,7 @@ end

 -------------------------------------
 -- Gets the bearing between two vectors, in degrees
+-------------------------------------
 -- @param point A vec2/vec3
 -- @param refPoint Vec2/vec3 to use as a reference point
 -- @param returnAsNESWstring Should the value be returned as a N/S/E/W string instead of a numeric value
@@ -90,6 +94,7 @@ end

 -------------------------------------
 -- Returns the pythagorean distance between two 2D points or the length of a single vector
+-------------------------------------
 -- @param vec2a A 2D point
 -- @param vec2b (optional) Another 2D point
 -- @return Distance between the points
@@ -104,6 +109,7 @@ end

 -------------------------------------
 -- Returns the pythagorean distance between two 3D points or the length of a single vector
+-------------------------------------
 -- @param vec3a A 3D point
 -- @param vec3b (optional) Another 3D point
 -- @return Distance between the points
@@ -114,8 +120,19 @@ function DCSEx.math.getDistance3D(vec3a, vec3b)
    return math.sqrt((vec3a.x - vec3b.x) ^ 2 + (vec3a.y - vec3b.y) ^ 2 + (vec3a.z - vec3b.z) ^ 2)
 end

+-------------------------------------
+-- Returns the length of a 3D vector
+-------------------------------------
+-- @param vec3 A 3D vector
+-- @return Length of the vector
+-------------------------------------
+function DCSEx.math.getLength3D(vec3)
+    return math.sqrt(vec3.x ^ 2 + vec3.y ^ 2 + vec3.z ^ 2)
+end
+
 -------------------------------------
 -- Returns the relative heading difference between refObject and a given point
+-------------------------------------
 -- @param point The point for which to check the relative heading
 -- @param refObject The reference object against which relative heading should be measured
 -- @param format (optional) Return format. Possible formats are "clock" (1 o'clock...) or "cardinal" (NNW...)
@@ -149,6 +166,7 @@ end

 -------------------------------------
 -- Returns an normalized vec2 from an angle/bearing in radians
+-------------------------------------
 -- @param unit Angle/bearing in radians
 -- @return A normalized vec2
 -------------------------------------
@@ -158,6 +176,7 @@ end

 -------------------------------------
 -- Is a point inside a circle?
+-------------------------------------
 -- @param center The center of the circle, as a vec2
 -- @param radius The radius of the circle
 -- @param vec2 A vec2
@@ -169,6 +188,7 @@ end

 -------------------------------------
 -- Is a point inside a polygon?
+-------------------------------------
 -- @param vec2[] A polygon, as a table of vec2
 -- @param vec2 A vec2
 -- @return True if vec2 is inside the polygon, false otherwise
@@ -195,6 +215,7 @@ end

 -------------------------------------
 -- Compares two 2D or 3D points
+-------------------------------------
 -- @param pointA a Point2 or Point3
 -- @param pointB another Point2 or Point3
 -- @return True if points are the same, false otherwise
@@ -210,7 +231,8 @@ function DCSEx.math.isSamePoint(pointA, pointB)
 end

 -------------------------------------
-- Linearly interpolates between two numbers
+-- Linearly interpolates two numbers
+-------------------------------------
 -- @param val0 Value vers l=0
 -- @param val1 Value vers l=1
 -- @param t Interpolation between 0 and 1
@@ -222,6 +244,7 @@ end

 -------------------------------------
 -- Multiplies both the x and y components of a vec2 by a floating-point value
+-------------------------------------
 -- @param vec2 A vec2
 -- @param mult A floating-point value
 -- @return A vec2
@@ -232,6 +255,7 @@ end

 -------------------------------------
 -- Returns an normalized vec2
+-------------------------------------
 -- @param unit A vec2
 -- @return A normalized vec2
 -------------------------------------
@@ -242,6 +266,7 @@ end

 -------------------------------------
 -- Returns a random boolean
+-------------------------------------
 -- @return A boolean
 -------------------------------------
 function DCSEx.math.randomBoolean()
@@ -250,20 +275,19 @@ end

 -------------------------------------
 -- Returns a random floating-point number between min and max
+-------------------------------------
 -- @param min Minimum floating-point value
 -- @param max Maximum floating-point value
 -- @return A number
 -------------------------------------
 function DCSEx.math.randomFloat(min, max)
-    if min >= max then
-        return min
-    end
-
+    if min >= max then return min end
    return min + math.random() * (max - min)
 end

 -------------------------------------
 -- Returns a random vec2 at a given distance of another vec2
+-------------------------------------
 -- @param point Reference point
 -- @param distance Distance from the reference point
 -- @return A vec2
@@ -278,6 +302,7 @@ end

 -------------------------------------
 -- Returns a random vec2 in circle of a given center and radius
+-------------------------------------
 -- @param center Center of the circle as a vec2
 -- @param radius Radius of the circle
 -- @param minRadius (optional) Minimum inner radius circle in which points should not be spawned
@@ -306,6 +331,7 @@ end

 -------------------------------------
 -- Returns a random sign as a number, -1 or 1
+-------------------------------------
 -- @return -1 50% of the time, 1 50% of the time
 -------------------------------------
 function DCSEx.math.randomSign()
@@ -317,6 +343,7 @@ end

 -------------------------------------
 -- Converts a value to a boolean
+-------------------------------------
 -- @param val Value to convert
 -- @return A boolean, or nil if val was nil
 -------------------------------------
@@ -331,6 +358,7 @@ end

 -------------------------------------
 -- Converts a vec2 to a vec3
+-------------------------------------
 -- @param vec2 A vec2
 -- @param y (Optional) A value for the vec3's y component or "land" to use land height
 -- @return A vec3 where v3.x=v2.x, v3.y=y and v3.z=v2.y
@@ -349,6 +377,7 @@ end

 -------------------------------------
 -- Converts a vec3 to a vec2
+-------------------------------------
 -- @param vec3 A vec3
 -- @return A vec2 where v2.x=v3.x and v2.y=v3.z
 -------------------------------------
@@ -1,8 +1,12 @@
 -- ====================================================================================
-- (DCS LUA ADD-ON) STRING - EXTENSION TO THE "STRING" TABLE
--
+-- DCSEX.STRING - FUNCTIONS RELATED TO STRING MANIPULATION
+-- ====================================================================================
 -- DCSEx.string.firstToUpper(str)
 -- DCSEx.string.getReadingTime(message)
+-- DCSEx.string.join(table, separator)
+-- DCSEx.string.getTimeString(timeInSeconds, separator)
+-- DCSEx.string.toStringNumber(number, firstToUpper)
+-- DCSEx.string.toStringThousandsSeparator(number)
 -- DCSEx.string.split(str, separator)
 -- DCSEx.string.startsWith(haystack, needle)
 -- DCSEx.string.trim(str)
@@ -12,6 +16,7 @@ DCSEx.string = {}

 -------------------------------------
 -- Uppercases the fist letter of a string
+-------------------------------------
 -- @param str A string
 -- @return A string, with the first letter cast to upper case
 -------------------------------------
@@ -21,6 +26,7 @@ end

 -------------------------------------
 -- Estimates the time (in seconds) required to read a string
+-------------------------------------
 -- @param message A text message
 -- @return A duration in seconds
 -------------------------------------
@@ -31,7 +37,13 @@ function DCSEx.string.getReadingTime(message)
    return DCSEx.math.clamp(#message / 8.7, 3.0, 15.0) -- 10.7 letters per second, minimum length 3 seconds, max length 15 seconds
 end

-- TODO: description, update file header
+-------------------------------------
+-- Joins a table of string into a single string
+-------------------------------------
+-- @param table A table of strings
+-- @param separator Separator used to glue table entries (default: "")
+-- @return A string
+-------------------------------------
 function DCSEx.string.join(table, separator)
    local joinedString = ""

@@ -45,10 +57,16 @@ function DCSEx.string.join(table, separator)
    return joinedString
 end

-- TODO: description, file header
-function DCSEx.string.getTimeString(timeInSeconds, useColon)
+-------------------------------------
+-- Converts a time of day (in seconds since midnight) to a human-readable time string
+-------------------------------------
+-- @param timeInSeconds Number of seconds since midnight (default: current time)
+-- @param separator Separator between minutes and seconds (":", "h"...) (default: "")
+-- @return The time, as as string
+-------------------------------------
+function DCSEx.string.getTimeString(timeInSeconds, separator)
    timeInSeconds = timeInSeconds or timer.getAbsTime()
-    useColon = useColon or false
+    separator = separator or ""

    timeInSeconds = math.max(0, timeInSeconds) % 86400

@@ -61,13 +79,15 @@ function DCSEx.string.getTimeString(timeInSeconds, useColon)
    local minutesStr = tostring(minutes)
    if #minutesStr == 1 then minutesStr = "0"..minutesStr end

-    local separator = ""
-    if useColon then separator = ":" end
-
    return hoursStr..separator..minutesStr
 end

-- TODO: description, file header
+-------------------------------------
+-- Converts a numeric value between 0 and 20 into its word/string representation
+-------------------------------------
+-- @param number A number (>=0, <=20)
+-- @return A string
+-------------------------------------
 function DCSEx.string.toStringNumber(number, firstToUpper)
    firstToUpper = firstToUpper or false
    local NUMBERS = { "zero", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine", "ten", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen", "twenty" }
@@ -81,8 +101,13 @@ function DCSEx.string.toStringNumber(number, firstToUpper)
    return DCSEx.string.toStringThousandsSeparator(number)
 end

-- TODO: description, file header
-- Code from https://stackoverflow.com/questions/10989788/format-integer-in-lua
+-------------------------------------
+-- Converts a numeric value to a string, with proper thousands separators
+-- (Code taken from https://stackoverflow.com/questions/10989788/format-integer-in-lua)
+-------------------------------------
+-- @param number A number
+-- @return A string
+-------------------------------------
 function DCSEx.string.toStringThousandsSeparator(number)
  local i, j, minus, int, fraction = tostring(number):find('([-]?)(%d+)([.]?%d*)')
  int = int:reverse():gsub("(%d%d%d)", "%1,")
@@ -90,7 +115,8 @@ function DCSEx.string.toStringThousandsSeparator(number)
 end

 -------------------------------------
-- Splits a string
+-- Splits a string into a table
+-------------------------------------
 -- @param str The string to split
 -- @param separator The string to split
 -- @return A table of split strings
@@ -105,6 +131,7 @@ end

 -------------------------------------
 -- Does a string starts with the given substring?
+-------------------------------------
 -- @param haystack The string
 -- @param needle The substring to look for
 -- @return True if it starts with the substring, false otherwise
@@ -115,6 +142,7 @@ end

 -------------------------------------
 -- Trims a string
+-------------------------------------
 -- @param str A string
 -- @return A string
 -------------------------------------
@@ -1,15 +1,17 @@
 -- ====================================================================================
-- (DCS LUA ADD-ON) TABLE - EXTENSION TO THE "TABLE" TABLE
--
+-- DCSEX.TABLE - FUNCTIONS RELATED TO TABLE MANIPULATION
+-- ====================================================================================
 -- DCSEx.table.contains(t, val)
 -- DCSEx.table.containsKey(t, k)
 -- DCSEx.table.containsAll(t, values)
 -- DCSEx.table.containsAny(t, values)
+-- DCSEx.table.containsAllKeys(t, keys)
+-- DCSEx.table.containsAnyKeys(t, keys)
 -- DCSEx.table.countNonNils(t)
 -- DCSEx.table.deepCopy(orig)
 -- DCSEx.table.dump(t)
-- DCSEx.table.getKeys(t)
 -- DCSEx.table.getKeyFromValue(t, val)
+-- DCSEx.table.getKeys(t)
 -- DCSEx.table.getRandom(t)
 -- DCSEx.table.getRandomIndex(t)
 -- DCSEx.table.shuffle(t)
@@ -19,6 +21,7 @@ DCSEx.table = {}

 -------------------------------------
 -- Returns true if table t contains value val
+-------------------------------------
 -- @param t A table
 -- @param val A value
 -- @return True if the table contains the value, false otherwise
@@ -35,6 +38,7 @@ end

 -------------------------------------
 -- Returns true if table t contains key k
+-------------------------------------
 -- @param t A table
 -- @param k A key
 -- @return True if the table contains the key, false otherwise
@@ -47,10 +51,11 @@ function DCSEx.table.containsKey(t, k)
 end

 -------------------------------------
-- Returns true if table t contains all values in table values
+-- Returns true if table t contains ALL values from the "values" table
+-------------------------------------
 -- @param t A table
 -- @param values A table of values
-- @return True if the table contains all values, false otherwise
+-- @return True if the table contains ALL values, false otherwise
 -------------------------------------
 function DCSEx.table.containsAll(t, values)
    if not t then return false end
@@ -65,10 +70,11 @@ function DCSEx.table.containsAll(t, values)
 end

 -------------------------------------
-- Returns true if table t contains at least one value in table values
+-- Returns true if table t contains AT LEAST ONE value from the "values" table
+-------------------------------------
 -- @param t A table
 -- @param values A table of values
-- @return True if the table contains at least one value, false otherwise
+-- @return True if the table contains AT LEAST ONE value, false otherwise
 -------------------------------------
 function DCSEx.table.containsAny(t, values)
    if not t then return false end
@@ -82,6 +88,13 @@ function DCSEx.table.containsAny(t, values)
    return false
 end

+-------------------------------------
+-- Returns true if table t contains ALL keys from the "keys" table
+-------------------------------------
+-- @param t A table
+-- @param keys A table of keys
+-- @return True if the table contains ALL keys, false otherwise
+-------------------------------------
 function DCSEx.table.containsAllKeys(t, keys)
    if not t then return false end

@@ -94,6 +107,13 @@ function DCSEx.table.containsAllKeys(t, keys)
    return true
 end

+-------------------------------------
+-- Returns true if table t contains AT LEAST ONE key from the "keys" table
+-------------------------------------
+-- @param t A table
+-- @param values A table of keys
+-- @return True if the table contains AT LEAST ONE key, false otherwise
+-------------------------------------
 function DCSEx.table.containsAnyKeys(t, keys)
    if not t then return false end

@@ -108,6 +128,7 @@ end

 -------------------------------------
 -- Returns the number of non-nils elements in a table
+-------------------------------------
 -- @param t A table
 -- @return A number
 -------------------------------------
@@ -122,6 +143,7 @@ end

 -------------------------------------
 -- Returns a deep copy of the table, doesn't work with recursive tables (code from http://lua-users.org/wiki/CopyTable)
+-------------------------------------
 -- @param orig A table
 -- @return A deep copied clone of the table
 -------------------------------------
@@ -142,6 +164,7 @@ end

 -------------------------------------
 -- Dumps the content of a table as a string
+-------------------------------------
 -- @param orig A table
 -- @return A string representaton of the table
 -------------------------------------
@@ -160,6 +183,7 @@ function DCSEx.table.dump(t)

 -------------------------------------
 -- Returns the key associated to a value in a table, or nil if not found
+-------------------------------------
 -- @param t A table
 -- @param val A value
 -- @return The key associated to this value in the table, or nil
@@ -173,6 +197,7 @@ end

 -------------------------------------
 -- Returns all the keys in an associative table
+-------------------------------------
 -- @param t A table
 -- @return An array of keys
 -------------------------------------
@@ -191,6 +216,7 @@ end

 -------------------------------------
 -- Returns a random value from a numerically-indexed table
+-------------------------------------
 -- @param t A table
 -- @return A random element from the table
 -------------------------------------
@@ -200,6 +226,7 @@ end

 -------------------------------------
 -- Returns a random index from a numerically-indexed table
+-------------------------------------
 -- @param t A table
 -- @return A random index from the table
 -------------------------------------
@@ -209,6 +236,7 @@ end

 -------------------------------------
 -- Randomly shuffles a numerically-indexed table
+-------------------------------------
 -- @param t A table
 -- @return A table with shuffled values
 -------------------------------------
@@ -1,3 +1,7 @@
+-- ====================================================================================
+-- DCSEX.UNITCALLSIGNMAKER - GENERATES CALLSIGNS FOR NEW UNITS
+-- ====================================================================================
+
 DCSEx.unitCallsignMaker = {}

 do
@@ -139,7 +143,7 @@ do

    local currentCallsigns = {}
    for _,i in pairs(CALLSIGN_TYPE) do
-        currentCallsigns[i] = { 1, 1, 1, 1, 1, 1, 1, 1, 1 }
+        currentCallsigns[i] = { 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 }
    end

    local function getCallsignTypeByUnitType(unitType)
@@ -225,7 +229,7 @@ do
        for _,g in ipairs(missionGroups) do
            if g.units and g.units[1] then
                local unit = g.units[1]
-                if unit.callsign and unit.callsign[1] and unit.callsign.name then
+                if unit.callsign and type(unit.callsign) == "table" and unit.callsign.name then
                    local callsignName = unit.callsign.name:sub(1, #unit.callsign.name - 2)
                    incrementCallsign(callsignName, unit.callsign[2])
                end
@@ -1,16 +1,18 @@
 -- ====================================================================================
-- DCSEX.UNITGROUMAKER - CREATES AND ADDS GROUPS TO THE GAME WORLD
--
+-- DCSEX.UNITGROUPMAKER - CREATES AND ADDS GROUPS TO THE GAME WORLD
+-- ====================================================================================
 -- (local) createGroupTable(groupID, groupCategory, options)
 -- (local) getDefaultUnitSpread(groupCategory)
 -- (local) getNextGroupID()
 -- (local) getNextUnitID()
 -- (local) setAircraftTaskAwacs(groupTable)
+-- (local) setAircraftTaskCAP(groupTable)
+-- (local) setAircraftTaskFollow(groupTable, followedGroupID, xyDistance)
 -- (local) setAircraftTaskOrbit(groupTable, options)
 -- (local) setCommand(groupTable, actionID, actionValue)
 -- (local) setOption(groupTable, optionID, optionValue)
+-- DCSEx.unitGroupMaker.createStatic(side, point2, typeName, shapeName, heading, dead)
 -- DCSEx.unitGroupMaker.create(coalitionID, groupCategory, vec2, unitTypes, options)
-- DCSEx.unitGroupMaker.initialize()
 -- ====================================================================================

 DCSEx.unitGroupMaker = {}
@@ -18,6 +20,7 @@ DCSEx.unitGroupMaker = {}
 do
    local nextGroupID = 1 -- ID of the next generated group
    local nextUnitID = 1 -- ID of the next generated unit
+    local dataLinkID = 201 -- Next datalink ID

    local function createGroupTable(groupID, groupCategory, options)
        local groupTable = {
@@ -442,9 +445,19 @@ do
                unitTable.name = unitTable.callsign.name

                -- Special properties for unit
+                unitTable.AddPropAircraft = {}
                if aircraftDB.properties then
                    unitTable.AddPropAircraft = DCSEx.table.deepCopy(aircraftDB.properties)
                end
+                -- Setup datalink
+                local datalinkString = tostring(dataLinkID)
+                if #datalinkString == 3 then
+                    datalinkString = "00"..datalinkString
+                elseif #datalinkString == 4 then
+                    datalinkString = "0"..datalinkString
+                end
+                unitTable.AddPropAircraft["STN_L16"] = datalinkString
+                dataLinkID = dataLinkID + 1

                -- Common payload (fuel, gun ammo, etc)
                if aircraftDB.payload then
@@ -1,3 +1,6 @@
+-- ====================================================================================
+-- DCSEX.UNITNAMESMAKER - GENERATE CREDIBLE AND UNIT NAMES FOR UNIT GROUPS
+-- ====================================================================================
 DCSEx.unitNamesMaker = {}

 do
@@ -1,20 +1,28 @@
 -- ====================================================================================
-- WORLDTOOLS - FUNCTIONS RELATED TO THE GAME WORLD
+-- DCSEX.WORLD - FUNCTIONS RELATED TO THE GAME WORLD
 -- ====================================================================================
 -- DCSEx.world.collidesWithScenery(vec2, radius)
-- DCSEx.world.findSpawnPoint(vec2, minRadius, maxRadius, surfaceType, radiusWithoutScenery)
+-- DCSEx.world.destroyGroupByID(groupID)
+-- DCSEx.world.explodeUnit(unitID, amount)
 -- DCSEx.world.getAllPlayers()
 -- DCSEx.world.getAllSceneryBuildings(minHealth)
-- DCSEx.world.getAllUnits(unitCategory)
+-- DCSEx.world.getAllUnits(coalitionID, unitCategory)
 -- DCSEx.world.getClosestPointOnRoadsVec2(vec2)
-- DCSEx.world.getCoordinatesAsString(point)
+-- DCSEx.world.getCoordinatesAsString(point, hideElevation)
 -- DCSEx.world.getCurrentMarkerID()
+-- DCSEx.world.getFirstPlayer(side)
 -- DCSEx.world.getGroupByID(groupID)
+-- DCSEx.world.getGroupCenter(group)
+-- DCSEx.world.getMarkerByText(text, coalition)
 -- DCSEx.world.getNextMarkerID()
+-- DCSEx.world.getPlayersInAir(side)
+-- DCSEx.world.getPlayersOnGround(side)
 -- DCSEx.world.getSceneriesInZone(center, radius, minHealth)
+-- DCSEx.world.getSpawnPoint(zone, surfaceType, safeRadius)
 -- DCSEx.world.getStaticObjectByID(staticID)
 -- DCSEx.world.getTerrainHeightDiff(coord, searchRadius)
 -- DCSEx.world.getUnitByID(unitID)
+-- DCSEx.world.getUnitsCenter(units)
 -- DCSEx.world.isGroupAlive(g, unitsMustBeInAir)
 -- DCSEx.world.setUnitLifePercent(unitID, life)
 -- ====================================================================================
@@ -25,9 +33,16 @@ do
    -- TODO: get max marker already in use from envMission
    local nextMarkerId = 1 -- Next map marker ID

+    -------------------------------------
+    -- Returns true if vec2 is less than radius meters away from any scenery object
+    -------------------------------------
+    -- @param vec2 A 2d point
+    -- @param radius A range, in meters
+    -- @return True if vec2 is closer than radius meters from any object, false otherwise
+    -------------------------------------
    function DCSEx.world.collidesWithScenery(vec2, radius)
-        local foundOne = false
        radius = radius or 8
+        local foundOne = false

        local volS = {
            id = world.VolumeType.SPHERE,
@@ -47,46 +62,30 @@ do
        return foundOne
    end

-    -- function DCSEx.world.findSpawnPoint(vec2, minRadius, maxRadius, surfaceType, radiusWithoutScenery, territorySide, expandSearch)
-    --     expandSearch = expandSearch or true
+    -------------------------------------
+    -- Destroys a group
+    -------------------------------------
+    -- @param groupID ID of the group to destroy
+    -------------------------------------
+    function DCSEx.world.destroyGroupByID(groupID)
+        if not groupID then return end
+        local g = DCSEx.world.getGroupByID(groupID)
+        if g then g:destroy() end
+    end

-    --     for _=0,16 do
-    --         for _=0,16 do
-    --             local spawnPoint = nil
+    -------------------------------------
+    -- Spawns an explosion where an unit is located
+    -------------------------------------
+    -- @param unitID ID of the unit
+    -- @param amount Intensity of the explosion
+    -------------------------------------
+    function DCSEx.world.explodeUnit(unitID, amount)
+        net.dostring_in("mission", string.format("a_explosion_unit(%d, %f)", unitID, amount))
+    end

-    --             spawnPoint = DCSEx.math.randomPointInCircle(
-    --                 vec2,
-    --                 DCSEx.converter.nmToMeters(maxRadius),
-    --                 DCSEx.converter.nmToMeters(minRadius),
-    --                 surfaceType)
-
-    --             if spawnPoint and radiusWithoutScenery then
-    --                 if DCSEx.world.collidesWithScenery(spawnPoint, radiusWithoutScenery) then
-    --                     spawnPoint = nil
-    --                 end
-    --             end
-
-    --             if spawnPoint and territorySide then
-    --                 if scramble.territories.getOwner(spawnPoint) ~= territorySide then
-    --                     spawnPoint = nil
-    --                 end
-    --             end
-
-    --             if spawnPoint then return spawnPoint end
-    --         end
-
-    --         if not expandSearch then return nil end
-
-    --         minRadius = minRadius * 0.9
-    --         maxRadius = maxRadius * 1.2
-    --     end
-
-    --     return nil
-    -- end
-
-    
    -------------------------------------
    -- Returns a table of all player-controlled units currently in the game
+    -------------------------------------
    -- @return A table of unit objects
    -------------------------------------
    function DCSEx.world.getAllPlayers()
@@ -104,7 +103,8 @@ do

    -------------------------------------
    -- Returns a table of all map scenery buildings.
-    -- This function is rather CPU-consuming, better run it once on mission start and store the result in table.
+    -- This function is rather CPU-heavy, better run it once on mission start and store the results in a table.
+    -------------------------------------
    -- @param minHealth Minimum health a building must have to be included in the table
    -- @return A table of scenery objects
    -------------------------------------
@@ -134,6 +134,7 @@ do

    -------------------------------------
    -- Returns all units belonging to a given category
+    -------------------------------------
    -- @param coalitionID Coalition ID (coalition.side.XXX) or nil to search all coalitions
    -- @param unitCategory An unit category (Group.Category.XXX)
    -- @return A table of unit tables
@@ -156,7 +157,9 @@ do
    end

    -------------------------------------
-    -- Returns the closest point to roads as a vec2
+    -- Returns the closest point to roads as a vec2.
+    -- An alternative to ED's zany land.getClosestPointOnRoads which returns two integers (!!???)
+    -------------------------------------
    -- @param vec2 Coordinates to look for
    -- @return A vec2 with the closest point on roads
    -------------------------------------
@@ -168,6 +171,7 @@ do
    -------------------------------------
    -- Returns the LL/MGRS coordinates of a point, as a string
    -- Based on code by Bushmanni - https://forums.eagle.ru/showthread.php?t=99480
+    -------------------------------------
    -- @param point The point, as a vec2 or vec3
    -- @param hideElevation (optional) Show elevation NOT be displayed? Default: false
    -- @return A string
@@ -222,6 +226,7 @@ do

    -------------------------------------
    -- Returns the last map marker ID generated by DCSEx.world.getNextMarkerID(), if any
+    -------------------------------------
    -- @return A numeric ID, or nil
    -------------------------------------
    function DCSEx.world.getCurrentMarkerID()
@@ -229,8 +234,27 @@ do
        return nextMarkerId - 1
    end

+    -------------------------------------
+    -- Returns the first player found
+    -------------------------------------
+    -- @param side The coalition the player must belong to, or nil to search for any player
+    -- @return A player unit object, or nil if no player was found
+    -------------------------------------
+    function DCSEx.world.getFirstPlayer(side)
+        local players = {}
+        if side then
+            players = coalition.getPlayers(side)
+        else
+            players = DCSEx.world.getAllPlayers()
+        end
+
+        if not players or #players == 0 then return nil end
+        return players[1]
+    end
+
    -------------------------------------
    -- Searches and return a group by its ID
+    -------------------------------------
    -- @param groupID ID of the group
    -- @return A group table, or nil if no group with this ID was found
    -------------------------------------
@@ -246,7 +270,13 @@ do
        return nil
    end

-    -- TODO: description
+    -------------------------------------
+    -- Searches and return a map marker by its text (case-insensitive)
+    -------------------------------------
+    -- @param text Text to look for (case insensitive)
+    -- @param coalition Coalition the marker must belong to, or nil to search all coalitions
+    -- @return A map marker table, or nil if no marker was found
+    -------------------------------------
    function DCSEx.world.getMarkerByText(text, coalition)
        if not text then return nil end
        text = text:lower()
@@ -256,7 +286,7 @@ do
            local markerText = m.text or ""
            markerText = markerText:lower()
            if markerText == text then
-                if coalition == nil or m.coalition == coalition then
+                if not coalition or m.coalition == coalition then
                    return m
                end
            end
@@ -266,7 +296,8 @@ do
    end

    -------------------------------------
-    -- Returns a new, unique, map marker ID
+    -- Returns a new unique map marker ID
+    -------------------------------------
    -- @return A numeric ID
    -------------------------------------
    function DCSEx.world.getNextMarkerID()
@@ -274,7 +305,12 @@ do
        return nextMarkerId - 1
    end

-    -- TODO: description, file header
+    -------------------------------------
+    -- Returns a table of all player units currently in the air (not on ramp/ground/runway)
+    -------------------------------------
+    -- @param side Coalition the players must belong to, or nil to search all coalitions
+    -- @return A table of player objects
+    -------------------------------------
    function DCSEx.world.getPlayersInAir(side)
        local players = {}
        if side then
@@ -293,7 +329,38 @@ do
        return playersInAir
    end

-    -- TODO: description, file header
+    -------------------------------------
+    -- Returns a table of all player units currently NOT in the air (on ramp/ground/runway)
+    -------------------------------------
+    -- @param side Coalition the players must belong to, or nil to search all coalitions
+    -- @return A table of player objects
+    -------------------------------------
+    function DCSEx.world.getPlayersOnGround(side)
+        local players = {}
+        if side then
+            players = coalition.getPlayers(side)
+        else
+            players = DCSEx.world.getAllPlayers()
+        end
+
+        local playersOnGround = {}
+        for _,p in ipairs(players) do
+            if not p:inAir() then
+                table.insert(playersOnGround, p)
+            end
+        end
+
+        return playersOnGround
+    end
+
+    -------------------------------------
+    -- Returns a valid spawn point for a ground unit (not stuck in trees, buildings...) or a naval unit
+    -------------------------------------
+    -- @param zone Trigger zone in which to look for a spawn point
+    -- @param surface Type of surface (land.SurfaceType enum) to look for, or any to return any point (good for air units)
+    -- @param safeRadius Saferadius in meters from any obstacle (default: 100)
+    -- @return A 2D point, or nil if none was found
+    -------------------------------------
    function DCSEx.world.getSpawnPoint(zone, surfaceType, safeRadius)
        safeRadius = safeRadius or 100

@@ -336,7 +403,14 @@ do
        return nil
    end

-    -- TODO: description
+    -------------------------------------
+    -- Returns a table of all scenery objects in a given radius
+    -------------------------------------
+    -- @param center 2D point on which to center object search
+    -- @param radius Radius (in meters) around the center in which to search
+    -- @param minHealth Minimum health for a scenery object to be valid. Allow filtering of small objects like bollards (default: 0)
+    -- @return A table of scenery objects
+    -------------------------------------
    function DCSEx.world.getSceneriesInZone(center, radius, minHealth)
        minHealth = minHealth or 0
        local sceneries = {}
@@ -362,23 +436,12 @@ do
    end

    -------------------------------------
-    -- Searches and return a static object by its ID
-    -- @param staticID ID of the static object
-    -- @return An unit, or nil if no static object with this ID was found
+    -- Returns the maximum height difference in a given radius around a point
+    -------------------------------------
+    -- @param coord 2D point in which to search
+    -- @param searchRadius Radius in meters
+    -- @return A numeric value, in meters
    -------------------------------------
-    function DCSEx.world.getStaticObjectByID(staticID)
-        for coalitionID = 1, 2 do
-            for _, s in pairs(coalition.getStaticObjects(coalitionID)) do
-                if DCSEx.dcs.getObjectIDAsNumber(s) == staticID then
-                    return s
-                end
-            end
-        end
-
-        return nil
-    end
-
-    -- TODO: description, update file header
    function DCSEx.world.getTerrainHeightDiff(coord, searchRadius)
 		local samples = {}
        searchRadius = searchRadius or 5
@@ -403,30 +466,37 @@ do
        return tMax - tMin
 	end

-    -- TODO: description, update file header
+    -------------------------------------
+    -- Returns the 2D center of unit group
+    -------------------------------------
+    -- @param group A group of unit
+    -- @return The 2D point center of all units' positions or 0,0 if no units were found
+    -------------------------------------
    function DCSEx.world.getGroupCenter(group)
        return DCSEx.world.getUnitsCenter(group:getUnits())
    end

-    -- TODO: description, update file header
-    function DCSEx.world.getUnitsCenter(units)
-        if not units or #units == 0 then return { x = 0, y = 0 } end
-
-        local center = { x = 0, y = 0 }
-        for _,u in pairs(units) do
-            local uPt2 = DCSEx.math.vec3ToVec2(u:getPoint())
-            center.x = center.x + uPt2.x
-            center.y = center.y + uPt2.y
+    -------------------------------------
+    -- Searches and return a coalition static object by its ID
+    -------------------------------------
+    -- @param unitID ID of the static object
+    -- @return An static object, or nil if no unit with this ID was found
+    -------------------------------------
+    function DCSEx.world.getStaticObjectByID(staticID)
+        for coalitionID = 1,2 do
+            for _,s in pairs(coalition.getStaticObjects(coalitionID)) do
+                if DCSEx.dcs.getObjectIDAsNumber(s) == staticID then
+                    return s
+                end
+            end
        end

-        center.x = center.x / #units
-        center.y = center.y / #units
-
-        return center
+        return nil
    end

    -------------------------------------
-    -- Searches and return an unit by its ID
+    -- Searches and returns an unit by its ID
+    -------------------------------------
    -- @param unitID ID of the unit
    -- @return An unit, or nil if no unit with this ID was found
    -------------------------------------
@@ -446,23 +516,34 @@ do
    end

    -------------------------------------
-    -- Searches and return a coalition static object by its ID
-    -- @param unitID ID of the static object
-    -- @return An static object, or nil if no unit with this ID was found
+    -- Returns the 2D center of a number of units
    -------------------------------------
-    function DCSEx.world.getStaticObjectByID(staticID)
-        for coalitionID = 1,2 do
-            for _,s in pairs(coalition.getStaticObjects(coalitionID)) do
-                if DCSEx.dcs.getObjectIDAsNumber(s) == staticID then
-                    return s
-                end
-            end
+    -- @param units A table of units
+    -- @return The 2D point center of all units' positions or 0,0 if no units were found
+    -------------------------------------
+    function DCSEx.world.getUnitsCenter(units)
+        if not units or #units == 0 then return { x = 0, y = 0 } end
+
+        local center = { x = 0, y = 0 }
+        for _,u in pairs(units) do
+            local uPt2 = DCSEx.math.vec3ToVec2(u:getPoint())
+            center.x = center.x + uPt2.x
+            center.y = center.y + uPt2.y
        end

-        return nil
+        center.x = center.x / #units
+        center.y = center.y / #units
+
+        return center
    end

-    -- TODO: description
+    -------------------------------------
+    -- Returns true if a group exists and any of its units are alive, false otherwise
+    -------------------------------------
+    -- @param g A group
+    -- @param unitsMustBeInAir Are units on the ground ignored? (default: false)
+    -- @return True if a group exists and any of its units are alive, false otherwise
+    -------------------------------------
    function DCSEx.world.isGroupAlive(g, unitsMustBeInAir)
        if not g then return false end
        if not g:isExist() then return false end
@@ -484,22 +565,16 @@ do
        return atLeastOneActiveUnit
    end

-    -- TODO: description & file header
+    -------------------------------------
+    -- Sets the health of an unit
+    -------------------------------------
+    -- @param unitID ID of the unit
+    -- @param life Life percentage
+    -------------------------------------
    function DCSEx.world.setUnitLifePercent(unitID, life)
        net.dostring_in("mission", string.format("a_unit_set_life_percentage(%d, %f)", unitID, life))
    end

-    -- TODO: description & file header
-    function DCSEx.world.explodeUnit(unitID, amount)
-        net.dostring_in("mission", string.format("a_explosion_unit(%d, %f)", unitID, amount))
-    end
-
-    function DCSEx.world.destroyGroupByID(groupID)
-        if not groupID then return end
-        local g = DCSEx.world.getGroupByID(groupID)
-        if g then g:destroy() end
-    end
-
    -- function DCSEx.world.destroySceneryInZone(zone, destructionPercent)
    --     destructionPercent = destructionPercent or 0
    --     net.dostring_in("mission", string.format("a_scenery_destruction_zone(%d, %f)", zone.zoneId, destructionPercent))
@@ -518,4 +593,41 @@ do
    -- function DCSEx.world.shellingZone(zone, tnt, shellsCount)
    --     net.dostring_in("mission", string.format("a_shelling_zone(%d, %f, %d)", zone.zoneId, tnt, shellsCount))
    -- end
+
+    -- function DCSEx.world.findSpawnPoint(vec2, minRadius, maxRadius, surfaceType, radiusWithoutScenery, territorySide, expandSearch)
+    --     expandSearch = expandSearch or true
+
+    --     for _=0,16 do
+    --         for _=0,16 do
+    --             local spawnPoint = nil
+
+    --             spawnPoint = DCSEx.math.randomPointInCircle(
+    --                 vec2,
+    --                 DCSEx.converter.nmToMeters(maxRadius),
+    --                 DCSEx.converter.nmToMeters(minRadius),
+    --                 surfaceType)
+
+    --             if spawnPoint and radiusWithoutScenery then
+    --                 if DCSEx.world.collidesWithScenery(spawnPoint, radiusWithoutScenery) then
+    --                     spawnPoint = nil
+    --                 end
+    --             end
+
+    --             if spawnPoint and territorySide then
+    --                 if scramble.territories.getOwner(spawnPoint) ~= territorySide then
+    --                     spawnPoint = nil
+    --                 end
+    --             end
+
+    --             if spawnPoint then return spawnPoint end
+    --         end
+
+    --         if not expandSearch then return nil end
+
+    --         minRadius = minRadius * 0.9
+    --         maxRadius = maxRadius * 1.2
+    --     end
+
+    --     return nil
+    -- end
 end
@@ -1,24 +1,34 @@
 -- ====================================================================================
--  ZONETOOLS - FUNCTIONS RELATED TO MAP TRIGGER ZONES
+-- DCSEX.ZONES - FUNCTIONS RELATED TO MAP TRIGGER ZONES
 -- ====================================================================================
-- DCSEx.zones.drawOnMap(zoneTable, lineColor, fillColor, lineType, drawName, readonly)
+-- DCSEx.zones.drawOnMap(zoneTable, lineColor, fillColor, lineType, drawName, readOnly)
 -- DCSEx.zones.getAll()
 -- DCSEx.zones.getByName(name)
 -- DCSEx.zones.getCenter(zoneTable)
-- DCSEx.zones.getProperty(zoneTable, propertyName)
+-- DCSEx.zones.getProperty(zoneTable, propertyName, defaultValue)
 -- DCSEx.zones.getPropertyBoolean(zoneTable, propertyName, defaultValue)
 -- DCSEx.zones.getPropertyFloat(zoneTable, propertyName, defaultValue, min, max)
 -- DCSEx.zones.getPropertyInt(zoneTable, propertyName, defaultValue, min, max)
 -- DCSEx.zones.getPropertyParse(zoneTable, propertyName, stringTable, valueTable, defaultValue)
 -- DCSEx.zones.getPropertyTable(zoneTable, propertyName)
 -- DCSEx.zones.getRadius(zoneTable, useMaxForQuads)
+-- DCSEx.zones.getRandomPointInside(zoneTable, surfaceType)
 -- DCSEx.zones.getSurfaceArea(zoneTable)
 -- DCSEx.zones.isPointInside(zoneTable, point)
 -- ====================================================================================

 DCSEx.zones = { }

-- TODO: function description
+-------------------------------------
+-- Draws a zone on the F10, visible for all players
+-------------------------------------
+-- @param zoneTable The zone to draw
+-- @param lineColor Line color as a RGBA table
+-- @param fillColor Fill color as a RGBA table
+-- @param lineType Type of line from the DCSEx.enums.lineType enum
+-- @param drawName Should the name of the zone be drawn too (default: false)
+-- @param drawName Should the zone marker be read only? (default: true)
+-------------------------------------
 function DCSEx.zones.drawOnMap(zoneTable, lineColor, fillColor, lineType, drawName, readOnly)
    drawName = drawName or false
    readOnly = readOnly or true
@@ -64,6 +74,7 @@ end

 -------------------------------------
 -- Returns all trigger zones
+-------------------------------------
 -- @return Table of zones
 -------------------------------------
 function DCSEx.zones.getAll()
@@ -79,6 +90,7 @@ end

 -------------------------------------
 -- Finds and return a trigger zone by a certain name
+-------------------------------------
 -- @param name Case-insensitive name of the zone
 -- @return Zone table or nil if no zone with this name was found
 -------------------------------------
@@ -100,6 +112,7 @@ end

 -------------------------------------
 -- Returns the center of a zone
+-------------------------------------
 -- @param zoneTable The zone table, returned by TMMissionData.getZones() or TMMissionData.getZoneByName(name)
 -- @return A vec2
 -------------------------------------
@@ -119,6 +132,7 @@ end

 -------------------------------------
 -- Returns the value of the property of a trigger zone, as a string
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @return The value of the property or nil if it doesn't exist
@@ -141,6 +155,7 @@ end

 -------------------------------------
 -- Returns the value of the property of a trigger zone, parsed against a case-insensitive table of strings
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @param defaultValue Default value to return if no match was found
@@ -157,6 +172,7 @@ end

 -------------------------------------
 -- Returns the value of the property of a trigger zone, as a float
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @param defaultValue Default value to return if no match was found
@@ -174,6 +190,7 @@ end

 -------------------------------------
 -- Returns the value of the property of a trigger zone, as an integer
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @param defaultValue Default value to return if no match was found
@@ -189,6 +206,7 @@ end

 -------------------------------------
 -- Gets the value of a property of a trigger zone and parse it according to two correspondance tables
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @param stringTable A table of strings
@@ -211,6 +229,7 @@ end

 -------------------------------------
 -- Returns the value of the property of a trigger zone, as a table of comma-separated lowercase strings
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param propertyName Case-insensitive name of the property
 -- @return An table
@@ -223,6 +242,7 @@ end

 -------------------------------------
 -- Returns the radius of a zone, in meter
+-------------------------------------
 -- @param zoneTable The zone table, returned by DCSEx.zones.getAll() or DCSEx.zones.getByName(name)
 -- @param useMaxForQuads If true, return largest distance between the center and a vertex. If false (default value), returns the mean distance. Only used if the zone is a quad.
 -- @return An table
@@ -271,6 +291,7 @@ end

 -------------------------------------
 -- Returns the surface area of a zone
+-------------------------------------
 -- @param zoneTable The zone table, returned by TMMissionData.getZones() or TMMissionData.getZoneByName(name)
 -- @return A number, in squared meters
 -------------------------------------
@@ -289,6 +310,7 @@ end

 -------------------------------------
 -- Returns true if a point is inside a zone
+-------------------------------------
 -- @param zoneTable The zone table, returned by TMMissionData.getZones() or TMMissionData.getZoneByName(name)
 -- @param point A point, as a vec3 or vec2
 -- @return True if the point is inside the zone, false otherwise
@@ -561,7 +561,7 @@ Library.aircraft = {
        }
    },
    ["A-50"] = {
-        ["altitude"] = 4898,
+        ["altitude"] = 11000,
        ["speed"] = 220,
        ["payload"] = {
            ["chaff"] = 192,
@@ -2460,7 +2460,7 @@ Library.aircraft = {
        ["pylons"] = {}
    },
    ["E-2C"] = {
-        ["altitude"] = 4510,
+        ["altitude"] = 9000,
        ["speed"] = 133.3,
        ["payload"] = {
            ["chaff"] = 120,
@@ -2479,7 +2479,7 @@ Library.aircraft = {
        ["pylons"] = {}
    },
    ["E-3A"] = {
-        ["altitude"] = 4800,
+        ["altitude"] = 11000,
        ["speed"] = 220,
        ["payload"] = {
            ["chaff"] = 120,
@@ -7567,7 +7567,7 @@ Library.aircraft = {
        }
    },
    ["KJ-2000"] = {
-        ["altitude"] = 4898,
+        ["altitude"] = 11000,
        ["speed"] = 220,
        ["payload"] = {
            ["fuel"] = 70000,
@@ -201,16 +201,17 @@ Library.radioMessages = {
        "$1, off the deck, forming up now."
    },

-    atcRequireNearestAirbase = { -- TODO: voiceover
-        "Roger. Vectoring you to the nearest airbase.\n$1",
-        "Copy. Coordinates to nearest field inbound.\n$1",
-        "Roger. Guide you direct to the nearest recovery airfield.\n$1"
+    atcRequireNearestAirbase = {
+        "Roger. Vectoring you to the nearest airbase.\n\n$1",
+        "Copy. Coordinates to nearest field inbound.\n\n$1",
+        "Roger. Guide you direct to the nearest recovery airfield.\n\n$1"
    },
-    atcWeatherUpdate = { -- TODO: voiceover
-        "Roger. Weather info coming up now.\n$1",
-        "Copy. Weather report inbound.\n$1",
-        "This is control, checking conditions now.\n$1",
-        "Copy. Weather data on the way.\n$1"
+    atcRequireNearestAirbaseNone = "No friendly airbase is available at the moment.",
+    atcWeatherUpdate = {
+        "Roger. Weather info coming up now.\n\n$1",
+        "Copy. Weather report inbound.\n\n$1",
+        "This is control, checking conditions now.\n\n$1",
+        "Copy. Weather data on the way.\n\n$1"
    },
    atcSafeLanding = { "Be advised: $1 is wheels down at $2 and clear of runway.", "All aircraft, $1 has landed at $2 and vacated active. Runway is open for next inbound.", "Traffic, $1 is on deck at $2 and heading to parking. Runway clear.", "All flights, $1 just rolled out at $2 and cleared the active.", "Heads up, $1 landed at $2 and moving to the ramp. Runway available for next approach." },
    atcSafeLandingPlayer = { "$1, wheels on deck, welcome back. You may taxi to the parking area.", "$1, good copy on landing. Exit when able, proceed to the parking area.", "$1, touchdown confirmed. Continue to parking.", "$1, welcome home. Clear of runway and taxi to parking area.", "$1, nice landing. Taxi to parking when ready." },
@@ -306,13 +307,13 @@ Library.radioMessages = {
        "$1, target already marked with smoke."
    },

-    playerATCRequireNearestAirbase = { -- TODO: voiceover
+    playerATCRequireNearestAirbase = {
        "Control, request vectors to nearest suitable base for recovery.",
        "Control, requesting nearest friendly airfield for landing, over.",
        "Control, negative on original destination, request alternate field nearest current position.",
        "Control, requesting location and frequency for closest towered airfield."
    },
-    playerATCWeatherUpdate = { -- TODO: voiceover
+    playerATCWeatherUpdate = {
        "Control, request latest weather update, over.",
        "Control, need current weather and visibility.",
        "Control, what's the weather looking like out there?",
@@ -330,7 +331,6 @@ Library.radioMessages = {
        "Command, mission timeline check, are we on schedule?"
    },

-
    playerCommandRequireObjectives = {
        "Command, request objective $1 coordinates, over.",
        "Command, send me grid for objective $1.",
@@ -9,35 +9,38 @@ TUM.VERSION_STRING = "0.1.250722"

 TUM.DEBUG_MODE = __DEBUG_MODE__

-TUM.logLevel = {
-    INFO = 0,
-    WARNING = 1,
-    ERROR = 2
-}
-
 -------------------------------------
 -- Prints and logs a debug message
 -- @param message The message
-- @param logLevel Is it a warning, error or info messages (as defined in TUM.logLevel). Info messages are not printed out unless debug mode is enabled.
+-- @param logLevel Is it a warning, error or info messages (as defined in TUM.logger.logLevel). Info messages are not printed out unless debug mode is enabled.
 -------------------------------------
+
 function TUM.log(message, logLevel)
-    logLevel = logLevel or TUM.logLevel.INFO
-
-    if logLevel == TUM.logLevel.ERROR then
-        trigger.action.outText("ERROR: "..message, 3600)
-        env.warning("TUM - ERROR: "..message, false)
-    elseif logLevel == TUM.logLevel.WARNING then
-        trigger.action.outText("WARNING: "..message, 10)
-        env.warning("TUM - WARNING: "..message, false)
-    else
-        if TUM.DEBUG_MODE then -- Info messages are only printed out if debug mode is enabled
-            trigger.action.outText(message, 3)
-        end
-
-        env.info("TUM: "..message, false)
-    end
+    logLevel = logLevel or TUM.logger.logLevel.INFO
+    TUM.logger.print(logLevel, message)
 end

+--------------------------------------
+--- Radio menu for the mission commands
+--------------------------------------
+TUM.rootMenu = nil
+function TUM.getOrCreateRootMenu(reset) -- Get or create the root menu for the mission commands; if reset is true, the menu will be cleared and recreated
+    if reset then
+        missionCommands.removeItem(TUM.rootMenu) -- Clear the menu
+        TUM.rootMenu = nil
+        TUM.getOrCreateRootMenu() -- Recreate the root menu
+    end
+    if not TUM.rootMenu then
+        if TUM.administrativeSettings.getValue(TUM.administrativeSettings.USE_SPECIFIC_RADIOMENU) then
+            local rootMenuTitle = "✈ TUM"
+            TUM.rootMenu = missionCommands.addSubMenu(rootMenuTitle)
+        end
+    end
+    return TUM.rootMenu
+end
+
+--------------------------------------
+
 --[[DCS EXTENSIONS]]--

 --[[LIBRARY]]--
@@ -48,118 +51,126 @@ end
 -- Module startup --
 --------------------

-do
-    local function startUpMission()
-        TUM.hasStarted = false
+function TUM.initialize()
+    do
+        TUM.administrativeSettings.onStartUp() -- load the administrative settings

-        local coreSettings = {
-            multiplayer = false
-        }
+        local function startUpMission()
+            TUM.hasStarted = false

-        if not net or not net.dostring_in then
-            TUM.log("Mission failed to execute. Please copy the provided \"autoexec.cfg\" file to the [Saved Games]\\DCS\\Config directory.\nThe file can be downloaded from github.com/akaAgar/the-universal-mission-for-dcs-world", TUM.logLevel.ERROR)
-            return nil
-        end
+            local coreSettings = {
+                multiplayer = false
+            }

-        if #DCSEx.envMission.getPlayerGroups() == 0 then
-            TUM.log("No \"Player\" or \"Client\" aircraft slots have been found. Please fix this problem in the mission editor.", TUM.logLevel.ERROR)
-            return nil
-        end
-
-        if world:getPlayer() then
-            coreSettings.multiplayer = false
-
-            if #DCSEx.envMission.getPlayerGroups() > 1 then
-                TUM.log("Multiple players slots have been found in addition to the single-player \"Player\" aircraft. Please fix this problem in the mission editor.", TUM.logLevel.ERROR)
+            if not net or not net.dostring_in then
+                TUM.log("Mission failed to execute. Please copy the provided \"autoexec.cfg\" file to the [Saved Games]\\DCS\\Config directory.\nThe file can be downloaded from github.com/akaAgar/the-universal-mission-for-dcs-world", TUM.logger.logLevel.ERROR)
                return nil
            end
-        else
-            coreSettings.multiplayer = true
+
+            if #DCSEx.envMission.getPlayerGroups() == 0 then
+                TUM.log("No \"Client\" aircraft slots have been found. Please fix this problem in the mission editor.", TUM.logger.logLevel.ERROR)
+                return nil
+            end
+
+            if world:getPlayer() then
+                TUM.log("A \"Player\" aircraft slot has been found. The Universal Mission only uses \"Client\" slots, even for single-player missions. Please fix this problem in the mission editor.", TUM.logger.logLevel.ERROR)
+                return nil
+            end
+
+            coreSettings.multiplayer = (#DCSEx.envMission.getPlayerGroups() > 1)

            if #DCSEx.envMission.getPlayerGroups(coalition.side.BLUE) == 0 and #DCSEx.envMission.getPlayerGroups(coalition.side.RED) == 0 then
-                TUM.log("Neither BLUE nor RED coalitions have player slots. Please make sure one coalition has player slots in the mission editor.", TUM.logLevel.ERROR)
+                TUM.log("Neither BLUE nor RED coalitions have player slots. Please make sure one coalition has player slots in the mission editor.", TUM.logger.logLevel.ERROR)
                return nil
            end

            if #DCSEx.envMission.getPlayerGroups(coalition.side.BLUE) > 0 and #DCSEx.envMission.getPlayerGroups(coalition.side.RED) > 0 then
-                TUM.log("Both coalitions have player slots. The Universal Mission is a purely singleplayer/PvE experience and does not support PvP. Please make sure only one coalition has player slots in the mission editor.", TUM.logLevel.ERROR)
+                TUM.log("Both coalitions have player slots. The Universal Mission is a purely singleplayer/PvE experience and does not support PvP. Please make sure only one coalition has player slots in the mission editor.", TUM.logger.logLevel.ERROR)
                return nil
            end
+
+            if not TUM.territories.onStartUp() then return nil end
+            if not TUM.settings.onStartUp(coreSettings) then return nil end -- Must be called after TUM.territories.onStartUp()
+            if not TUM.playerCareer.onStartUp() then return nil end
+            if not TUM.intermission.onStartUp() then return nil end
+            if not TUM.airForce.onStartUp() then return nil end
+            if not TUM.mizCleaner.onStartUp() then return nil end -- Must be called after TUM.settings.onStartUp()
+
+            TUM.hasStarted = true
+
+            return coreSettings
        end

-        if not TUM.territories.onStartUp() then return nil end
-        if not TUM.settings.onStartUp(coreSettings) then return nil end -- Must be called after TUM.territories.onStartUp()
-        if not TUM.playerCareer.onStartUp() then return nil end
-        if not TUM.intermission.onStartUp() then return nil end
-        if not TUM.airForce.onStartUp() then return nil end
-        if not TUM.mizCleaner.onStartUp() then return nil end -- Must be called after TUM.settings.onStartUp()
-
-        TUM.hasStarted = true
-
-        return coreSettings
+        if not startUpMission() then
+            trigger.action.outText("A critical error has happened, cannot start the mission.", 3600)
+        end
    end

-    if not startUpMission() then
-        trigger.action.outText("A critical error has happened, cannot start the mission.", 3600)
-    end
-end
+    -------------------
+    -- Event handler --
+    -------------------
+    do
+        local eventHandler = {}

-------------------
-- Event handler --
-------------------
-do
-    local eventHandler = {}
+        function eventHandler:onEvent(event)
+            if not event then return end -- No event

-    function eventHandler:onEvent(event)
-        if not event then return end -- No event
-
-        TUM.ambientRadio.onEvent(event) -- Must be first so other (more important) radio messages will interrupt the "ambient" ones
-        TUM.ambientWorld.onEvent(event)
-        TUM.objectives.onEvent(event)
-        TUM.playerScore.onEvent(event)
-        TUM.mission.onEvent(event)
-        TUM.wingmen.onEvent(event)
-        TUM.mizCleaner.onEvent(event) -- Must be last, can remove units which could cause bugs in other onEvent methods
-    end
-
-    function TUM.onEvent(event)
-        eventHandler:onEvent(event)
-    end
-
-    if TUM.hasStarted then
-        world.addEventHandler(eventHandler)
-    end
-end
-
--------------------------------------------
-- Game clock, called every 10-20 seconds --
--------------------------------------------
-do
-    local clockTick = -1
-
-    function TUM.onClockTick(arg, time)
-        local nextTickTime = time + math.random(10, 20)
-        clockTick = clockTick + 1
-
-        TUM.wingmenTasking.onClockTick() -- No need to check the function return, it's just here to check if wingmen target is still alive
-
-        if clockTick % 4 == 0 then
-            if TUM.playerScore.onClockTick() then return nextTickTime end
-            if TUM.mission.onClockTick() then return nextTickTime end
-        elseif clockTick % 4 == 1 then
-            if TUM.airForce.onClockTick(TUM.settings.getPlayerCoalition()) then return nextTickTime end
-        elseif clockTick % 4 == 2 then
-            if TUM.supportAWACS.onClockTick() then return nextTickTime end
-        else
-            if TUM.airForce.onClockTick(TUM.settings.getEnemyCoalition()) then return nextTickTime end
+            TUM.ambientRadio.onEvent(event) -- Must be first so other (more important) radio messages will interrupt the "ambient" ones
+            TUM.airForce.onEvent(event)
+            TUM.ambientWorld.onEvent(event)
+            TUM.ambientWorld.onEvent(event)
+            TUM.objectives.onEvent(event)
+            TUM.playerScore.onEvent(event)
+            TUM.mission.onEvent(event)
+            TUM.wingmen.onEvent(event)
+            TUM.mizCleaner.onEvent(event) -- Must be last, can remove units which could cause bugs in other onEvent methods
        end

-        if TUM.wingmenContacts.onClockTick() then return nextTickTime end -- Called every tick if no other action has taken place
+        function TUM.onEvent(event)
+            eventHandler:onEvent(event)
+        end

-        return nextTickTime
+        if TUM.hasStarted then
+            world.addEventHandler(eventHandler)
+        end
    end

-    if TUM.hasStarted then
-        timer.scheduleFunction(TUM.onClockTick, nil, timer.getTime() + math.random(10, 15))
+    --------------------------------------------
+    -- Game clock, called every 10-20 seconds --
+    --------------------------------------------
+    do
+        local clockTick = -1
+
+        function TUM.onClockTick(arg, time)
+            local nextTickTime = time + math.random(10, 20)
+            clockTick = clockTick + 1
+
+            TUM.wingmenTasking.onClockTick() -- No need to check the function return, it's just here to check if wingmen target is still alive
+
+            if clockTick % 4 == 0 then
+                if TUM.playerScore.onClockTick() then return nextTickTime end
+                if TUM.mission.onClockTick() then return nextTickTime end
+            elseif clockTick % 4 == 1 then
+                if TUM.airForce.onClockTick(TUM.settings.getPlayerCoalition()) then return nextTickTime end
+            elseif clockTick % 4 == 2 then
+                if TUM.supportAWACS.onClockTick() then return nextTickTime end
+            else
+                if TUM.airForce.onClockTick(TUM.settings.getEnemyCoalition()) then return nextTickTime end
+            end
+
+            if TUM.wingmenContacts.onClockTick() then return nextTickTime end -- Called every tick if no other action has taken place
+
+            return nextTickTime
+        end
+
+        if TUM.hasStarted then
+            timer.scheduleFunction(TUM.onClockTick, nil, timer.getTime() + math.random(10, 15))
+        end
    end
 end
+
+if TUM.administrativeSettings.getValue(TUM.administrativeSettings.INITIALIZE_AUTOMATICALLY) then
+    TUM.initialize()
+else
+    TUM.log("TUM has been loaded, but not initialized. Call TUM.initialize() to start the mission.", TUM.logger.logLevel.INFO)
+end
@@ -1,6 +1,32 @@
 TUM.atc = {}

 do
+    local function getFlyTime(playerUnit, point3)
+        local point2 = DCSEx.math.vec3ToVec2(point3)
+
+        local velocity = playerUnit:getVelocity()
+        local speed = math.max(1, math.sqrt(velocity.x * velocity.x + velocity.y * velocity.y + velocity.z * velocity.z))
+        local distance = DCSEx.math.getDistance2D(point2, DCSEx.math.vec3ToVec2(playerUnit:getPoint()))
+        local timeInMinutes = math.max(1, math.floor(distance / (speed * 60)))
+        local eta = DCSEx.string.getTimeString(timer.getAbsTime() + timeInMinutes * 60)
+        if timeInMinutes > 600 then
+            return "More than ten hours of flight time at current airspeed\n"
+        elseif timeInMinutes > 120 then
+            return tostring(math.floor(timeInMinutes / 60)).." hours of flight time at current airspeed, ETA "..eta.."\n"
+        elseif timeInMinutes < 2 then
+            return "Less than 2 minutes of flight time at current airspeed, ETA "..eta.."\n"
+        else
+            return tostring(timeInMinutes).." minutes of flight time at current airspeed, ETA "..eta.."\n"
+        end
+    end
+
+    local function getTemperatureCelsiusAndFarenheit(temperature, inKelvins)
+        inKelvins = inKelvins or false
+        if inKelvins then temperature = temperature - 273.15 end
+
+        return tostring(math.floor(temperature)).."°C/"..tostring(math.floor(DCSEx.converter.celsiusToFahrenheit(temperature))).."°F"
+    end
+
    function TUM.atc.requestNavAssistanceToObjective(index, delayRadioAnswer)
        local obj = TUM.objectives.getObjective(index)
        if not obj then return end
@@ -12,20 +38,7 @@ do
        for _,p in ipairs(players) do
            -- Give BRA to objective
            local navInfo = "- Fly "..DCSEx.dcs.getBRAA(obj.waypoint3, p:getPoint(), false).."\n"
-
-            -- Give flight time and ETA
-            local velocity = p:getVelocity()
-            local speed = math.max(1, math.sqrt(velocity.x * velocity.x + velocity.y * velocity.y + velocity.z * velocity.z))
-            local distance = DCSEx.math.getDistance2D(obj.waypoint2, DCSEx.math.vec3ToVec2(p:getPoint()))
-            local timeInMinutes = math.max(1, math.floor(distance / (speed * 60)))
-            local eta = DCSEx.string.getTimeString(timer.getAbsTime() + timeInMinutes * 60)
-            if timeInMinutes > 600 then
-                navInfo = navInfo.."- More than ten hours of flight time at current airspeed\n"
-            elseif timeInMinutes > 120 then
-                navInfo = navInfo.."- "..tostring(math.floor(timeInMinutes / 60)).." hours of flight time at current airspeed, ETA "..eta.."\n"
-            else
-                navInfo = navInfo.."- "..tostring(timeInMinutes).." minute(s) of flight time at current airspeed, ETA "..eta.."\n"
-            end
+            navInfo = navInfo.."- "..getFlyTime(p, obj.waypoint3) -- Give flight time and ETA

            -- Give objective coordinates
            if obj.preciseCoordinates then
@@ -35,20 +48,20 @@ do
            end
            navInfo = navInfo..DCSEx.world.getCoordinatesAsString(obj.waypoint3, false)

-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "commandObjectiveCoordinates"..msgIDSuffix, { obj.name, navInfo }, "Command", delayRadioAnswer)
+            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "commandObjectiveCoordinates"..msgIDSuffix, { obj.name, navInfo }, "Command", delayRadioAnswer, nil, nil, 2.5)
        end
    end

-    function TUM.atc.requireNearestAirbase(delayRadioAnswer)
+    function TUM.atc.requestNavAssistanceToAirbase(delayRadioAnswer)
        local players = coalition.getPlayers(TUM.settings.getPlayerCoalition())
        for _,p in ipairs(players) do
-            local airbaseInfo = "- No airbase available near you at the moment." -- TODO: proper "no airbase" message
+            local airbaseInfo = nil -- Mark as nil, in case no valid airbase is found

            local validAirbaseTypes = { Airbase.Category.AIRDROME }
            if p:hasAttribute("Helicopters") then table.insert(validAirbaseTypes, Airbase.Category.HELIPAD) end
            local pDesc = p:getDesc()
            if pDesc.LandRWCategories and #pDesc.LandRWCategories > 0 then
-                -- TODO: check player unit description to filter compatible carrier types
+                -- TODO: check player unit description to filter compatible carrier types (Harrier/helos can land anywhere, naval fighters can land on carriers, etc)
                table.insert(validAirbaseTypes, Airbase.Category.SHIP)
            end

@@ -57,32 +70,78 @@ do
                allAirbases = DCSEx.dcs.getNearestObjects(DCSEx.math.vec3ToVec2(p:getPoint()), allAirbases)

                for i=1,#allAirbases do
-                    local abDesc = airbaseInfo[i]:getDesc()
+                    local abDesc = allAirbases[i]:getDesc()

                    if DCSEx.table.contains(validAirbaseTypes, abDesc.category) then
-                        airbaseInfo = abDesc.displayName
-                        break
+                        local abPoint = allAirbases[i]:getPoint()
+
+                        if abDesc.category == Airbase.Category.AIRDROME then
+                            airbaseInfo = abDesc.displayName:upper().." AIRBASE:\n"
+                        else -- Helipad or ship
+                            airbaseInfo = abDesc.displayName:upper()..":\n"
+                        end
+                        airbaseInfo = airbaseInfo.."- Fly "..DCSEx.dcs.getBRAA(abPoint, p:getPoint(), false).."\n"
+                        airbaseInfo = airbaseInfo.."- "..getFlyTime(p, abPoint).."\n"
+                        airbaseInfo = airbaseInfo..DCSEx.world.getCoordinatesAsString(abPoint, false)
+
+                        local runways = allAirbases[i]:getRunways()
+                        if #runways > 0 then
+                            airbaseInfo = airbaseInfo.."\n\nRunways: "
+                            for j=1,#runways do
+                                -- Compute the runway course (in degrees, divided by 10)
+                                local courseDeg = math.floor(DCSEx.converter.radiansToDegrees(runways[j].course * -1))
+                                if courseDeg < 0 then courseDeg = courseDeg + 360 end
+                                if courseDeg >= 360 then courseDeg = courseDeg - 360 end
+                                courseDeg = math.floor(courseDeg / 10)
+
+                                -- Compute the opposite runway coursecourseDegNeg
+                                local courseDegNeg = courseDeg + 18
+                                if courseDegNeg >= 36 then courseDegNeg = courseDegNeg - 36 end
+
+                                -- Make sure the lowest runway heading is displayed first
+                                if courseDeg > courseDegNeg then
+                                    local tmp = courseDegNeg
+                                    courseDegNeg = courseDeg
+                                    courseDeg = tmp
+                                end
+
+                                airbaseInfo = airbaseInfo..tostring(courseDeg).."/"..tostring(courseDegNeg).." ("..tostring(math.floor(runways[j].length)).." m)"
+                                if j < #runways then airbaseInfo = airbaseInfo..", " end
+                            end
+                        end
+                        -- TODO: radio tower frequency?
+
+                        break -- Stop after finding one
                    end
                end
            end

-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "atcRequireNearestAirbase", { airbaseInfo }, "Control", delayRadioAnswer)
+            if airbaseInfo then
+                TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "atcRequireNearestAirbase", { airbaseInfo }, "Control", delayRadioAnswer, nil, false, 2.5)
+            else
+                TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "atcRequireNearestAirbaseNone", nil, "Control", delayRadioAnswer)
+            end
        end
    end

    function TUM.atc.requestWeatherUpdate(delayRadioAnswer)
-        local weatherInfo = "- It is currenly "..DCSEx.string.getTimeString()
+        local commonWeatherInfo = "- It is currenly "..DCSEx.string.getTimeString()
        if Library.environment.isItNightTime() then
-            weatherInfo = weatherInfo.." (night, sunrise at "..DCSEx.string.getTimeString(Library.environment.getDayTime(nil, false))..")\n"
+            commonWeatherInfo = commonWeatherInfo.." (night, sunrise at "..DCSEx.string.getTimeString(Library.environment.getDayTime(nil, false))..")\n"
        else
-            weatherInfo = weatherInfo.." (day, sunset at "..DCSEx.string.getTimeString(Library.environment.getDayTime(nil, true))..")\n"
+            commonWeatherInfo = commonWeatherInfo.." (day, sunset at "..DCSEx.string.getTimeString(Library.environment.getDayTime(nil, true))..")\n"
        end

-        weatherInfo = weatherInfo.."- Average windspeed is "..tostring(DCSEx.floor(Library.environment.getWindAverage())).."m/s\n"
-
        local players = coalition.getPlayers(TUM.settings.getPlayerCoalition())
        for _,p in ipairs(players) do
-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "atcWeatherUpdate", { weatherInfo }, "Control", delayRadioAnswer)
+            local lTemperature, _ = atmosphere.getTemperatureAndPressure(p:getPoint())
+
+            local localWeatherInfo = "- Average windspeed is "..tostring(math.floor(Library.environment.getWindAverage())).."m/s\n"
+            localWeatherInfo = localWeatherInfo.."- Windspeed at your location is "..DCSEx.math.getLength3D(atmosphere.getWind(p:getPoint())).."m/s\n"
+            localWeatherInfo = localWeatherInfo.."- Average ground-level temperature is "..getTemperatureCelsiusAndFarenheit(env.mission.weather.season.temperature).."\n"
+            localWeatherInfo = localWeatherInfo.."- Temperature at your location is "..getTemperatureCelsiusAndFarenheit(lTemperature, true)
+
+            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(p), "atcWeatherUpdate", { commonWeatherInfo..localWeatherInfo }, "Control", delayRadioAnswer)
        end
    end
 end
@@ -0,0 +1,87 @@
+-- ====================================================================================
+--  TUM.ADMINISTRATIVESETTINGS - HANDLE ADMINISTRATIVE SETTINGS
+-- ====================================================================================
+-- (enum) TUM.administrativeSettings
+-- TUM.administrativeSettingsDefaultValues
+-- TUM.administrativeSettingsValues
+-- TUM.administrativeSettings.getValue(key)
+-- TUM.administrativeSettings.onStartUp()
+-- TUM.administrativeSettings.setValue(key, value)
+-- ====================================================================================
+
+TUM.administrativeSettings = {
+    -- This table defines the administrative settings for the script.
+    -- These settings can modify the behavior of the script, and can be set by the mission maker via a specific trigger zone's parameters, or via script (defining the TUM.administrativeSettingsValues below)
+    USE_SPECIFIC_RADIOMENU = 1,     -- Use a specific radio menu for the mission commands, or use the main one?
+    INITIALIZE_AUTOMATICALLY = 2,   -- Automatically initialize the mission when the script is loaded. If false, you must call TUM.initialize() manually.
+    IGNORE_ZONES_STARTINGWITH = 3,  -- If set, ignore all zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names.
+    ONLY_ZONES_STARTINGWITH = 4,    -- If set, only adds zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names.
+}
+
+TUM.administrativeSettingsDefaultValues = {
+    -- This table defines the default values for the administrative settings.
+    -- The keys must match the keys in TUM.administrativeSettings
+    [TUM.administrativeSettings.USE_SPECIFIC_RADIOMENU] = false,    -- Use a specific radio menu for the mission commands, or use the main one?
+    [TUM.administrativeSettings.INITIALIZE_AUTOMATICALLY] = true,   -- Automatically initialize the mission when the script is loaded. If false, you must call TUM.initialize() manually.
+    [TUM.administrativeSettings.IGNORE_ZONES_STARTINGWITH] = nil,   -- If set, ignore all zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names.
+    [TUM.administrativeSettings.ONLY_ZONES_STARTINGWITH] = nil,     -- If set, only adds zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names.
+}
+
+TUM.administrativeSettingsValues = {
+    -- This table defines the administrative settings values for the script.
+    -- The keys must match the keys in TUM.administrativeSettings
+    -- If set, these values will prevail over both the default values in TUM.administrativeSettings and the values set by the mission maker via a specific trigger zone's parameters.
+}
+
+--- Returns the value of the administrative setting with the given key
+function TUM.administrativeSettings.getValue(key)
+    if TUM.administrativeSettingsValues[key] ~= nil then
+        return TUM.administrativeSettingsValues[key]
+    else
+        return TUM.administrativeSettingsDefaultValues[key]
+    end
+end
+
+--- Takes all the values from (in order of priority):
+---     1. The TUM.administrativeSettingsValues table (optionnaly set by script)
+---     2. The trigger zone parameters (set by the mission maker)
+---     3. The TUM.administrativeSettingsDefaultValues table (default values)
+function TUM.administrativeSettings.onStartUp()
+    local ADMIN_ZONE_NAME = "TUM_Administrative_Settings"  -- The name of the administrative settings trigger zone
+    local adminZone = DCSEx.zones.getByName(ADMIN_ZONE_NAME)
+
+    for key, _ in pairs(TUM.administrativeSettings) do
+        local value = nil
+        if TUM.administrativeSettingsValues[TUM.administrativeSettings[key]] then -- Check if the value is set by script
+            value = TUM.administrativeSettingsValues[TUM.administrativeSettings[key]]
+        end
+        if value == nil and adminZone then -- If the value is not set by script, check the trigger zone parameters
+            local zoneValue = DCSEx.zones.getProperty(adminZone, key)
+            if zoneValue ~= nil then
+                value = zoneValue
+            end
+        end
+        if value == nil then -- If the value is not set by script or trigger zone, use the default value
+            value = TUM.administrativeSettingsDefaultValues[TUM.administrativeSettings[key]]
+        end
+        TUM.administrativeSettingsValues[TUM.administrativeSettings[key]] = value
+    end
+end
+
+--- Sets the value of the administrative setting with the given key
+function TUM.administrativeSettings.setValue(key, value)
+    -- check if the key is in the administrative settings table
+    local foundKey = false
+    for _, v in pairs(TUM.administrativeSettings) do
+        if v == key then
+            foundKey = true
+            break
+        end
+    end
+    if not foundKey then
+        TUM.log("Tried to set an unknown administrative setting: "..tostring(key), TUM.logger.logLevel.ERROR)
+        return nil
+    end
+
+    TUM.administrativeSettingsValues[key] = value
+end
@@ -6,9 +6,13 @@
 TUM.airForce = {}

 do
+    local SUPPRESSION_INCREASE_ON_KILL = 0.35 -- Value added to enemyCAPSuppression each time an enemy aircraft is shot down
+
    local desiredUnitCount = { 4, 4 } -- Desired max number of aircraft in the air at any single time
    local fighterGroups = { {}, {} }

+    local enemyCAPSuppression = 1
+    local enemyCAPSuppressionTimer = 1
    local playerCenter = nil

    local function getSkillLevel(side)
@@ -65,7 +69,7 @@ do
    local function launchNewAircraftGroup(side, airbases)
        local groupSize = DCSEx.table.getRandom({ 1, 2, 2, 2, 2, 3, 3, 4 })
        groupSize = math.min(groupSize, desiredUnitCount[side] - getAirborneUnitCount(side))
-        if groupSize <= 0 then return false end
+        if groupSize <= 0 then return false end -- No aircraft slots left

        local faction = TUM.settings.getEnemyFaction()
        if side == TUM.settings.getPlayerCoalition() then faction = TUM.settings.getPlayerFaction() end
@@ -73,6 +77,17 @@ do
        local units = Library.factions.getUnits(faction, DCSEx.enums.unitFamily.PLANE_FIGHTER, groupSize, true)
        if not units or #units == 0 then return false end -- No aircraft found

+        -- If enemy CAP suppression timer > 0, decrement it by 1 but don't spawn any aircraft
+        if side == TUM.settings.getEnemyCoalition() then
+            enemyCAPSuppressionTimer = enemyCAPSuppressionTimer - 1
+            if enemyCAPSuppressionTimer > 0 then
+                TUM.log("Enemy CAP is still suppressed (suppression="..tostring(enemyCAPSuppressionTimer).."), no enemy CAP spawned.")
+                return false
+            end
+
+            enemyCAPSuppressionTimer = enemyCAPSuppression
+        end
+
        local launchAirbase = airbases[DCSEx.math.clamp(math.random(1, math.ceil(math.sqrt(#airbases))), 1, #airbases)]
        local originPt = DCSEx.math.vec3ToVec2(launchAirbase:getPoint())

@@ -150,7 +165,6 @@ do
                    randomizeDesiredAircraftCount(side)
                end

-                -- return launchNewAircraftGroup(side, airbases)
                return launchNewAircraftGroup(side, validAirbases)
            end
        end
@@ -170,6 +184,23 @@ do
        return updateAirForce(side)
    end

+    -------------------------------------
+    -- Called when an event is raised
+    -- @param event The DCS World event
+    -------------------------------------
+    function TUM.airForce.onEvent(event)
+        if not event.initiator then return end
+        if Object.getCategory(event.initiator) ~= Object.Category.UNIT then return end
+        if event.id ~= world.event.S_EVENT_UNIT_LOST then return end
+
+        local groupID = DCSEx.dcs.getGroupIDAsNumber(event.initiator:getGroup())
+
+        if DCSEx.table.contains(fighterGroups[TUM.settings.getEnemyCoalition()], groupID) then
+            enemyCAPSuppression = enemyCAPSuppression + SUPPRESSION_INCREASE_ON_KILL
+            TUM.log("Enemy CAP suppression increased to "..tostring(enemyCAPSuppression))
+        end
+    end
+
    function TUM.airForce.create()
        TUM.airForce.removeAll()
        TUM.log("Creating friendly and enemy air forces...")
@@ -190,6 +221,10 @@ do
            end
        end

+        -- Reset enemy CAP suppression
+        enemyCAPSuppression = 1
+        enemyCAPSuppressionTimer = 1
+
        fighterGroups = { {}, {} }
    end

@@ -94,7 +94,7 @@ do
    function TUM.debugMenu.createMenu()
        if not TUM.DEBUG_MODE then return end

-        local rootMenu = missionCommands.addSubMenu("[DEBUG]")
+        local rootMenu = missionCommands.addSubMenu("[DEBUG]", TUM.getOrCreateRootMenu())
        missionCommands.addCommand("Detonate - BOOM map markers", rootMenu, doMarkersBoom, nil)
        missionCommands.addCommand("Detonate - AIRBOOM map markers", rootMenu, doMarkersAirBoom, nil)
        missionCommands.addCommand("Wingman - kill", rootMenu, doKillWingman, nil)
@@ -109,7 +109,7 @@ do
                    if addAirDefenseGroup(side, faction, unitFamily, point) then
                        realCount = realCount + 1
                    else
-                        TUM.log("Failed to add point air defense group near objective "..TUM.objectives.getObjective(i).name..".", TUM.logLevel.WARNING)
+                        TUM.log("Failed to add point air defense group near objective "..TUM.objectives.getObjective(i).name..".", TUM.logger.logLevel.WARNING)
                    end
                end
            end
@@ -134,7 +134,7 @@ do
            if addAirDefenseGroup(side, faction, unitFamily, point) then
                realCount = realCount + 1
            else
-                TUM.log("Failed to add local air defense group.", TUM.logLevel.WARNING)
+                TUM.log("Failed to add local air defense group.", TUM.logger.logLevel.WARNING)
            end
        end

@@ -154,7 +154,7 @@ do
            if addAirDefenseGroup(side, faction, DCSEx.enums.unitFamily.AIRDEFENSE_MANPADS, point) then
                realCount = realCount + 1
            else
-                TUM.log("Failed to add local MANPADS group.", TUM.logLevel.WARNING)
+                TUM.log("Failed to add local MANPADS group.", TUM.logger.logLevel.WARNING)
            end
        end

@@ -10,31 +10,6 @@ TUM.intermission = {}
 do
    local missionZonesMarkers = {}

-    local function doCommandStartMission()
-        local players = DCSEx.world.getAllPlayers()
-
-        if #players == 0 then
-            trigger.action.outText("No player slots occupied. At least one client slot must be occupied by a player to start the mission.", 5)
-            trigger.action.outSound("UI-Error.ogg")
-            return
-        end
-
-        if not TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then
-            for _,p in ipairs(players) do
-                if p:inAir() then
-                    trigger.action.outText("Cannot start a single player mission while the player is in the air. Please land before starting the mission.", 5)
-                    trigger.action.outSound("UI-Error.ogg")
-                    return
-                end
-            end
-        end
-
-        trigger.action.outText("Generating mission and loading assets, this can take some time...", 5)
-
-        -- Add a little delay for the "Generating mission..." message be printed out. Once generation begins, the main DCS thread will be to busy to output anything.
-        timer.scheduleFunction(TUM.mission.beginMission, false, timer.getTime() + 1)
-    end
-
    local function setSetting(args)
        if not args.id or not args.value then return end

@@ -74,6 +49,32 @@ do
        end
    end

+    function TUM.intermission.doCommandStartMission(allowEvenInAir)
+        allowEvenInAir = allowEvenInAir or false
+        local players = DCSEx.world.getAllPlayers()
+
+        if #players == 0 then
+            trigger.action.outText("No player slots occupied. At least one client slot must be occupied by a player to start the mission.", 5)
+            trigger.action.outSound("UI-Error.ogg")
+            return
+        end
+
+        if not allowEvenInAir and not TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then
+            for _,p in ipairs(players) do
+                if p:inAir() then
+                    trigger.action.outText("Cannot start a single player mission while the player is in the air. Please land before starting the mission.", 5)
+                    trigger.action.outSound("UI-Error.ogg")
+                    return
+                end
+            end
+        end
+
+        trigger.action.outText("Generating mission and loading assets, this can take some time...", 5)
+
+        -- Add a little delay for the "Generating mission..." message be printed out. Once generation begins, the main DCS thread will be to busy to output anything.
+        timer.scheduleFunction(TUM.mission.beginMission, false, timer.getTime() + 1)
+    end
+
    function TUM.intermission.removeMissionZonesMarkers()
        for _,id in ipairs(missionZonesMarkers) do
            trigger.action.removeMark(id)
@@ -86,7 +87,7 @@ do
    -- Creates the mission briefing menu
    -------------------------------------
    function TUM.intermission.createMenu()
-        missionCommands.removeItem() -- Clear the menu
+        local rootMenu = TUM.getOrCreateRootMenu(true) -- Clear the menu

        local briefingText = "Welcome to The Universal Mission for DCS World, a highly customizable mission available for single-player and PvE.\n\nOpen the communication menu and select the ''F10. Other'' option to access mission settings."
        DCSEx.envMission.setBriefing(coalition.side.RED, briefingText)
@@ -94,9 +95,9 @@ do

        TUM.intermission.createMissionZonesMarkers() -- Show the available mission zones on the F10 map

-        missionCommands.addCommand("ℹ Display mission settings", nil, TUM.settings.printSettingsSummary, false)
+        missionCommands.addCommand("ℹ Display mission settings", rootMenu, TUM.settings.printSettingsSummary, false)

-        local settingsMenu = missionCommands.addSubMenu("✎ Change mission settings")
+        local settingsMenu = missionCommands.addSubMenu("✎ Change mission settings", rootMenu)
        createSubMenu(TUM.settings.id.COALITION_BLUE, settingsMenu)
        createSubMenu(TUM.settings.id.COALITION_RED, settingsMenu)
        createSubMenu(TUM.settings.id.TASKING, settingsMenu)
@@ -107,7 +108,7 @@ do
        createSubMenu(TUM.settings.id.WINGMEN, settingsMenu)
        createSubMenu(TUM.settings.id.AI_CAP, settingsMenu)
        TUM.playerCareer.createMenu()
-        missionCommands.addCommand("➤ Begin mission", nil, doCommandStartMission, nil)
+        missionCommands.addCommand("➤ Begin mission", rootMenu, TUM.intermission.doCommandStartMission, false)
        TUM.debugMenu.createMenu() -- Append debug menu to other menus (if debug mode enabled)
    end

@@ -0,0 +1,140 @@
+-- ====================================================================================
+-- TUM.LOGGER - LOGS WARNINGS, ERRORS AND DEBUG INFO
+-- ====================================================================================
+-- (enum) TUM.logger.
+-- TUM.logger.debug(text, ...)
+-- TUM.logger.error(text, ...)
+-- TUM.logger.formatText(text, ...)
+-- TUM.logger.info(text, ...)
+-- TUM.logger.print(level, text)
+-- TUM.logger.splitText(text)
+-- TUM.logger.trace(text, ...)
+-- TUM.logger.warn(text, ...)
+-- ====================================================================================
+
+TUM.logger = {}
+
+TUM.logger.logLevel = {
+    TRACE = -2,
+    DEBUG = -1,
+    INFO = 0,
+    WARNING = 1,
+    ERROR = 2
+}
+
+function TUM.logger.debug(text, ...)
+    if TUM.DEBUG_MODE then
+        text = TUM.logger.formatText(text, arg)
+        TUM.logger.print(TUM.logger.logLevel.DEBUG, text)
+    end
+end
+
+function TUM.logger.error(text, ...)
+    text = TUM.logger.formatText(text, arg)
+    local mText = text
+    if debug and debug.traceback then
+        mText = mText .. "\n" .. debug.traceback()
+    end
+    TUM.logger.print(TUM.logger.logLevel.ERROR, mText)
+end
+
+function TUM.logger.formatText(text, ...)
+    if not text then
+        return ""
+    end
+    if type(text) ~= 'string' then
+        text = TUM.p(text)
+    else
+        local args = ...
+        if args and args.n and args.n > 0 then
+            local pArgs = {}
+            for i=1,args.n do
+                pArgs[i] = TUM.p(args[i])
+            end
+                text = text:format(unpack(pArgs))
+            end
+        end
+    local fName = nil
+    local cLine = nil
+    if debug and debug.getinfo then
+        local dInfo = debug.getinfo(3)
+        fName = dInfo.name
+        cLine = dInfo.currentline
+        -- local fsrc = dinfo.short_src
+        --local fLine = dInfo.linedefined
+    end
+    if fName and cLine then
+        return fName .. '|' .. cLine .. ': ' .. text
+    elseif cLine then
+        return cLine .. ': ' .. text
+    else
+        return ' ' .. text
+    end
+end
+
+function TUM.logger.info(text, ...)
+    text = TUM.logger.formatText(text, arg)
+    TUM.logger.print(TUM.logger.logLevel.INFO, text)
+end
+
+function TUM.logger.print(level, text)
+    local texts = TUM.logger.splitText(text)
+    local levelChar = 'E'
+    local logFunction = function(messageForLogfile, messageForUser)
+        trigger.action.outText("ERROR: "..messageForUser, 3600)
+        env.error(messageForLogfile)
+    end
+    if level == TUM.logger.logLevel.WARNING then
+        levelChar = 'W'
+        logFunction = function(messageForLogfile, messageForUser)
+            trigger.action.outText("WARNING: "..messageForUser, 10)
+            env.warning(messageForLogfile)
+        end
+    elseif level == TUM.logger.logLevel.INFO then
+        levelChar = 'I'
+        logFunction = function(messageForLogfile, messageForUser)
+            if TUM.DEBUG_MODE then -- Info messages are only printed out if debug mode is enabled
+                trigger.action.outText(messageForUser, 3)
+            end
+            env.info(messageForLogfile)
+        end
+    elseif level == TUM.logger.logLevel.DEBUG then
+        levelChar = 'D'
+        logFunction = env.info
+    elseif level == TUM.logger.logLevel.TRACE then
+        levelChar = 'T'
+        logFunction = env.info
+    end
+    for i = 1, #texts do
+        if i == 1 then
+            local theText =  'TUM|' .. levelChar .. '|' .. texts[i]
+            logFunction(theText, texts[i])
+        else
+            local theText = texts[i]
+            logFunction(theText, theText)
+        end
+    end
+end
+
+function TUM.logger.splitText(text)
+    local tbl = {}
+    while text:len() > 4000 do
+        local sub = text:sub(1, 4000)
+        text = text:sub(4001)
+        table.insert(tbl, sub)
+    end
+    table.insert(tbl, text)
+    return tbl
+end
+
+function TUM.logger.trace(text, ...)
+    if TUM.DEBUG_MODE then
+        text = TUM.logger.formatText(text, arg)
+        TUM.logger.print(TUM.logger.logLevel.TRACE, text)
+    end
+end
+
+function TUM.logger.warn(text, ...)
+    text = TUM.logger.formatText(text, arg)
+    TUM.logger.print(TUM.logger.logLevel.WARNING, text)
+end
@@ -67,7 +67,7 @@ do
        end

        if TUM.objectives.getCount() == 0 then
-            TUM.log("Couldn't create any objective, mission creation failed.", TUM.logLevel.WARNING)
+            TUM.log("Couldn't create any objective, mission creation failed.", TUM.logger.logLevel.WARNING)
            closeMission(true)
            return
        end
@@ -107,7 +107,7 @@ do
    end

    function TUM.mission.getPlayerCallsign()
-        local player = world.getPlayer()
+        local player = DCSEx.world.getFirstPlayer(TUM.settings.getPlayerCoalition())
        if player then return player:getCallsign() end
        return "Flight"
    end
@@ -193,10 +193,20 @@ do
    -- @param event The DCS World event
    -------------------------------------
    function TUM.mission.onEvent(event)
-        if missionStatus == TUM.mission.status.NONE then return end
        if not event.initiator then return end
-        if Object.getCategory(event.initiator) ~= Object.Category.UNIT then return end
-        if not event.initiator:getPlayerName() then return end
+        if Object.getCategory(event.initiator) ~= Object.Category.UNIT then return end -- Initiator is not an unit
+        if not event.initiator:getPlayerName() then return end -- Initiator is not a player
+
+        -- Start mission (it wasn't started yet) when all players have taken off
+        if event.id == world.event.S_EVENT_TAKEOFF then
+            if missionStatus == TUM.mission.status.NONE and #DCSEx.world.getPlayersOnGround(TUM.settings.getPlayerCoalition()) == 0 then
+                TUM.intermission.doCommandStartMission(true)
+                -- Force wingman spawning because the "on player takeoff spawn wingman" function won't be called as mission wasn't started yet when the "take off" even was raised
+                timer.scheduleFunction(TUM.wingmen.create, nil, timer.getTime() + 3)
+            end
+        end
+
+        if missionStatus == TUM.mission.status.NONE then return end

        -- All objectives complete and all players on the ground? Mission is complete
        if event.id == world.event.S_EVENT_RUNWAY_TOUCH or event.id == world.event.S_EVENT_PLAYER_ENTER_UNIT or event.id == world.event.S_EVENT_PLAYER_LEAVE_UNIT then
@@ -205,11 +215,14 @@ do
            end
        end

-        if TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then return end
-
-        -- When player dies in single-player, fail the mission
-        if event.id == world.event.S_EVENT_CRASH or event.id == world.event.S_EVENT_EJECTION or event.id == world.event.S_EVENT_PILOT_DEAD then
-            TUM.mission.endMission(TUM.mission.endCause.FAILED)
+        -- When the player dies in single-player, remind them that they can respawn
+        -- (because no one knows the "respawn" shortcut key in DCS and it's not possible to respawn by
+        -- changing slots when there's only one)
+        if not TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then
+            if event.id == world.event.S_EVENT_CRASH or event.id == world.event.S_EVENT_EJECTION or event.id == world.event.S_EVENT_PILOT_DEAD then
+                -- TUM.mission.endMission(TUM.mission.endCause.FAILED)
+                trigger.action.outText("Your aircraft has been downed.\nPress Right CTRL+Right Shift+Tab (default) to respawn.", 10)
+            end
        end
    end

@@ -17,7 +17,7 @@ do

    local function doCommandNearestAirbase()
        TUM.radio.playForCoalition(TUM.settings.getPlayerCoalition(), "playerATCRequireNearestAirbase", nil, TUM.mission.getPlayerCallsign(), false)
-        TUM.atc.requestNavAssistanceToAirbase(false)
+        TUM.atc.requestNavAssistanceToAirbase(true)
    end

    local function doCommandObjectiveLocation(index)
@@ -30,17 +30,17 @@ do

    local function doCommandWeatherUpdate()
        TUM.radio.playForCoalition(TUM.settings.getPlayerCoalition(), "playerATCWeatherUpdate", nil, TUM.mission.getPlayerCallsign(), false)
-        TUM.atc.requestWeatherUpdate(false)
+        TUM.atc.requestWeatherUpdate(true)
    end

    function TUM.missionMenu.create()
-        missionCommands.removeItem() -- Clear the menu
-        missionCommands.addCommand("☱ Mission status", nil, doCommandMissionStatus, nil)
+        local rootMenu = TUM.getOrCreateRootMenu(true) -- Clear the menu
+        missionCommands.addCommand("☱ Mission status", rootMenu, doCommandMissionStatus, nil)

-        local objectivesMenuRoot = missionCommands.addSubMenu("❖ Objectives")
-        local navigationMenuRoot = missionCommands.addSubMenu("➽ Navigation")
-        -- missionCommands.addCommand("Nav to nearest airbase", navigationMenuRoot, doCommandNearestAirbase, nil)
+        local objectivesMenuRoot = missionCommands.addSubMenu("❖ Objectives", rootMenu)

+        local navigationMenuRoot = missionCommands.addSubMenu("➽ Navigation", rootMenu)
+        missionCommands.addCommand("Nav to nearest airbase", navigationMenuRoot, doCommandNearestAirbase, nil)
        for i=1,TUM.objectives.getCount() do
            local obj = TUM.objectives.getObjective(i)
            if obj then
@@ -51,16 +51,16 @@ do
                missionCommands.addCommand("Nav to objective "..objNameAndDescription, navigationMenuRoot, doCommandObjectiveLocation, i)
            end
        end
-        -- missionCommands.addCommand("Weather update", navigationMenuRoot, doCommandWeatherUpdate, nil)
+        missionCommands.addCommand("Weather update", navigationMenuRoot, doCommandWeatherUpdate, nil)

        TUM.wingmenMenu.create()
        TUM.supportAWACS.createMenu()

        if not TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then -- If not multiplayer, add "show mission score" command
-            missionCommands.addCommand("★ Display mission score", nil, TUM.playerScore.showScore, nil)
+            missionCommands.addCommand("★ Display mission score", rootMenu, TUM.playerScore.showScore, nil)
        end

-        local abortRoot = missionCommands.addSubMenu("⬣ Abort mission")
+        local abortRoot = missionCommands.addSubMenu("⬣ Abort mission", rootMenu)
        if not TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) and DCSEx.io.canReadAndWrite() then
            missionCommands.addCommand("✓ Confirm (all xp since last landing will be lost!)", abortRoot, doCommandAbortMission, nil)
        else
@@ -55,7 +55,7 @@ do
                local u = DCSEx.world.getUnitByID(id)
                if u then u:destroy() end
            end
-            TUM.log("Removed "..tostring(#aiWingMenToRemove).." AI wingmen from the mission.\nPlease do not add AI wingmen to the mission, The Universal Mission uses its own wingman system.", TUM.logLevel.WARNING)
+            TUM.log("Removed "..tostring(#aiWingMenToRemove).." AI wingmen from the mission.\nPlease do not add AI wingmen to the mission, The Universal Mission relies on its own wingman system.", TUM.logger.logLevel.WARNING)
        end
    end

@@ -25,7 +25,7 @@ do
        local objective = TUM.objectivesMaker.create()

        if not objective then
-            TUM.log("Failed to spawn a group for objective #"..tostring(#objectives + 1)..".", TUM.logLevel.WARNING)
+            TUM.log("Failed to spawn a group for objective #"..tostring(#objectives + 1)..".", TUM.logger.logLevel.WARNING)
            return false
        end

@@ -46,7 +46,7 @@ do

        local taskID = pickRandomTask()
        if not taskID then
-            TUM.log("Failed to find a valid task.", TUM.logLevel.WARNING)
+            TUM.log("Failed to find a valid task.", TUM.logger.logLevel.WARNING)
            return nil
        end
        local objectiveDB = Library.tasks[taskID]
@@ -58,7 +58,7 @@ do
        if DCSEx.table.contains(objectiveDB.flags, DCSEx.enums.taskFlag.SCENERY_TARGET) then
            local validSceneries = DCSEx.world.getSceneriesInZone(zone, DCSEx.zones.getRadius(zone), 250)
            if not validSceneries or #validSceneries == 0 then
-                TUM.log("Failed to find a valid scenery object to use as target.", TUM.logLevel.WARNING)
+                TUM.log("Failed to find a valid scenery object to use as target.", TUM.logger.logLevel.WARNING)
                return nil
            end

@@ -76,7 +76,7 @@ do
        end

        if not spawnPoint2 then
-            TUM.log("Failed to find a spawn point for objective.", TUM.logLevel.WARNING)
+            TUM.log("Failed to find a spawn point for objective.", TUM.logger.logLevel.WARNING)
            return nil
        end

@@ -132,11 +132,11 @@ do
                    groupInfo.unitsID = { DCSEx.unitGroupMaker.createStatic(TUM.settings.getEnemyCoalition(), objective.point2, units[1], "") }
                end
            else
-                groupInfo = DCSEx.unitGroupMaker.create(TUM.settings.getEnemyCoalition(), DCSEx.dcs.getUnitTypeFromFamily(objectiveDB.targetFamilies[1]), objective.point2, units, groupOptions)
+                groupInfo = DCSEx.unitGroupMaker.create(TUM.settings.getEnemyCoalition(), DCSEx.dcs.getUnitCategoryFromFamily(objectiveDB.targetFamilies[1]), objective.point2, units, groupOptions)
            end

            if not groupInfo then
-                TUM.log("Failed to spawn a group for objective.", TUM.logLevel.WARNING)
+                TUM.log("Failed to spawn a group for objective.", TUM.logger.logLevel.WARNING)
                return nil
            end
            objective.groupID = groupInfo.groupID
@@ -146,10 +146,11 @@ do
    -- Appends the career menu to the F10 menu. Only works in single-player missions
    -------------------------------------
    function TUM.playerCareer.createMenu()
+        local rootMenu = TUM.getOrCreateRootMenu()
        if not DCSEx.io.canReadAndWrite() then return end -- IO disabled, career and scoring disabled
        if TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then return end -- No career in multiplayer

-        missionCommands.addCommand("✪ View pilot career stats", nil, TUM.playerCareer.displayMedalBox, true)
+        missionCommands.addCommand("✪ View pilot career stats", rootMenu, TUM.playerCareer.displayMedalBox, true)
    end

    -------------------------------------
@@ -273,7 +274,7 @@ do
            msg = msg.."To enable the IO module, comment or remove the \"sanitizeModule('io')\" line in \n"
            msg = msg.."[DCSWorld installation directory]\\Scripts\\MissionScripting.lua and restart the game."

-            TUM.log(msg, TUM.logLevel.WARNING)
+            TUM.log(msg, TUM.logger.logLevel.WARNING)
        end

        return true
@@ -50,7 +50,7 @@ do
        end
        message = DCSEx.string.firstToUpper(message)

-        local duration = DCSEx.string.getReadingTime(message)
+        local duration = DCSEx.string.getReadingTime(message) * args.displayTimeMultiplier

        -- Print message
        trigger.action.outTextForUnit(args.unitID, callsign:upper()..": "..message, duration, false)
@@ -73,12 +73,13 @@ do
    -- @param delayed Should the message be delayed (used for message answers)
    -- @param functionToRun Function to run when the message is played
    -- @param functionParameters Parameters for the function to run when the message is played
+    -- @param displayTimeMultiplier Multiplier for how long the message should be displayed (2.0=twice as long, 0.5=half as long). Default is 1.0
    -------------------------------------
-    function TUM.radio.playForAll(messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+    function TUM.radio.playForAll(messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        local players = DCSEx.world.getAllPlayers()

        for _, unit in pairs(players) do
-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(unit), messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(unit), messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        end
    end

@@ -91,12 +92,13 @@ do
    -- @param delayed Should the message be delayed (used for message answers)
    -- @param functionToRun Function to run when the message is played
    -- @param functionParameters Parameters for the function to run when the message is played
+    -- @param displayTimeMultiplier Multiplier for how long the message should be displayed (2.0=twice as long, 0.5=half as long). Default is 1.0
    -------------------------------------
-    function TUM.radio.playForCoalition(coalitionID, messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+    function TUM.radio.playForCoalition(coalitionID, messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        local players = coalition.getPlayers(coalitionID)

        for _,u in pairs(players) do
-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(u), messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(u), messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        end
    end

@@ -109,13 +111,14 @@ do
    -- @param delayed Should the message be delayed (used for message answers)
    -- @param functionToRun Function to run when the message is played
    -- @param functionParameters Parameters for the function to run when the message is played
+    -- @param displayTimeMultiplier Multiplier for how long the message should be displayed (2.0=twice as long, 0.5=half as long). Default is 1.0
    -------------------------------------
-    function TUM.radio.playForGroup(groupID, messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+    function TUM.radio.playForGroup(groupID, messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        local group = DCSEx.world.getGroupByID(groupID)
        if not group then return end -- group does not exist

        for _,u in pairs(group:getUnits()) do
-            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(u), messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+            TUM.radio.playForUnit(DCSEx.dcs.getObjectIDAsNumber(u), messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        end
    end

@@ -129,8 +132,9 @@ do
    -- @param delayed Should the message be delayed (used for message answers)
    -- @param functionToRun Function to run when the message is played
    -- @param functionParameters Parameters for the function to run when the message is played
+    -- @param displayTimeMultiplier Multiplier for how long the message should be displayed (2.0=twice as long, 0.5=half as long). Default is 1.0
    -------------------------------------
-    function TUM.radio.playForUnit(unitID, messageID, replacements, callsign, delayed, functionToRun, functionParameters)
+    function TUM.radio.playForUnit(unitID, messageID, replacements, callsign, delayed, functionToRun, functionParameters, displayTimeMultiplier)
        if not messageID then return end
        if not Library.radioMessages[messageID] then return end
        delayed = delayed or false
@@ -141,6 +145,7 @@ do

        local radioArgs = {
            callsign = callsign,
+            displayTimeMultiplier = math.max(0.1, displayTimeMultiplier or 1.0),
            functionToRun = functionToRun,
            functionParameters = functionParameters,
            messageID = messageID,
@@ -91,8 +91,9 @@ do

    function TUM.supportAWACS.createMenu()
        if not awacsGroupID then return end -- No AWACS
+        local rootMenu = TUM.getOrCreateRootMenu()

-        local rootPath = missionCommands.addSubMenu("⌾ Awacs")
+        local rootPath = missionCommands.addSubMenu("⌾ Awacs", rootMenu)
        missionCommands.addCommand("Bogey dope", rootPath, doCommandBogeyDope, nil)
        missionCommands.addCommand("Picture", rootPath, doCommandPicture, nil)
    end
@@ -131,7 +132,7 @@ do
                end
                TUM.log("Spawned AWACS aircraft")
            else
-                TUM.log("Failed to create AWACS aircraft", TUM.logLevel.WARNING)
+                TUM.log("Failed to create AWACS aircraft", TUM.logger.logLevel.WARNING)
            end
        else
            TUM.log("No AWACS aircraft available")
@@ -125,7 +125,27 @@ do
            elseif DCSEx.string.startsWith(z.name:lower(), "water") then
                table.insert(waterZones, z)
            else
-                table.insert(missionZones, z)
+                local onlyZonesStartingWith = TUM.administrativeSettings.getValue(TUM.administrativeSettings.ONLY_ZONES_STARTINGWITH)
+                if onlyZonesStartingWith and #onlyZonesStartingWith > 0 then
+                    if type(onlyZonesStartingWith) ~= "table" then
+                        onlyZonesStartingWith = { onlyZonesStartingWith }
+                    end
+                    for _, zonePrefix in ipairs(onlyZonesStartingWith) do
+                        if DCSEx.string.startsWith(z.name:lower(), zonePrefix:lower()) then
+                            table.insert(missionZones, z)
+                            break
+                        end
+                    end
+                else
+                    local ignoreZonesStartingWith = TUM.administrativeSettings.getValue(TUM.administrativeSettings.IGNORE_ZONES_STARTINGWITH)
+                    if ignoreZonesStartingWith then
+                        if not DCSEx.string.startsWith(z.name:lower(), ignoreZonesStartingWith:lower()) then
+                            table.insert(missionZones, z)
+                        end
+                    else
+                        table.insert(missionZones, z)
+                    end
+                end
            end
        end

@@ -135,18 +155,18 @@ do
                local zoneName = "BLUFOR"
                if side == 1 then zoneName = "REDFOR" end

-                TUM.log("Coalition "..name.." has no territory zones and/or controls no airfields. Please add zone with a name starting with "..zoneName.." in the mission editor and make sure at least one contains an airbase.", TUM.logLevel.ERROR)
+                TUM.log("Coalition "..name.." has no territory zones and/or controls no airfields. Please add zone with a name starting with "..zoneName.." in the mission editor and make sure at least one contains an airbase.", TUM.logger.logLevel.ERROR)
                return false
            end
        end

        if #missionZones == 0 then
-            TUM.log("No mission zones found. Create at least one mission zone in the mission editor.", TUM.logLevel.ERROR)
+            TUM.log("No mission zones found. Create at least one mission zone in the mission editor.", TUM.logger.logLevel.ERROR)
            return false
        end

        if #missionZones > 10 then
-            TUM.log("Too many mission zones, extra zones removed.", TUM.logLevel.WARNING)
+            TUM.log("Too many mission zones, extra zones removed.", TUM.logger.logLevel.WARNING)
            while #missionZones > 10 do
                table.remove(missionZones, 11)
            end
@@ -157,10 +177,10 @@ do
        -- zones[coalition.side.RED] = DCSEx.zones.getByName("REDFOR")

        -- if not zones[coalition.side.BLUE] then
-        --     TUM.log("BLUFOR zone not found.", TUM.logLevel.ERROR)
+        --     TUM.log("BLUFOR zone not found.", TUM.logger.logLevel.ERROR)
        --     return false
        -- elseif not zones[coalition.side.RED] then
-        --     TUM.log("REDFOR zone not found.", TUM.logLevel.ERROR)
+        --     TUM.log("REDFOR zone not found.", TUM.logger.logLevel.ERROR)
        --     return false
        -- end

@@ -48,7 +48,7 @@ do
        -- Retrive player unit type
        local playerTypeName = player:getTypeName()
        if not Library.aircraft[playerTypeName] then
-            TUM.log("Cannot spawn AI wingmen, aircraft \""..playerTypeName.."\" not found in the database.", TUM.logLevel.WARNING)
+            TUM.log("Cannot spawn AI wingmen, aircraft \""..playerTypeName.."\" not found in the database.", TUM.logger.logLevel.WARNING)
            return
        end
        local playerCategory = Group.Category.AIRPLANE
@@ -88,7 +88,7 @@ do
        )

        if not groupInfo then
-            TUM.log("Failed to spawn AI wingmen", TUM.logLevel.WARNING)
+            TUM.log("Failed to spawn AI wingmen", TUM.logger.logLevel.WARNING)
            return
        end
        wingmenGroupID = groupInfo.groupID
@@ -180,6 +180,8 @@ do
        elseif event.id == world.event.S_EVENT_LAND then -- Remove wingmen on player landing
            if not event.initiator:getPlayerName() then return end
            TUM.wingmen.removeAll()
+        elseif event.id == world.event.S_EVENT_PLAYER_ENTER_UNIT then -- Remove wingmen when player takes control of a new unit
+            TUM.wingmen.removeAll()
        end
    end

@@ -75,11 +75,12 @@ do
    end

    function TUM.wingmenMenu.create()
+        local rootMenu = TUM.getOrCreateRootMenu()
        if TUM.settings.getValue(TUM.settings.id.MULTIPLAYER) then return end -- No wingmen in multiplayer
        if TUM.settings.getValue(TUM.settings.id.WINGMEN) <= 1 then return end -- No wingmen
        local isWW2 = (TUM.settings.getValue(TUM.settings) == DCSEx.enums.timePeriod.WORLD_WAR_2) -- Some options are different when time period is WW2

-        local rootPath = missionCommands.addSubMenu("✈ Flight")
+        local rootPath = missionCommands.addSubMenu("✈ Flight", rootMenu)
        missionCommands.addCommand("Cover me!", rootPath, radioCommandCoverMe, nil)

        ------------------------------------------------------
@@ -137,7 +138,9 @@ do
        -- "Change altitude" submenu
        ------------------------------------------------------
        local altitudePath = missionCommands.addSubMenu("Change altitude", rootPath)
-        local baseAltitude = DCSEx.converter.metersToFeet(Library.aircraft[world.getPlayer():getTypeName()].altitude)
+        local player = DCSEx.world.getFirstPlayer(TUM.settings.getPlayerCoalition())
+        local baseAltitude = DCSEx.converter.metersToFeet(10000)
+        if player then baseAltitude = DCSEx.converter.metersToFeet(Library.aircraft[player:getTypeName()].altitude) end
        local altitudeFactions = { 0, 0.25, 0.5, 0.75, 1.0, 1.25, 1.5 }
        for _,f in ipairs(altitudeFactions) do
            local altText = DCSEx.string.toStringThousandsSeparator(math.floor((baseAltitude * f) / 100) * 100).."ft"
@@ -29,7 +29,7 @@ do
    end

    local function getAltitude()
-        local player = world.getPlayer()
+        local player = DCSEx.world.getFirstPlayer(TUM.settings.getPlayerCoalition())
        if not player then return 600 end -- Don't care about altitude if player's dead anyway

        local altitude = Library.aircraft[player:getTypeName()].altitude * cruiseAltitudeFraction
@@ -133,10 +133,16 @@ do
    local function getRejoinTaskTable(formationDistance)
        formationDistance = formationDistance or 800

+        local player = DCSEx.world.getFirstPlayer(TUM.settings.getPlayerCoalition())
+        local groupID = 1
+        if player then
+            groupID = DCSEx.dcs.getObjectIDAsNumber(player:getGroup()) or 1
+        end
+
        return {
            id = "Follow",
            params = {
-                groupId = DCSEx.dcs.getObjectIDAsNumber(world.getPlayer():getGroup()),
+                groupId = groupID,
                lastWptIndexFlag  = false,
                lastWptIndex = -1,
                pos = { x = -formationDistance, y = 0, z = -formationDistance }
@@ -0,0 +1,196 @@
+<!------------------------- NEW PAGE ------------------------->
+<div style="text-align:center">
+<img style="width:100%" src="docs/logo.png" alt="The Universal Mission for DCS World" />
+<p class="heavy" style="font-size:175%;">
+User's manual
+</p>
+<p class="heavy">
+The Universal Mission v0.3.250914<br />
+Created and maintained by Ambroise Garel (<a href='mailto:akaagarmail@gmail.com'>akaagarmail@gmail.com</a>)
+</p>
+<p class="heavy">
+<a href='https://github.com/akaAgar/the-universal-mission-for-dcs-world'>github.com/akaAgar/the-universal-mission-for-dcs-world</a><br />
+</p>
+</div>
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<h2>Table of contents</h2>
+<ul>
+<li><a href="#page_welcome">Welcome to <em>The Universal Mission</em></a></li>
+<li><a href="#page_howtoplay">How to use/play The Universal Mission?</a></li>
+<li><a href="#page_menumission">Using the mission menu</a></li>
+<li><a href="#page_advancedstuff">Advanced stuff you may want to try</a></li>
+<li><a href="#page_multiplayer">A few notes regarding multiplayer</a></li>
+</ul>
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<div id="page_welcome"></div>
+<h2>Welcome to <em>The Universal Mission</em></h2>
+
+_The Universal Mission for DCS World_ is an attempt to create a fully dynamic single-player/PvE mission giving access to the whole content of DCS World in a structure similar to the one found in old "simulators", like the early Microprose games (think F-117 or the Strike Eagle serie).
+
+These game had both fun and clear objectives, endless replayability and a career system that made sure that something was at stake: crash and die, and you'll lose all these hard-earned medals.
+
+As the original creator of [_Briefing Room for DCS World_](https://github.com/DCS-BR-Tools/briefing-room-for-dcs) (now maintained by the talented John Harvey), I've always wanted to create an easy-to-use, enticing and fun mission generator for DCS, capable of creating CPU-light missions without requiring an external program.
+
+I think _The Universal Mission_ is, finally, the proper way to approach this problem. The current version is still an early beta but most core features are already working.
+
+I hope you'll like it.
+
+<h3>Features</h3>
+
+- Can generate any kind of mission: ground attack, interception, strike, airbase attack, CAS, CAP, and more
+- Completely dynamic, no two missions are ever the same
+- Entirely self-contained inside a .miz file, no need for any external program
+- More than 325 voiced radio messages for immersive and realistic coms
+- Supports both single-player and small-scale PvE on closed servers
+- Persistent single player career mode, with awards and promotions. Dying won't reset your progress, but you have to come back to base alive for your kills and completed objectives to be saved to your profile, so watch out for SAMs on your way home
+- All new AI wingman system, smarter and more immersive than DCS's original wingmen
+- Uses advanced DCS World scripting functionalities (like the brand new Disposition singleton and net.dostring_in hacks) to achieve effects seldom seen in other scripts, such as graphic overlays and random but realistic placement of units in cities and forests without the use of handmade spawn points
+- Various little details to make the DCS World more alive, like crew running away from destroyed vehicles
+
+<h3>Limitations of current beta version</h3>
+
+- The current version supports only modern (post-Cold War) units and Caucasus, Kola, Marianas, Persian Gulf and Syria theaters
+  - Germany support will come soon, others will follow later
+- Not all mission types are supported yet
+- Career progress may be lost because of future updates, don't get too attached to it
+
+<h3>Known bugs</h3>
+- AWACS datalink info is now displayed on SA pages
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<div id="page_howtoplay"></div>
+<h2>How to use/play The Universal Mission?</h2>
+
+<h3>First setup</h3>
+
+- Download the latest release from this GitHub page.
+- Copy the provided autoexec.cfg file to your **[Saved Games]\DCS\Config directory**
+  - Please note: as of DCS 2.9.18.12899, it seems the autoexec.cfg file [is no longer needed](https://www.digitalcombatsimulator.com/en/news/changelog/release/2.9.18.12899/) but I advise you to copy it anyway, ED might change its mind again.
+- Copy the .miz files for your theater(s) of choice to your **[Saved Games]\DCS\Missions directory**
+- _**(Optional but strongly recommended)**_ Unsanitize the Lua IO module. You don't have to do this, but the persistent career system won't work if you don't. To do it, open the file **[DCS World installation directory]\Scripts\MissionScripting.lua** with a text editor and comment or remove the line "sanitizeModule('io')". Make sure you restart DCS World once you've modified the file.
+  - Please note: should you want to backup, delete or transfer it, career progress is saved in **[DCS World installation directory]\TheUniversalMission.sav**
+
+<h3>Customizing the mission to your taste</h3>
+
+- _**(Optional but you'll probably want to do it)**_ Open the .miz file in the DCS World mission editor and change the player unit to pick your desired aircraft. The default player unit is a Su-25T (as it is the only free DCS airplane equipped with weapons) and you probably won't want to stick with it.
+
+Please refer to the "Advanced stuff you may want to try" section to learn all the ways you can customize The Universal Mission.
+
+<h3>Starting the mission</h3>
+
+- Launch the mission from the mission editor or the "Mission" selection in the main DCS World menu
+- You are now on the ramp or runway. Open the communication menu (see "Using the mission menu" below) and navigate to the F10/Other menu. From there, you can view and change mission settings. They include:
+  - Who belong to the blue and red coalitions
+  - The type of mission
+  - The number and location of targets (you can use the F10 map to see where the available target zones are located).
+  - The amount of enemy air force and air defense. The higher these settings, the more XP you'll recieve upon completion of a single-player mission
+- When you're ready, pick the "Begin mission" option, wait a few seconds (precaching all the game assets can take some time, especially if you have a slow CPU), you're ready to go!
+- Use the F10 mission and check the F10 map for additional information about the mission (see "Using the mission menu" below). Don't forget to come back to base alive, all awarded XP and completed objectives will only be saved to your pilot profile once you've landed
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<div id="page_menumission"></div>
+<h2>Using the mission menu</h2>
+
+Most features of The Universal Mission require the use of the "F10. Other" menu. To access it, press the "Communication menu" key (check the key bindings), navigate to the root menu by pressing F11 ("Previous menu") if need, then press "F10" to access the "Other" menu.
+The exact content of the menu will depend on the current phase of the mission.
+
+<h3>On startup/when no mission is active</h3>
+
+- **Display mission settings**: Displays the current mission settings, that will be applied if you choose to start the mission now.
+- **Change mission settings**: Allows you to change the mission settings to your taste.
+  - **Blue coalition**: Who is the blue coalition? Determines the type of units that will be spawned. Available factions (e.g. NATO) depend on the missions's time period and theater.
+  - **Red coalition**: Who is the red coalition? Determines the type of units that will be spawned. Available factions (e.g. USSR) depend on the missions's time period and theater.
+  - **Mission type**: What will your mission be?
+    - **Antiship strike**: Sink enemy warships and cargo ships.
+    - **Ground attack**: Interdiction missions against armor, artillery and convoys.
+    - **Interception**: Shoot down strategic airplanes (bombers, transports...) and enemy attack planes on interdiction missions.
+    - **SEAD**: Destroy enemy SAM sites.
+    - **Strike**: Destroy enemy structures and civilian buildings occupied by enemy forces.
+  - **Target location**: Where on the map will the targets be spawned? Approximate distance to possible regions is displayed in the menu.
+    - Missions taking place in enemy territory award 30% more XP to account for increased SAM threat and proximity of enemy airbases.
+    - Make sure to pick a region not too far away from your starting location if you don't like long ingresses.
+    - Picking a region very close to your starting location (for instance, the one where your airbase is located in) can also be a bad idea, as you might takeoff in range of an enemy SAM.
+    - Be aware that targets of antiship strikes will always be spawned in open seas, which can be quite far if you picked a landlocked target zone.
+  - **Target count**: How many objectives will be spawned. More objectives means potentially more xp in a single sortie, so better medals, but also more work and more risk. Be aware that you can RTB to rearm/refuel at any time between objectives, but you won't accumulate as many single-sortie XP as if you complete objectives without going back to base, because XP is awarded to your profile and reset each time you land.
+  - **Enemy air defense**: Amount, quality and skill of enemy surface-to-air units (AAA, MANPADS and SAM). A higher setting awards more XP.
+  - **Enemy air force**: Amount, quality and skill of enemy combat air patrols. A higher setting awards more XP.
+  - **Wingmen count**: How many wingmen will fly by your side (from zero to three). A small XP penalty is added for each additional wingman. Wingman won't get replaced if they get shot during a mission, but they will (with full payload) each time you land and takeoff again. Only shown in single-player missions.
+  - **Friendly AI CAP**: Should AI fighter aicraft be spawned regularly to patrol the AO and shoot down potential threats? Disabling this option will award you more XP (only if "Enemy air force" is not set to "None") but also means you and your wingmen will be alone against the whole enemy air force.
+- **View pilot career stats**: Displays a list of your achievements, as well as your medal case. Only available when playing single-player missions and if the Lua IO module has been unsanitized (see "First setup" above)
+- **Begin mission**: Starts a mission with the current settings.
+
+<h3>Other parameters</h3>
+
+- _(Not yet implemented in this version)_ By changing the year in mission time parameters, the time period will be changed accordingly and the proper factions and AI units will be spawned during the mission. Time periods are:
+  - 1945 and before: World War 2
+  - 1946-1959: Korea War
+  - 1960-1974: Vietnam War
+  - 1975-1989: Late Cold War
+  - 1990-now: Modern
+- _(Not yet implemented in this version)_ Changing the weather to make it more cloudy or windy, or setting the mission to nighttime, will make the mission more difficult but also award more points.
+
+<h3>During the mission</h3>
+
+- **Mission status**: Displays a summary of the mission's status (list of objectives and progress on each objective).
+- **Objectives**: Displays a list of special commands related to each of the mission's objectives. Be aware that some objectives may have no special commands associated with them.
+  - **Smoke marker on target**: Asks for a friendly JTAC to pop a smoke marker on the target. Makes finding the target easier, but will cost you a small XP penalty. Only available for missions where a JTAC is available (it's pretty hard to throw a smoke grenade at an airplane or a ship in the middle of the sea).
+- **Navigation**: Displays a list of commands related to navigational assistance.
+  - **Navigation to nearest airbase**: Displays the coordinates of the nearest friendly airbase, its BRA ("fly X for Y") relative to the player's position and an estimated flight time and ETA.
+  - **Navigation to objective [OBJECTIVE NAME]**: Displays the coordinates of the objective, its BRA ("fly X for Y") relative to the player's position and an estimated flight time and ETA. Some objectives types (e.g. strike missions) are provided with exact coordinates, but most will only have approximate coordiantes, so you'll have to search for targets yourself once in the objective area.
+  - **Weather update**: Displays information about the weather (wind speed, temperature...) at the player location.
+- **Flight**: Displays a list of commands for your wingmen. Only shown in single-player missions and if wingmen are available for this mission.
+  - **Cover me!**: Tasks your wingmen to immediately engage any nearby air threats.
+  - **Engage**: Tasks your wingmen to engage a certain type of targets. Targets must be detected by your wingmen (see "Report contacts" below), or they won't be able to engage them.
+  - **Report contacts**: Asks your wingmen for a list of all detected contacts. According to range and sensors capabilities, their reports can go from perfect ID (e.g. "Su-27") to very generic descriptions (e.g. "fighter" or even "aircraft")
+  - **Hold position**: Tasks your wingmen to orbit at their current position. All other tasking will be aborted.
+  - **Change altitude**: Asks your wingmen to change their altitude. This altitude will be employed when attacking on orbiting but not when rejoining/forming up with you (in that case, they'll match your altitude).
+  - **Status report**: Asks your wingmen for a complete report (damage sustained, fuel status, available payload).
+  - **Rejoin**: Asks your wingmen to rejoin and follow you. All other tasking will be aborted. This is the default tasking when wingmen take off and when they complete another task.
+- **AWACS**: Displays a list of commands for the AWACS. Only shown if an AWACS aircraft is available for this mission.
+  - **Bogey dope**: Asks for the nearest enemy air threat
+  - **Picture**: Asks for a summary of all detected enemy aircraft
+- **Display mission score**: Displays the number of XP gained and objectives completed since your last takeoff. They will be added to your flight log (and any promotions/medals be awarded) the next time you land. If you crash, eject or abort the mission, all currently "stowed" XP and objectives will be lost. Only available when playing single-player missions and if the Lua IO module has been unsanitized (see "First setup" above)
+- **Abort mission**: Aborts the current mission and forfeit all XP/objectives gained since last landing. The game will ask for confirmation so you don't select this option by mistake.
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<div id="page_advancedstuff"></div>
+<h2>Advanced stuff you may want to try</h2>
+
+The Universal Mission is designed to be easily editable to suit your preferences. Here are a few things you could do after opening the .miz file in DCS World's mission editor.
+
+<h3>Player aircraft</h3>
+
+- Change the player aircraft starting condition (runway, parking or parking hot). Air starts are not recommended as all players must be on the ground to begin a new mission
+- Move it to another airbase, change its coalition (make sure blue players are spawned on an airbase located in a BLUFOR zone are red players are spawned on an airbase located in a REDFOR zone)
+  - You may also add an aircraft carrier or a FARP for the player to take off from
+- Change its default loadout if you plan to play a specific kind of mission and don't want to lose time asking the ground crew to rearm your aircraft (e.g. if you know you want to play SEAD missions, you may as well stock up on AGM-88s)
+- Add other aircraft to create a multiplayer mission to play with your friends. Keep in mind that the persistent career/player stats system will be disabled in multiplayer missions and that all player aircraft must belong to the same coalition (TUM does not support PvP)
+
+<h3>Zones</h3>
+
+- All zones whose names starts with BLUFOR or REDFOR decide the territory (and airbases) controlled by the blue and red coalitions
+  - Be aware that any change to the airbases coalitions will be superseded by the BLUFOR and REFOR zones
+- All zones whose names starts with WATER are seas, used to spawn ships
+- Zones with a name not starting with BLUFOR, REDFOR or WATER are target zones. These are zones where objectives can be spawned, who can be selected in the "objective location" setting of the intermission F10 menu
+  - Change, add or remove zones to create new possible target areas. A maximum of 10 target areas can be created, so they fit the F10 menu
+
+<div style="page-break-after: always;"></div>
+<!------------------------- NEW PAGE ------------------------->
+
+<div id="page_multiplayer"></div>
+<h2>A few notes regarding multiplayer</h2>
+
+While The Universal Mission supports multiplayer and is perfectely suitable (and fun!) for playing with friends on a private server, it is **absolutely not suited for public servers** as missions settings can be edited by anyone at any time Using the mission menu.
+Please also note that PvP is not supported at the moment and that the mission will not launch if both coalitions have player slots.
@@ -0,0 +1,159 @@
+{
+  "displayName": "Germany Cold War",
+
+  "dcsID": "GermanyCW",
+
+  "mapCenter": [-185764.56195212, -700000],
+  "mapZoom": 825958.7020649,
+
+  "dateTime": {
+    "day": 1,
+    "month": 6,
+    "year": 2010,
+    "hour": 9,
+    "minute": 0
+  },
+
+  "temperature": 20,
+
+  "airbasesIDs": [
+    1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25,
+    26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48,
+    49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71,
+    72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94,
+    95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113,
+    114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131,
+    132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149,
+    150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167,
+    168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185,
+    186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203,
+    204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221,
+    222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239,
+    240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255
+  ],
+
+  "bullseye": {
+    "blue": [-175892.0672249, -516165.19174041],
+    "red": [-263207.70144319, -729262.53687316]
+  },
+
+  "player": {
+    "airdromeID": 107,
+    "coordinates": [-213558.34375, -675577]
+  },
+
+  "territories": {
+    "blue": [
+      [
+        [-486980.39467552, -1075457.2271386],
+        [-118130.83715339, -637699.11504425],
+        [-34827.002345132, -609852.50737463],
+        [-55593.963997049, -1038879.0560472]
+      ],
+      [
+        [-236596.91384956, -663657.81710914],
+        [-141493.6690118, -590737.46312684],
+        [-105387.47432153, -632507.37463127],
+        [-409812.25308259, -1001828.9085546]
+      ],
+      [
+        [-570737.46312684, -715575.22123894],
+        [-343735.55691741, -749557.52212389],
+        [-227374.63126844, -748141.59292035],
+        [-493805.30973451, -1099056.0471976]
+      ],
+      [
+        [-448844.43584661, -767964.60176991],
+        [-314331.16151033, -711799.4100295],
+        [-266109.53472566, -672678.25972862],
+        [-248049.94676106, -785324.93965782]
+      ]
+    ],
+    "red": [
+      [
+        [-103952.80235988, -627315.63421829],
+        [-269616.51917404, -402418.87905605],
+        [23716.814159291, -412566.37168142],
+        [-27020.648967553, -604660.76696165]
+      ],
+      [
+        [-251209.43952802, -680176.99115044],
+        [-395870.20648968, -508849.55752212],
+        [-237758.1120944, -401946.90265487],
+        [-133687.31563422, -582241.8879056]
+      ],
+      [
+        [-409835.3584123, -745309.73451327],
+        [-428908.55457227, -607020.64896755],
+        [-295103.24483776, -493746.31268437],
+        [-260691.65833628, -668389.10758702]
+      ]
+    ]
+  },
+
+  "water": [
+    [
+      [-28849.557522124, -1063185.840708],
+      [-1474.9262536873, -772684.36578171],
+      [86312.684365782, -786371.68141593],
+      [31563.421828909, -1088436.5781711]
+    ],
+    [
+      [-18938.053097345, -545899.70501475],
+      [41002.949852507, -482182.89085546],
+      [24719.764011799, -537404.12979351],
+      [-17286.135693215, -612920.3539823]
+    ],
+    [
+      [5840.7079646018, -553923.30383481],
+      [39351.032448378, -397463.12684366],
+      [68377.581120944, -395811.20943953],
+      [39587.020648968, -537404.12979351]
+    ]
+  ],
+
+  "targetZones": {
+    "Berlin": [
+      [-229395.01555967, -531485.76918785],
+      [-259421.10835878, -447931.26582763],
+      [-200456.21860007, -435636.45902688],
+      [-188385.2142356, -489175.57499588]
+    ],
+    "Fassberg": [
+      [-247191.58418879, -813059.75504425],
+      [-221545.92330383, -637203.79469027],
+      [-123542.8620649, -678649.01451327],
+      [-219485.11126844, -867327.80530973]
+    ],
+    "Hamburg": [
+      [-126211.54521994, -771032.44837758],
+      [-80429.834305488, -609852.50737463],
+      [-3969.657314338, -644070.79646018],
+      [-104972.60716685, -806902.65486726]
+    ],
+    "Leipzig": [
+      [-348235.75989842, -658154.69330028],
+      [-364451.04063155, -542876.3175586],
+      [-284030.66324113, -539864.77631412],
+      [-264392.49441197, -624589.44754851]
+    ],
+    "Neubrandenburg": [
+      [-85867.341455633, -586901.83936957],
+      [-151457.6531, -426123.7738649],
+      [-33365.345967059, -405301.45270796],
+      [-198.36298135891, -516552.14003219]
+    ],
+    "Ramstein": [
+      [-541345.29186423, -1007397.2292776],
+      [-536064.48212853, -833130.50799962],
+      [-371982.17962653, -887258.80779051],
+      [-404232.83908382, -1012112.2379702]
+    ],
+    "Wiitstock": [
+      [-202970.05962823, -596596.27265076],
+      [-178043.23620461, -508945.97506878],
+      [-122770.71470005, -507184.84080515],
+      [-96489.172612102, -584810.22027111]
+    ]
+  }
+}
@@ -0,0 +1,35 @@
+html,
+body {
+  background-color: white;
+  color: black;
+  font-family: Garamond, Georgia, "Times New Roman", Times, serif;
+  font-size: 1em;
+}
+
+h2 {
+  background-color: black;
+  color: white;
+  font-family: "Courier New", Courier, monospace;
+  font-weight: bold;
+  padding: 0.2rem;
+}
+
+h3 {
+  background-color: dimgray;
+  color: white;
+  font-family: "Courier New", Courier, monospace;
+  font-weight: bold;
+  padding: 0.2rem;
+}
+
+a {
+  background-color: transparent;
+  color: dimgray;
+  text-decoration: none;
+  border-bottom: 1px dotted dimgray;
+}
+
+.heavy {
+  font-family: "Courier New", Courier, monospace;
+  font-weight: bold;
+}
Author	SHA1	Message	Date
Ambroise Garel	2eee4320d3	Updated README	2025-09-14 15:39:25 +02:00
Ambroise Garel	2d0503e44e	Updated README	2025-09-14 15:39:03 +02:00
Ambroise Garel	e0a2612572	Updated manual and README for version 0.3.250914	2025-09-14 15:36:07 +02:00
Ambroise Garel	e357040865	Removed unused zones from the autoexec.cfg	2025-09-14 15:28:32 +02:00
Ambroise Garel	67d71334f9	Support for "Cold War Germany" theater	2025-09-14 14:55:32 +02:00
Ambroise Garel	ffcbbd0402	Merge branch 'germany-theater'	2025-09-14 14:44:04 +02:00
Ambroise Garel	638985b86c	Fixed wrong filename in "enemy infantry killed" messages	2025-09-14 14:18:40 +02:00
Ambroise Garel	b8b5611e32	Added voiceovers for "vector to airbase" and "weather report" calls	2025-09-14 14:17:56 +02:00
Ambroise Garel	3af259f048	Added "Give weather report" radio command	2025-09-14 12:12:25 +02:00
Ambroise Garel	104fee86e9	Added DCSEx.math.getLength3D(vec3)	2025-09-14 12:06:55 +02:00
Ambroise Garel	d5577ac551	Removed unused string key	2025-09-14 11:54:23 +02:00
Ambroise Garel	5f220884bd	Added "Vector me to nearest airbase" ATC command	2025-09-14 11:37:01 +02:00
Ambroise Garel	e522d110bb	Added atcRequireNearestAirbaseNone	2025-09-14 11:09:04 +02:00
Ambroise Garel	64bde651c3	Enemy CAP respawn rate now decreases the more enemy planes are shot	2025-09-11 12:28:10 +02:00
Ambroise Garel	a9edd4a819	Target coordinates radio messages now displayed for a longer time	2025-09-11 11:29:07 +02:00
Ambroise Garel	b140238aa0	Added displayTimeMultiplier parameter	2025-09-11 11:28:50 +02:00
Ambroise Garel	814fbccb00	Mission now autostarts when all players have taken off	2025-09-11 11:12:57 +02:00
Ambroise Garel	81b0be5645	Changed wording	2025-09-11 10:59:02 +02:00
Ambroise Garel	fdb5090e40	Added function DCSEx.world.getPlayersOnGround(side)	2025-09-11 10:58:51 +02:00
Ambroise Garel	99133326b9	Added units from Currenthill unit pack	2025-08-26 10:55:47 +02:00
Ambroise Garel	994c4d9193	Wingmen now removed when player enters a new unit in SP	2025-08-11 17:52:08 +02:00
Ambroise Garel	f1a87bcfa8	Restored DCSEx.dcs.doNothing()	2025-08-07 19:07:41 +02:00
Ambroise Garel	9d64113241	Added "press key to respawn" message on single-player death	2025-08-05 17:48:39 +02:00
Ambroise Garel	adee5411e1	Updated README	2025-08-05 17:38:35 +02:00
Ambroise Garel	4232ee723c	Now uses "Client" instead of "Player" slots for single-player	2025-08-05 17:38:14 +02:00
Ambroise Garel	c3ecc403e2	Removed references to world.getPlayer()	2025-08-05 17:22:16 +02:00
Ambroise Garel	dca67aa13c	Moved TUM.administrativeSettings to its own table	2025-08-05 17:10:30 +02:00
Ambroise Garel	6658dbecf9	Moved TUM.logger to its own file	2025-08-05 17:04:24 +02:00
Ambroise Garel	52ad4156a4	Merge pull request #12 from VEAF/davidp57/administrative_settings Introduced administrative settings.	2025-08-05 16:57:28 +02:00
Ambroise Garel	b4701a98e2	Merge pull request #14 from VEAF/davidp57/bug-callsigns Updated the currentCallsigns table, because there can be 20 max callsign numbers for some callsign types.	2025-08-03 19:42:06 +02:00
David Pierron	24a73b73c7	Updated the currentCallsigns table, because there can be 20 max callsign numbers for some callsign types.	2025-08-03 19:36:21 +02:00
Ambroise Garel	b94cdaa0ef	Merge pull request #13 from VEAF/davidp57/logging-system Enhanced the logging system while maintaining backward compatibility (through the use of the `TUM.log` function).	2025-08-03 19:26:15 +02:00
Ambroise Garel	6b765e7c80	Merge pull request #8 from VEAF/davidp57/issue1 VEAF MCT - error when adding AI planes to the mission	2025-08-03 19:22:51 +02:00
David Pierron	de3e3df840	Enhanced the logging system while maintaining backward compatibility (through the use of the `TUM.log` function). The new system defines specific functions: - TUM.Logger.trace - TUM.Logger.debug - TUM.Logger.info - TUM.Logger.warn - TUM.Logger.error These function can be passed any number of arguments additionnally to the message, and they'll safely format these arguments to be passed to `string.format`. Example of use: `TUM.Logger.trace("function DCSEx.world.setUnitLifePercent(unitID=%s, life=%s)", unitID, life)` Parameters are formatted based on their type (tables are fully printed for example), This is a reduced port of the VEAF logging system, which has been used for years.	2025-08-01 23:03:27 +02:00
David Pierron	c5743c993a	completed the specific radio menu feature (was missing some bits)	2025-08-01 19:39:54 +02:00
David Pierron	54ff069711	Introduced administrative settings. They are defined in `TUM.administrativeSettings`. They have a default value in `TUM.administrativeSettingsDefaultValues`. They can be overloaded either: - by script (with a call like `TUM.administrativeSettings.setValue(TUM.administrativeSettings.USE_SPECIFIC_RADIOMENU, true)` - by a parameter named after the setting in a trigger zone called `TUM_Administrative_Settings` Settings that are already implemented: - USE_SPECIFIC_RADIOMENU: use a specific radio menu for the mission commands, or use the main one? - INITIALIZE_AUTOMATICALLY: automatically initialize the mission when the script is loaded. If false, you must call TUM.initialize() manually. - IGNORE_ZONES_STARTINGWITH: if set, ignore all zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names. - ONLY_ZONES_STARTINGWITH: if set, only adds zones starting with this string. This is useful to avoid conflicts with other scripts that use the same zone names.	2025-08-01 18:47:47 +02:00
Ambroise Garel	e840bc3b0d	Added DCSEx.world.getFirstPlayer function	2025-08-01 16:59:46 +02:00
Ambroise Garel	25ba1ccd2e	Cleaned up and added comments	2025-08-01 16:57:15 +02:00
Ambroise Garel	8e7dc3ba7a	Added DCS World Schema to the credits, moved the manual to root directory	2025-08-01 10:19:21 +02:00
Ambroise Garel	548d81a5a6	Updated README	2025-07-31 22:31:56 +02:00
Ambroise Garel	0c20433ce4	Updated README	2025-07-31 22:06:19 +02:00
Ambroise Garel	051d548c8e	Updated README	2025-07-31 22:02:57 +02:00
Ambroise Garel	aab5ea1688	Updated manual and logo	2025-07-31 21:46:58 +02:00
Ambroise Garel	a25e8e6bc1	Added game logo and source manual	2025-07-31 18:27:06 +02:00
Ambroise Garel	c16041f58b	Added markdown-pdf VSCode extension configuration and styles for the PDF manual	2025-07-31 18:26:52 +02:00
Ambroise Garel	e66fe93ea0	Added "cancel" option	2025-07-31 17:35:08 +02:00
Ambroise Garel	ebffc5313a	Removed unused command, added check for PHP installation	2025-07-31 17:24:26 +02:00
Ambroise Garel	39039430c1	Added *.pdf to .gitignore	2025-07-31 17:24:10 +02:00
Ambroise Garel	8d05b98a95	Cleaned up and added comments to DCSEx tables	2025-07-31 11:02:03 +02:00
David Pierron	3e1bd1e52e	VEAF MCT - error when adding AI planes to the mission Fixes VEAF/the-universal-mission-for-dcs-world#1	2025-07-31 10:18:48 +02:00
Ambroise Garel	33f8986317	Added datalink setup	2025-07-30 15:50:13 +02:00
Ambroise Garel	a55012e383	Increased AWACS aircraft cruise altitude	2025-07-30 15:20:24 +02:00
Ambroise Garel	6964bf2543	Fixed typos	2025-07-29 17:26:39 +02:00
Ambroise Garel	b45caaa4c4	Added Germany theater	2025-07-22 15:04:11 +02:00