<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