<palette>.lbl

This file is used to define a palette of colours which can be used under the circumstances defined by the associated labels. In the livery.cfg file, you can define a series of palette key / value pairs to be used for the livery being defined, and these will then be used to filter the palette LBL file and find a specific palette to match the circumstances of the flight the livery is being used in.

NOTE: The name of the file is not important as all *.lbl files are parsed when looking for a palette.

 

Before listing the different keys that the LBL file requires, here is an example showing a single palette definition which can be used for reference when setting up your own:

{
    "LabeledPalettes": [
        {
            "Name": "SKP_Red_Black",
            "ColorPalette": [
                "#cc1919",
                "#FFFFFF",
                "#cc1919",
                "#FFFFFF",
                "#333333",
                "#FFFFFF",
                "#333333",
                "#FFFFFF",
                "#333333",
                "#FFFFFF"],
            "Labels": [
            {
                "Key": "Type",
                "Values":["SKP"]
            },
            {
                "Key": "Continent",
                "Values":["Africa"]
            },
            {
                "Key": "Color",
                "Values":["Red"]    
            }
            ]
        }
    ]
}

 

 

"LabeledPalettes"

This is the top level key of the <palette>.lbl file, and must be included otherwise the file will be invalid. The value for this element is an array, where each object in the array is a single palette definition containing the "Name", "ColorPalette", and "Lables" keys.

 

 

"Name"

This key expects a single value, which is a string defining the name of the palette. This name is purely orientative and is not used in the simulation. It is simply to help clearly identify each palette object within the file.

 

 

"ColorPalette"

This key expects an array of strings, where each string contains a colour expressed as a hexadecimal value (RGB only, no alpha). The array can hold any number of colours, which will ideally (though not necessarily) correspond with the defined [EDITABLE_COLORS] in the livery.cfg file.

 

 

"Labels"

This key expects an array of 1 or more objects, where each object is a "key" and "value" pair. Label keys are used to further filter the list of palettes available such that only one is possible under any given situation, with the keys to check coming from the [PALETTE_LABELS] section of the livery.cfg file.

 

 

"Key"

This key is used to define a key parameter to be used as a filter to find the correct palette to use.

 

 

"Value"

This is an array of values that accompany the given key to generate the filter used to find the correct palette to use.

 

 

Labels / Keys For Included Palettes

The simulation has a number of included palettes that can be accessed using specific keys and optional values. You can use any number of these keys/values from the list below to select a colour palette for your own aircraft.

 

 

Geographic Keys

