livery.cfg
This CFG file is used to setup a specific livery to be used by a modular aircraft. These files should be placed within the individual liveries folders of the aircraft project, with specifically one version of the file per-livery. The full description of the files used in the livery folders can be found on the modular SimObject page here:
For information on how to set up the assets to be able to use this file, please see the following page:
For information on how an individual livery should be set up to make use of adaptive elements, please see here:
[Version]
The [Version]
section provides version information for the configuration file. In Microsoft Flight Simulator 2024, major versions should always be at least equal to 1.
Note that this section information is mandatory and should always be included.
Parameter | Description | Type | Required |
---|---|---|---|
major |
Major CFG file version number, values must be greater than 0. | Integer | Yes |
minor |
Minor CFG file version number, values must be greater than 0. | Integer | Yes |
[General]
The parameters in this section are used to provide some general information about the livery.
Parameter | Description | Type | Required |
---|---|---|---|
name |
The name of the livery, as a localisable string. This will be displayed to the user on the Aircraft Configurator screen in the simulation | String | Yes |
[Selection]
The parameters in this section are used to define under which circumstances the livery will be available to the user for selection, or for a mission to apply automatically. It has the following parameters:
Parameter | Description | Type | Required |
---|---|---|---|
required_tags |
This defines which tags are required for this livery to show up for a given Preset. This parameter lets you disable a livery if it is not compatible when a tag is missing. Multiple tags can be specified by separating them using a comma. Tags are defined in the
|
String | No |
[EDITABLE_COLORS]
This section is used to define the base editable colour (and optional material) for the livery. For more information, please see the Liveries page.
Parameter | Description | Type | Required |
---|---|---|---|
editable_color.N |
Each
The colour hash map is comprised of the following multiple
The colour value is defined using three values for the RGB components, and will be the default colour for the livery adaptive colour "slot" corresponding to the index. This key is the only required key in the hash map.
The material name given is a flightsim material to target with this colour, as defined in one of the livery glTF files. When giving the material name, it can be formatted in any one of the following ways depending on the requirements of the SimObject:
The fallback index that you give is the index of the
A full example of a single colour definition would be like this:
|
No |
[PALETTE_LABELS]
This section is used to define a number of key/value pairs which will be used as "labels" to filter colour palettes. The idea is that the labels given hear will narrow the selection of a colour palette down to just one from the palette.lbl
file. For more information, please see the Liveries page.
Parameter | Description | Type | Required |
---|---|---|---|
label_key.N |
This defines a label key to search for as part of the palette filtering. Keys are indexed from 0 and should increment by 1 for every new key added. You may have keys with no associated value (see Geographic Keys, for more information). For example:
You have access to a number of built-in palettes using specific keys and values, as outlined here: Labels / Keys For Included Palettes. You may also create your own palettes and then supply your own key/value pairs, as explained here: Palettes
|
String | Yes |
label_value.N |
This defines the value for the associated key. The N index should be the same as that of the label_key it corresponds to, and you cannot have a value without an associated key. Values should always be expressed inside quotation marks, even if it's a float or integer.
|
String | No |
[Panel_DynamicParameters]
This section lets you define a number of dynamic parameters which will be used to override those found in the attached_objects.cfg
of any attachments that are loaded as part of the modular aircraft.
Parameter | Description | Type | Required |
---|---|---|---|
param.N |
This parameter can be used to create a list of dynamic parameters which will override any value created using the vcockpit_parameter.N or vpainting_parameter.N attachment parameters. The value for the parameter is a string, and within the string you give two pieces of data, separated by a comma:
Parameters indexed from 0 and should be incremented by 1 for each new parameter that is added. A full example of a single parameter definition would be like this:
|
String | No |
[Specialization]
The parameters in this section are used to define under which circumstances the livery will be available to the user for selection, or for a mission to apply automatically. It has the following parameters:
Parameter | Description | Type | Required |
---|---|---|---|
dressing_codes |
This parameter specifies for which career specialisations the livery is applicable. If the livery is applicable to multiple different specialisations, these can be added as a comma separated list, for example:
The default value is an empty string "" which means the livery can be used in all careers. |
List of strings |
Yes |
The table below lists all the available career specialisation codes:
Specialisation | Dressing Code | Cabin Code |
---|---|---|
Medevac - Plane | MED-PLN | MED_Cabin |
Cargo Transport (Light) - Plane | CAR-PSO | CAR_Cabin |
Cargo Transport (Medium) - Plane | CAR-PLC | |
Cargo Transport (Heavy) - Plane | CAR-PCC | |
Cargo Transport (Super Heavy) - Plane | CAR-PVO | |
Remote Cargo Ops - Plane | CAR-PLM | |
Cargo Transport - Rotorcraft | CHT-ROH | CHT_Cabin |
Aerial Construction - Rotorcraft | CHT-AEC | |
Scientific Research - Plane | DIC-SCR | DIC_Cabin |
Passenger Transport - Plane | COF-PCC | COF_Cabin |
Passenger Transport - Rotorcraft | COF-ROT | |
Charter Service (Private) - Plane | PRC-PSO | COF_Cabin / PRC_Cabin |
Charter Service (VIP) - Plane | PRC-PLC | PRC_Cabin |
Charter Service (VIP Airliner) - Plane | PRC-PCC | |
Search & Rescue - Plane | SAR-PLN | COF_Cabin |
Search & Rescue - Rotorcraft | SAR-ROT | SAR_Cabin |
Search & Rescue (Hoist) - Rotorcraft | SAR-ROI | |
Aerial Firefighting (Initial Attack) - Plane | FIR-INA | FIR_Cabin |
Aerial Firefighting (Extended Attack) - Plane | FIR-EXA | |
Skydive Aviation - Plane | SKP-PLN | SKP_Cabin |
Agricultural Aviation - Plane | AEA-PLN | AEA_Cabin |
Agricultural Aviation - Rotorcraft | AEA-ROT | |
Aerial Advertising - Plane | AAD-PLN | AAD_Cabin |
First Flight - Plane | FIF-PLN | COF_Cabin |
Flightseeing - Plane | TOR-PLN | |
Flightseeing - Rotorcraft | TOR-ROT | |
Ferry Flight - Plane | FEF-PLN | DEFAULT |
[Tags]
This section is used to list any tags that you wish to be associated with the livery being defined. These tags are used to make the livery available in specific activities, in career mode, and to group liveries together. Note that these tags are independent of the ones defined in the attachment.cfg
file.