Custom Factions

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 !

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 or modify existing ones. Also you may place new faction files in your DCS Saved Games folder. **C:\users<your username>\Saved Games\DCS\Liberation\Factions The Liberation\Factions folder will have to be created as it is not created when setting up liberation. This is the same location that you point Liberation too when setting it up for the first time.

Then restart DCS Liberation to have the faction loaded.

If there is no error, your custom faction will appear in the New Game Wizard. Please note that factions saved in your DCS saved games folder will appear at the bottom of the list and not in alphabetical order. If there is an error with the file it will not appear, please check the content of the console output, it might contain hints about the error. First, please verify 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)
air_defenses : List of generators used for air defense groups (See the list of possible air defenses generators in annex)
ewrs : List of ewr generators to be used for the IADS (See the list of possible ewr generators in annex)
missiles : List of missiles generators used for missiles groups
requirements : List of 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, "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.

Note :

I highly recommend you look at the default files provided in DCS Liberation 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.

Example file

Below is an example of a factions file :

{
  "country": "USAF Aggressors",
  "name": "USAF Aggressors",
  "authors": "Khopa",
  "description": "<p>USAF aggresors.</p>",
  "aircrafts": [
    "F_15C",
    "F_15E",
    "F_14B",
    "FA_18C_hornet",
    "F_16C_50",
    "A_10A",
    "A_10C",
    "AV8BNA",
    "UH_1H",
    "AH_64D",
    "Ka_50",
    "B_52H",
    "B_1B",
    "F_117A",
    "Su_27"
  ],
  "awacs": [
    "E_3A"
  ],
  "tankers": [
    "KC_135",
    "KC130"
  ],
  "frontline_units": [
    "MBT_M1A2_Abrams",
    "MBT_Leopard_2",
    "ATGM_M1134_Stryker",
    "IFV_M2A2_Bradley",
    "IFV_LAV_25",
    "APC_M1043_HMMWV_Armament"
  ],
  "artillery_units": [
    "MLRS_M270",
    "SPH_M109_Paladin"
  ],
  "logistics_units": [
    "Transport_M818"
  ],
  "infantry_units": [
    "Infantry_M4",
    "Soldier_M249"
  ],
  "air_defenses": [
    "AvengerGenerator",
    "HawkGenerator",
    "PatriotGenerator"
  ],
  "ewrs": [
    "PatriotEwrGenerator"
  ],
  "requirements": {},
  "navy_generators": [
    "OliverHazardPerryGroupGenerator"
  ],
  "has_jtac": true,
  "jtac_unit": "MQ_9_Reaper",
  "liveries_overrides": {
    "FA_18C_hornet": [
      "NSAWC brown splinter",
      "NAWDC black",
      "VFC-12"
    ],
    "F_15C": [
      "65th Aggressor SQN (WA) MiG",
      "65th Aggressor SQN (WA) MiG",
      "65th Aggressor SQN (WA) SUPER_Flanker"
    ],
    "F_16C_50": [
      "usaf 64th aggressor sqn - shark",
      "usaf 64th aggressor sqn-splinter",
      "64th_aggressor_squadron_ghost"
    ], "F_14B": [
      "vf-74 adversary"
    ]
  }
}