Created Custom Factions (markdown)

C. Perreau 2020-10-25 00:10:57 +02:00
parent 9a503f5700
commit 19e30a70c3

153
Custom-Factions.md Normal file

@ -0,0 +1,153 @@
# Principle
Frustrated that your motherland is not a possible choice in DCS Liberation, annoyed that an aircraft is missing in your favorite faction ?
Good news, you can now mod factions in liberation !
And these custom factions can be created easily with a text editor as a json file.
You can put your own factions configuration json files in the folder **./resources/factions**
![](https://imgur.com/hiqrYEh.png)
Then restart DCS Liberation to have the faction loaded.
If there is no error, your custom faction will appear in the New Game Wizard.
If there is an error with the file it will not appear, please check the content of the console output, it might contains hints about the error. First please verify is the json syntax is valid.
# File format
This json file should contain a json object, with the following parameters :
* **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
* **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
* **frontline_units** : List of units that will fight on the frontline
* **artillery_units** : List of artillery that will fight on the frontline
* **infantry_units** : List of infantry units that will fight on the frontline
* **logistics_units** : List of units used for logistics (unused for now)
* **shorads** : List of generators used for shorad groups (See the Sam Generator possible choice at the end of this guide)
* **sams** : List of generators used for sams groups
* **missiles** : List of missiles generators used for sams groups
* **requirements** : Required mods for this faction to work
* **aircraft_carrier** : List of aircraft carriers available
* **helicopter_carrier** : List of helicopter carriers available
* **carrier_names** : List of possible name for carriers (will be picked randomly if there is more than one)
* **helicopter_carrier_names** : List of possible name for helicopter carriers (will be picked randomly if there is more than one)
* **navy_generators** : List of generators used for navy groups (See the Sam Generator possible choice at the end of this guide)
* **destroyers** : List of destroyers available (Will be picked randomly and used as escort for carriers)
* **cruisers** : List of cruisers availables (unused for now)
* **navy_group_count** : Number of navy group to generate per control point
* **missiles_group_count** : Number of missiles group to generate per control point
* **has_jtac** : Whether this faction has access to jtac
* **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, or "ww2germany" for WW2 german building.
**Note :**
*I highly recommend you look at the default files provided in DCS Liberation for examples.
All parameters have default value, so you do not have to set them all up.
# Example file
Below is an example of a factions file :
```json
{
"country": "USA",
"name": "USA 2005",
"authors": "Khopa",
"description": "",
"aircrafts": [
"F_15C",
"F_15E",
"F_14B",
"FA_18C_hornet",
"F_16C_50",
"A_10A",
"AV8BNA",
"UH_1H",
"AH_64A",
"B_52H",
"B_1B",
"F_117A"
],
"awacs": [
"E_3A"
],
"tankers": [
"KC_135",
"KC130"
],
"frontline_units": [
"MBT_M1A2_Abrams",
"ATGM_M1134_Stryker",
"APC_M1126_Stryker_ICV",
"IFV_M2A2_Bradley",
"IFV_LAV_25",
"APC_M1043_HMMWV_Armament",
"ATGM_M1045_HMMWV_TOW"
],
"artillery_units": [
"MLRS_M270",
"SPH_M109_Paladin"
],
"logistics_units": [
"Transport_M818"
],
"infantry_units": [
"Infantry_M4",
"Soldier_M249"
],
"shorads": [
"AvengerGenerator"
],
"sams": [
"HawkGenerator"
],
"aircraft_carrier": [
"CVN_74_John_C__Stennis"
],
"helicopter_carrier": [
"LHA_1_Tarawa"
],
"destroyers": [
"Oliver_Hazzard_Perry_class",
"USS_Arleigh_Burke_IIa"
],
"cruisers": [
"Ticonderoga_class"
],
"requirements": {},
"carrier_names": [
"CVN-71 Theodore Roosevelt",
"CVN-72 Abraham Lincoln",
"CVN-73 George Washington",
"CVN-74 John C. Stennis"
],
"helicopter_carrier_names": [
"LHA-1 Tarawa",
"LHA-2 Saipan",
"LHA-3 Belleau Wood",
"LHA-4 Nassau",
"LHA-5 Peleliu"
],
"navy_generators": [
"OliverHazardPerryGroupGenerator",
"ArleighBurkeGroupGenerator"
],
"has_jtac": true,
"jtac_unit": "MQ_9_Reaper"
}
```
# Possible SAM/SHORAD generators
WIP
# Possible Navy group generators