When creating the palette labels, every value must have an associated key, but not every key requires a value. In the case of geographic keys, there are three that can be used with no value, which means that the simulation will automatically find the value from the simulation palette file based on the geographic location of the aircraft. The three available keys are:

 

  • "Continent": When supplying this key, the simulation will search for a palette with the value corresponding to the continent the flight is taking place on. Accepted values in the palette library for this are:

    Africa
    Antartica
    Asia
    Europe
    North America
    Oceania
    South America

 

  • "MergedCountry": when supplying this key, the simulation will search for a palette with the value corresponding to the merged country the flight is taking place on (a merged country is a collection of countries grouped together based on geographic and socio-cultural parity). Accepted values in the palette library for this are:

    AF_Central
    AF_East
    AF_North
    AF_South
    AF_West
    Antarctica
    Australia_East
    Australia_West
    Balkans
    Brazil
    BritishIsles
    Canada_Central
    Canada_East
    Canada_North
    Canada_West
    Caribbean
    CentralAmerica
    CentralAsia
    China_NorthEast
    China_SouthEast
    China_West
    DACHCzechia
    EasternEurope
    FranceBenelux
    GreeceTurkeyCaucuses
    GreenlandIceland
    IberianPeninsula
    IndianOcean
    IndianSubcontinent
    ItalyMalta
    JapanKoreas
    Mexico
    MiddleEast
    NewZealandOceania
    Russia_East
    Russia_EastCentral
    Russia_West
    Russia_WestCentral
    SA_North
    SA_South
    SA_West
    SEAsiaIslands
    SEAsiaMainland
    Scandinavia
    USA_Alaska
    USA_HawaiiPacific
    USA_MidWest
    USA_NorthEast
    USA_NorthWest
    USA_SouthCentral
    USA_SouthEast
    USA_SouthWest
    Ukraine

 

  • "Country": when supplying this key, the simulation will search for a palette with the value corresponding to the country the flight is taking place on. Accepted values in the palette library for this are:

    Afghanistan
    Albania
    Algeria
    Angola
    Antarctica
    Argentina
    Armenia
    Australia_East
    Australia_West
    Austria
    Azerbaijan
    Bahrain
    Bangladesh
    Belarus
    Belgium
    Belize
    Benin
    Bhutan
    Bolivia
    BosniaHerzegovina
    Botswana
    Brazil
    Brunei
    Bulgaria
    BurkinaFaso
    Burundi
    Cambodia
    Cameroon
    Canada_Central
    Canada_East
    Canada_North
    Canada_West
    CapeVerde
    Caribbean
    CentralAfricanRepublic
    Chad
    Chile
    China_NorthEast
    China_SouthEast
    China_West
    Colombia
    Comoros
    Congo
    CostaRica
    Croatia
    Cuba
    Czechia
    DRCongo
    Denmark
    Djibouti
    DominicanRepublic
    EastTimor
    Ecuador
    Egypt
    ElSalvador
    EquatorialGuinea
    Eritrea
    Estonia
    Eswatini
    Ethiopia
    Fiji
    Finland
    France
    Gabon
    Gambia
    Georgia
    Germany
    Ghana
    Greece
    Greenland
    Guatemala
    Guinea
    GuineaBissau
    Guyana
    Haiti
    Honduras
    Hungary
    Iceland
    India
    Indonesia
    Iran
    Iraq
    Ireland
    Israel
    Italy
    IvoryCoast
    Jamaica
    Japan
    Jordan
    Kazakhstan
    Kenya
    Kosovo
    Kuwait
    Kyrgyzstan
    Laos
    Latvia
    Lebanon
    Lesotho
    Liberia
    Libya
    Lithuania
    Luxembourg
    Madagascar
    Malawi
    Malaysia
    Maldives
    Mali
    Malta
    Mauritania
    Mauritius
    Mexico
    Moldova
    Mongolia
    Montenegro
    Morocco
    Mozambique
    Myanmar
    Namibia
    Nepal
    Netherlands
    NewZealand
    Nicaragua
    Niger
    Nigeria
    NorthKorea
    NorthMacedonia
    Norway
    Oceania
    Oman
    Pakistan
    Palestine
    Panama
    PapuaNewGuinea
    Paraguay
    Peru
    Philippines
    Poland
    Portugal
    Qatar
    Romania
    Russia_East
    Russia_EastCentral
    Russia_West
    Russia_WestCentral
    Rwanda
    SaoTomePrincipe
    SaudiArabia
    Senegal
    Serbia
    Seychelles
    SierraLeone
    Singapore
    Slovakia
    Slovenia
    SolomonIslands
    Somalia
    SouthAfrica
    SouthKorea
    SouthSudan
    Spain
    SriLanka
    Sudan
    Suriname
    Sweden
    Switzerland
    Syria
    Tajikistan
    Tanzania
    Thailand
    Togo
    Tunisia
    Turkey
    Turkmenistan
    USA_Alaska
    USA_HawaiiPacific
    USA_MidWest
    USA_NorthEast
    USA_NorthWest
    USA_SouthCentral
    USA_SouthEast
    USA_SouthWest
    Uganda
    Ukraine
    UnitedArabEmirates
    UnitedKingdom
    Uruguay
    Uzbekistan
    Venezuela
    Vietnam
    Yemen
    Zambia
    Zimbabwe

 

 

Colours

You can select a specific colour palette by supplying the "Color" key and then one of the following values:

