livery.cfg
This CFG file is used to setup a specific livery to be used by a modular aircraft. This files should be placed within the top-level of the aircraft project in a folder called "liveries". The full setup for the liveries folder can be found on the page describing the modular aircraft project structure:
For information on how to set up the assets to be able to use this file, please see the following page:
[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 seciton 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.
Example:
|
String | No |
[EDITABLE_COLORS]
This section is used to define the base editable colour (and optional material) for the livery.
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 |
[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.