From 20bb4faf1bd20d6ca976965f3322e5e265cb19bb Mon Sep 17 00:00:00 2001 From: MetalStormGhost <89945461+MetalStormGhost@users.noreply.github.com> Date: Mon, 5 Feb 2024 15:12:44 +0200 Subject: [PATCH] Updated Custom Factions (markdown) --- Custom-Factions.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/Custom-Factions.md b/Custom-Factions.md index ecba964..af2b4e2 100644 --- a/Custom-Factions.md +++ b/Custom-Factions.md @@ -1,11 +1,11 @@ # Principle -Frustrated that your home country is not a possible choice in DCS Liberation, or annoyed that an aircraft is missing in your favorite faction? -Good news, you can now mod factions in liberation! +Frustrated that your home country is not a possible choice in DCS Retribution, or annoyed that an aircraft is missing in your favorite faction? +Good news, you can now mod factions in Retribution! And these custom factions can be created easily with a text editor as a yaml or json file (prefer yaml for new factions). -You can find the default factions included in Liberation in the **\resources\factions\\** folder within the Liberation install directory. If you have created your own custom faction files and wish to place them in a more permanent location, you have the option of placing them instead in the DCS folder itself, by creating a folder call "Factions" (Liberation will read faction files from either location). This would be the same location that is listed as your "DCS Saved Game Directory" under File > Preferences in Liberation. As an example, if you are running Openbeta, it would likely be **C:\users\\\\\Saved Games\DCS.openbeta\Liberation\Factions\\**. +You can find the default factions included in Retribution in the **\resources\factions\\** folder within the Retribution install directory. If you have created your own custom faction files and wish to place them in a more permanent location, you have the option of placing them instead in the DCS folder itself, by creating a folder call "Factions" (Retribution will read faction files from either location). This would be the same location that is listed as your "DCS Saved Game Directory" under File > Preferences in Retribution. As an example, if you are running Openbeta, it would likely be **C:\users\\\\\Saved Games\DCS.openbeta\Retribution\Factions\\**. ![](https://imgur.com/hiqrYEh.png) @@ -21,7 +21,7 @@ If there is an error with the file it will not appear, please check the content This yaml or json file should contain the following fields: * **country** : The country to be used in DCS. Careful, if it is not a valid country name in DCS, the mission generation will not work. -* **name** : Name of the faction in DCS Liberation UI +* **name** : Name of the faction in DCS Retribution UI * **aircrafts** : List of Aircrafts available to this faction * **awacs** : List of AWACS planes available to this faction * **tankers** : List of Tankers planes available to this faction @@ -40,12 +40,12 @@ This yaml or json file should contain the following fields: * **jtac_unit** : Type of unit to use as JTAC. * **doctrine** : Either "modern" for modern doctrine, "coldwar" for coldwar doctrine, or "ww2" for WW2 doctrine. Doctrine controls the altitude of flights and other flight planner AI parameters. * **building_set** : Either "default" for default set, "ww2ally" for WW2 ally buildings, "ww2germany" for WW2 german building or "ww2free" for a ww2 building set that does not require the WW2 asset pack. -* **liveries_overrides** : List of aircraft and liveries to set. It is possible to have multiple liveries for aircraft, and Liberation will pick one out of the list randomly. The livery must be available to the country set in order to appear. If the livery doesn't show up in Mission Editor for that country, it won't show up in your Liberation mission either. The name of the livery can be found in its description.lua (if it's not there, then use the exact name of the livery's folder). +* **liveries_overrides** : List of aircraft and liveries to set. It is possible to have multiple liveries for aircraft, and Retribution will pick one out of the list randomly. The livery must be available to the country set in order to appear. If the livery doesn't show up in Mission Editor for that country, it won't show up in your Retribution mission either. The name of the livery can be found in its description.lua (if it's not there, then use the exact name of the livery's folder). * **unrestricted_satnav** : Enable this option to allow unrestricted SATNAV in the mission. This will allow the use of GPS by non-US countries, e.g. non-US F/A-18s will be able to use GPS for alignment. This value is optional and may be either `true` or `false`. If not set this defaults to `false`. **Note:** -*I highly recommend you look at the default files provided in DCS Liberation for examples.* +*I highly recommend you look at the default files provided in DCS Retribution for examples.* All parameters have default values, so you do not have to set them all up necessarily. When changing a livery, if an aircraft is a Core DCS aircraft or module such as the MiG-19P, the livery must be in the Modules Liveries section and not your Saved Games folder. @@ -54,7 +54,7 @@ It is recommended, that your faction has access to all unit types, e.g. at least ## Aircraft, ground unit und naval names -Ground, naval, and air units in the faction file use the name of the unit in Liberation rather than the name in DCS. +Ground, naval, and air units in the faction file use the name of the unit in Retribution rather than the name in DCS. The names used are taken from the `variants` section of the unit info files in the `resources/units` directory. For example, `units/aircraft/FA-18C_hornet.yaml` contains the following: @@ -65,7 +65,7 @@ variants: F/A-18C Hornet (Lot 20): {} ``` -In this example, there are three variants of the DCS F/A-18C Hornet unit. These "variants" are **name only**. The DCS unit type will be the F/A-18C module, but the name in the Liberation UI will be whichever variant is named in the faction file. This allows a Spain faction to pretend that an EF-18A+ is available in DCS. +In this example, there are three variants of the DCS F/A-18C Hornet unit. These "variants" are **name only**. The DCS unit type will be the F/A-18C module, but the name in the Retribution UI will be whichever variant is named in the faction file. This allows a Spain faction to pretend that an EF-18A+ is available in DCS. Ground units use the same format, but are located in `resources/units/ground_units`. The same applies to naval units which are defined in `resources/units/ships` @@ -193,7 +193,7 @@ Below is an example of a factions file : ## Annex - Possible Aircraft -Warning: this list is probably incomplete and wrong. It is not kept up to date when Liberation changes. If you want the truth you have to look at the YAML files shipped with the version of Liberation you're using. +Warning: this list is probably incomplete and wrong. It is not kept up to date when Retribution changes. If you want the truth you have to look at the YAML files shipped with the version of Retribution you're using. * *A-4E Skyhawk* * *A-10A Thunderbolt II*