ACTIVITIES
To ensure that your aircraft and airports work correctly with the various careers that are available as well as some of the predefined Navigation Services or Apron Services, you will have to include one or more navigation_graph.cfg
files which have been setup in a specific way, as well as follow some other guidelines specific to the career mission or the airport service you are wanting to interact with. The pages listed below cover all the available careers and provide information on the requirements for any aircraft to participate in that specific career, as well as additional information related to airports and other simulation interactions.
- Preflight (All AIrcraft)
- Spawn Pilot (All Aircraft)
- Aerial Advertising (Planes)
- Aerial Construction (Helicopters)
- Aerial Firefighting (Planes)
- Agricultural Aviation (All Aircraft)
- Cargo Transport (All Aircraft)
- Charter Service (Planes)
- Commercial Flights And Passengers (All Aircraft)
- Ferry Flights (Planes)
- Flightseeing / First Flight (All Aircraft)
- Medevac (Planes)
- Search And Rescue (All Aircraft)
- Skydiving (Planes)
FLT Files
When a user starts a career activity they will not be going through the usual Preflight checks, and so they will need to have a specific FLT file in the aircraft preset for the activity. This file substitues the apron.flt that is used for freeflight and other moments when the aircraft needs to start cold and dark. For almost all activities the file should be called the following:
ApronWithoutCovers.flt
This file should be set up like a regular apron FLT file, except you must ensure that all the parameters related to preflight covers, chocks, pins, etc... are set to false in the [Covers]
section.
However, if the aircraft is for these activity types:
- Passenger Transport (Planes)
- VIP Charter (Airliner + Cabin Crew)
- Cargo Transport (Heavy, Super Heavy and Remote Cargo Ops)
You will need the following file instead:
ApronWithBatteriesWithoutCovers.flt
This file should be setup exactly as the ApronWithoutCovers.flt
, but it should also have the batteries - and associated circuits - in the electrical system switched on, as set in the [Electrical.N] section of the file.
Note On Big Wheeled Aircraft
Some careers are restricted and will not permit aircraft that have a "big wheeled" classification. This classification is not set through any specific CFG parameter - although the contact points (as defined in the point.N
parameter) must be of the type "Wheel" - but is instead calculated by the simulation based on the following formula:
$$\textrm{radius_to_height_ratio} = {max(wheel\_radius) \over [max(pos.y) - min(pos.y)]}$$
Where:
- \(radius\_to\_height\_ratio\) is the wheel radius to aircraft height ratio
- \(wheel\_radius\) is the radius of all wheels (so the formula uses the maximum size of all defined wheels)
- \(pos.y\) is the position on the Y axis of all contact points of the type wheel (so the formula uses the minimum and maximum Y position taken from all wheels)
This formula will be interpreted in two different ways depending on the engine count of the aircraft, where:
- If the engine count for the aircraft is 1 or less, and the \(radius\_to\_height\_ratio\) is greater than 0.15 then the aircraft is classified as having big wheels.
- If the engine count for the aircraft is greater than 1 and the \(radius\_to\_height\_ratio\) is greater than 0.075, then the aircraft is classified as having big wheels.
Note On Aircraft Complexity
Some careers will require (or omit) aircraft based on their complexity. This attribute is based on different parameters depending on whether the aircraft is a plane or an helicopter, and it can have three values: simple, complex, or very complex.
Plane Complexity
For planes, complexity is simply based on the max_gross_weight
parameter, where:
- if the maximum gross weight is greater than or equal to 136000kg, the plane is considered as very complex.
- if the maximum gross weight is greater than or equal to 7000kg, the plane is considered as complex.
- if the maximum gross weight is less than 7000kg, the plane is considered as simple.
Helicopter Complexity
For helicopters, complexity can be decided using the following two methods:
- if
max_gross_weight
is defined then:- if the maximum gross weight is greater than or equal to 3180kg, the helicopter is considered as very complex.
- if the maximum gross weight is greater than or equal to 1590kg, the helicopter is considered as complex.
- if the maximum gross weight is less than 7000kg, the helicopter is considered as simple.
- if
max_gross_weight
is not defined then:- if the helicopter
engine_type
isHELO_TURBINE
and has more than one engine, then it is considered as very complex. - if the helicopter
engine_type
isHELO_TURBINE
and has one engine, then it is considered as complex. - all other helicopters are considered as simple.
- if the helicopter
Note On Payload Mass
Some activity specialisations will only accept aircraft which respect a paylod mass constraint. This mass value is calculated in kilograms (kg) in one of two ways depending on how the aircraft flight_model.cfg is set up:
- If the max_zero_fuel_weight is defined then we use that along with the empty_weight like this:
$$PayloadMass = \text{max_zero_fuel_weight} - EmptyWeight$$ - If there is no max_zero_fuel_weight definition then max_gross_weight is used instead along with the empty_weight:
$$PayloadMass = \text{max_gross_weight} - EmptyWeight$$
Note On Cabin Codes
Cabin codes are automatically generated codes used to identify the equipment available on an aircraft and career activity that it is suited for, based on the setup of the aircraft and the constraint requirements it fulfils. You can find the cabin code associated with any specific career activity on the page where the constraints are explained - for example AEA_Cabin
or CHT_Cabin
. Additionally the page may say that the aircraft cannot have a different cabin code to the one given, or can only have a selection of cabin codes. This is because it's possible to setup a preset in the Modular SimObject that can participate in multiple career activities, but in some cases this is not something that would be acceptable for the activity. Having a firefighting aircraft doing VIP transport is not a good idea! So the generated cabin codes for the aircraft will define what activities it can participate in or not. The table below shows these codes along with the activity they belong to:
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 |
The cabin code property is set using the presence of specific equipment in the aircraft, specific parameters and their values, and sometimes the contents of the model glTF files. These codes follow a priority system, where if a variation has equipment belonging to a specific category, it might be still be compatible with another category as well, or be overriden by a higher priority category. This priority queue is as follows:
- Agricultural Aviation (AEA)
- Aerial Firefighting (FIR)
- Scientific Research (DIC)
- Search & Rescue - Rotorcraft (SAR)
- Skydive Aviation (SKP)
- Aerial Advertising (AAD)
- Cargo Transport - Rotorcraft (CHT)
- Cargo Transport - Planes (CAR)
- Medevac (MED)
- Charter Service (PRC)
- Passenger Transport, Search & Rescue - Plane, First Flight, Flightseeing (COF)
- Default
To give an example of how this works, let's consider an aircraft that has been set up with FIR-INA, SKP-PLN, and MED-PLN. This means it has the FIR_Cabin, SKP_Cabin, and MED_Cabin categories, so, because FIR has a higher priority than SKP (and than MED), the cabin property will be set to FIR_Cabin.
Note that some activities can specify a list of multiple cabins that are compatible with them, while others may say that they cannot be performed if the aircraft has a specific cabin category.