AllBlue
Apple Green Red
AppleGreen_Blue
AppleGreen_DarkGreen_Orange
AppleGreen_Red
Black_White
Blue
Blue Yellow White
Blue_DeepBlue
Blue_FullYellow
Blue_LightBlue
Blue_RedDarkBlueLines
Blue_Turquoise_White
Brown Beige White
Brown_Beige_White
Brown_White
Crimson DarkBlue White
Crimson White
Crimson_PaleGreen
Cyan_DesaturatedBlue
Cyan_Yellow
DarkBlue Gold
DarkBlue_Cyan_Grey
DarkBlue_Orange
DarkBlue_Red
DarkBlue_Red_White
DarkBlue_Red_Yellow
DarkBlue_Yellow
DarkBlue_Yellow_White
DarkGreen Black Yellow
DarkGreen_Black_Yellow
DarkGreen_PaleGreen
DeepBlue Red White
DeepBlue_Red_Orange
DeepBlue_White
DeepBlue_Yellow
FullBlack_Grey
FullBlack_Red
FullBlue_White
FullGreen_DarkBlue
FullGreen_Yellow_Black_Red
FullOrange_Black
FullOrange_White
FullOrange_White_Green
FullRed
FullRed_Green
FullRed_White
FullRed_Yellow
FullWhite_Blue
FullWhite_Cyan
FullWhite_DarkBlue
FullWhite_DarkBlue_Red
FullWhite_DarkGreen
FullWhite_Gold_Red
FullWhite_Green
FullWhite_Green_Blue
FullWhite_Orange
FullWhite_PaleBlue
FullWhite_Red
FullWhite_Red_Green
FullWhite_RedLines
FullYellow_Blue
FullYellow_DarkBlue
FullYellow_Green
FullYellow_Red
FullYellow_Red_Green_Black
FullYellow_VibrantBlue
Gold_Brown
Gold_White
Green_BlueRedLines
Green_Cyan
Green_DeepBlue
Green_Red
Green_White
Grey_Red
Grey_White
LightBlue&VariousColors
LightBlue_DeepBlue
Ocher PaleGreen DarkBlue
Ocher White
Ocher_PaleGreen_DarkBlue
Ocher_White
Orange_Blue_White
Orange_DeepBlue_White
Orange_GreenBlackLines
Orange_White
Orange_White_Cyan
PaleBlue_Mauve_DarkBlue_Pink
PaleBlue_NavyBlue_Red
PaleBlue_White
PaleBlue_White_Green_Red
PaleYellow PaleGreen Brown
PaleYellow_Green_Brown
PaleYellow_PaleBlue_Green
PaleYellow_Red_Brown_Beige
Pink_Cyan_Purple
Purple_Orange_White
Red Black
Red_Black
Red_DarkBlue_White
Red_Grey_White
Red_White
Red_Yellow
Red_Yellow_White
RedOcher_White
Sand Brown
Sand White
Sand_Brown
Sand_LightBrown_PaleGreen
Sand_Red
Silver_DeepBlue
Silver_Red
White Black Red
White Blue Black
White Blue Red
White Crimson
White Crimson DarkBlue
White DarkBlue
White DarkBlue Red
White DarkGreen Red
White Gold Red Green
White Green Blue Red Yellow
White Green Grey Red
White Green Red
White Grey
White Orange Green
White Red
White Red DeepBlue
White Yellow DeepBlue
White Yellow PaleRed
White_Blue
White_Blue_Grey
White_Blue_Orange
White_BlueGreenLines
White_BlueLines
White_Blues
White_Cyan_Orange
White_DarkBlue_Grey
White_DarkBlue_Orange
White_DarkBlue_Purple_Cyan
White_DeepBlue
White_Gold
White_Green_Blue_Red
White_Green_DarkBlue_Yellow
White_Green_Grey_Gold
White_Green_PaleOrange
White_Green_Red
White_Green_Red_Black
White_Green_Yellow_Red
White_Grey_BlueLines
White_Grey_Cyan
White_Orange
White_Orange_Black
White_Orange_Blue
White_Orange_Green
White_Orange_GreenLines
White_PaleBlue
White_paleBlue_Black
White_PaleBlue_Red
White_PaleBlue_Yellow
White_Pink
White_Purple
White_Purple_YellowGreenLines
White_Red
White_Red_Black
White_Red_Blue
White_Red_BlueYellowLines
White_Red_Brown_Orange
White_Red_DarkBlue
White_Red_DarkBlue2
White_Red_DarkBlue3
White_Red_DarkBlue4
White_Red_Green
White_Red_Grey
White_Red_PaleBlue
White_Red_Yellow
White_RedOcher
White_Yellow_Blue
White_Yellow_DarkBlue
Yellow DarkBlue Red
Yellow DarkGreen Crimson
Yellow Orange Red
Yellow Red DarkBlue
Yellow_Black
Yellow_Blue
Yellow_Blue_GreenLines
Yellow_DarkBlue
Yellow_DarkBlue_Red
Yellow_FullGreen_Red
Yellow_Green
Yellow_Green_Blue
Yellow_Green_Blue_Red
Yellow_Green_DarkBlue
Yellow_Green_Pale_Blue
Yellow_Green_Red
Yellow_Grey
Yellow_Orange_PaleGreen
Yellow_PaleBlueRed
Yellow_Red
Yellow_Red_Blue
Yellow_Red_DeepBlue
Yellow_RedGreenLines
Yellow_White_BlueLine
Yellow_White_Red

 

 

Activity

You may supply the key "Activity" and then a key to pick a palette based on the activity selected. The value from this key is the first three letters of the dressing code, for example:

[PALETTE_LABELS]
label_key.0 = "Activity"
label_value.0 = "AAD"

The table below gives the full dressing codes that can be used (first three letters only):

 

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

 

 

Aircraft Type

You can use the "Type" key to specify an aircraft type as a value and filter the palettes that way. This is an arbitrary value which is used to loosely group aircraft based on activities, location, climate and other factors, giving a palette appropriate to the type selected. Available aircraft type keys are as follows:

Activity
Africa
Agricultural
Asian
CARGO_AFRICA
CARGO_ASIA
CARGO_EU
CARGO_OCEANIA
CARGO_SA
Cultural
Desert
Europe
FIRE_AT802
Forest
Jungle
Mountain
Savannah
SouthAmerica
Tribal
Tropical