# systems.cfg<no value>

{{< image-center
    src="images/2_DevMode/simobject_editor/cfg/cfg_tab_9_systems.png"
    alt="The Systems.cfg File Tab In The SimObject Editor" >}}

The `systems.cfg` is an *optional* file for SimObjects, unless you are creating an **aircraft** in which case it is *mandatory*. This file is used for defining various different aircraft systems. Below you can find information on the different sections used in the `systems.cfg` file as well as what parameters and values are expected within them.


### [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.

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="major" />}}`major` | Major CFG file version number, values must be greater than 0. | Integer | Yes |
| {{< anchor id="minor" />}}`minor` | Minor CFG file version number, values must be greater than 0. | Integer | Yes |

{{< /table-wrapper >}}


### [BRAKES]

This section controls the aircraft's brake systems. Available parameters are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="brakes_aircraft_weight_ratio" />}}`brakes_aircraft_weight_ratio` | This defines the ratio of the total aircraft empty weight that each braking system weighs.<span></span>Default value is 0.0005. | Float | No |
| {{< anchor id="brakes_cooling_factor" />}}`brakes_cooling_factor` | This scalar is used to set the rate at which brakes will cool down when stopped.<span></span>Default value is 0.001. | Float | No |
| {{< anchor id="brakes_cooling_factor_100kts" />}}`brakes_cooling_factor_100kts` | This scalar is used to set the speed at which brakes will cool down when moving at 100{{< glossterm >}}Knots{{< /glossterm >}}<span></span>Default value is 0.02. | Float | No |
| {{< anchor id="brakes_wear_factor" />}}`brakes_wear_factor` | This scalar is used to set the speed at which brakes will wear down.<span></span>Default value is 0.00001. | Float | No |
| {{< anchor id="brakes_min_brake_effect_kelvin" />}}`brakes_min_brake_effect_kelvin` | This defines the temperature at which the brakes are 100% effective (in Kelvin).<span></span>Default value is 423.15. | Float | No |
| {{< anchor id="brakes_max_brake_effect_kelvin" />}}`brakes_max_brake_effect_kelvin` | This deifnes the temperature at which the brakes are minimally effective (in Kelvin).<span></span>Default value is 623.15. | Float | No |
| {{< anchor id="brakes_temperature_effect" />}}`brakes_temperature_effect` | This defines the ratio of effectiveness of the brakes when at the temperature defined by the [`brakes_min_brake_effect_kelvin`](#brakes_min_brake_effect_kelvin) parameter.<span></span>Default value is 0.75. | Float | No |
| {{< anchor id="parking_brake" />}}`parking_brake` | The type of parking brake available.<span></span>Default value is 1. | Integer:<span></span>{{< params/smallfont >}}0 = none<span></span>1 = parking brake<span></span>2 = ground restraint brake{{< /params/smallfont >}} | No |
| {{< anchor id="differential_braking_scale" />}}`differential_braking_scale` | Differential braking is a function of using both brakes and the rudder pedal input. The amount of difference between the left and right brake is scaled by this value. Setting this to 0.0 means no differential braking is desired, while a setting of 1.0 is the normal setting for when differential braking is desired - which is particularly useful for tailwheel airplanes.<span></span>Default value is 0. | Float | No |
| {{< anchor id="toe_brakes_scale" />}}`toe_brakes_scale` | Sets the scaling of the toe braking effectiveness, expressed as a {{< glossterm >}}percent_over_100{{< /glossterm >}}. Note that a setting of 0.0 scales the brakes to no effectiveness.<span></span>Default value is 1. | Float | No |
| {{< anchor id="no_toe_brake_input_smoothing" />}}`no_toe_brake_input_smoothing` | Whether to disable (TRUE, 1) or not (FALSE, 0) input smoothing for toe brakes.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="toe_brakes_pressure_increment" />}}`toe_brakes_pressure_increment` | This value defines the maximum pressure that will be applied by the toe-brakes when used, expressed as a {{< glossterm >}}percent_over_100{{< /glossterm >}}.<span></span>Default value is 0.033. | Float | No |
| {{< anchor id="toe_brakes_pressure_release_delay" />}}`toe_brakes_pressure_release_delay` | This value sets the time (in seconds) after which the toe-brake pressure will start to decay.<span></span>Default value is 0.25. | Float | No |
| {{< anchor id="toe_brakes_pressure_decrease_tc" />}}`toe_brakes_pressure_decrease_tc` | This value is the time constant (factor) that will be used to determine the speed at which toe-brake pressure will decay.<span></span>Default value is 3.0 | Float | No |
| {{< anchor id="parking_brake_linked_to_toe_brakes" />}}`parking_brake_linked_to_toe_brakes` | This parameter governs whether the parking brake will release upon application of the toe brakes.<span></span>Default value is 1 (TRUE), but a setting of 0 (FALSE) will prevent this behavior. | Bool | No |
| {{< anchor id="hydraulic_system_scalar" />}}`hydraulic_system_scalar` | On brakes dependent on the hydraulic system, this is the ratio of hydraulic system to maximum brake hydraulic pressure.<span></span>Default value is 0. | Float | No |
| {{< anchor id="show_brake_message" />}}`show_brake_message` | Whether to show the braking message (TRUE, 1) or not (FALSE, 0) in the UI.<span></span>Default value is 1 (TRUE). | Bool | No |
| {{< anchor id="auto_brakes" />}}`auto_brakes` | The number of autobrakes available (0 means no autobrakes).<span></span>Default value is 0. | Integer | No |
| {{< anchor id="autobrakes_disabled_on_takeoff" />}}`autobrakes_disabled_on_takeoff` | Whether the autobrake is disabled (TRUE, 1) or not (FALSE, 0) for takeoff.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="autobrakes_requires_antiskid" />}}`autobrakes_requires_antiskid` | Whether the autobrake systems require anti-skid (TRUE, 1) or not (FALSE, 0).<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="autobrakes_disabled_on_braking" />}}`autobrakes_disabled_on_braking` | Whether the autobrake is disabled (TRUE, 1) or not (FALSE, 0) when manually braking.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="autobrakes_disabled_on_thrust" />}}`autobrakes_disabled_on_thrust` | Whether the autobrake is disabled (TRUE, 1) or not (FALSE, 0) on reverse thrust.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="autobrakes_disabled_on_stop" />}}`autobrakes_disabled_on_stop` | Whether the autobrake is disabled (TRUE, 1) or not (FALSE, 0) when the plane stops after a landing.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="rto_disabled_on_stop" />}}`rto_disabled_on_stop` | Whether the autobrake is automatically disabled (TRUE, 1) or not (FALSE, 0) when the aircraft stops after an {{< glossterm >}}RTO{{< /glossterm >}}.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="rto_disabled_on_takeoff" />}}`rto_disabled_on_takeoff` | Whether the autobrake is disabled (TRUE, 1) or not (FALSE, 0) for an {{< glossterm >}}RTO{{< /glossterm >}}.<span></span>Default value is 0 (FALSE). | Bool | No |
| {{< anchor id="rto_min_speed_for_trigger" />}}`rto_min_speed_for_trigger` | This sets the minimum speed (in {{< glossterm >}}Knots{{< /glossterm >}}) at which an {{< glossterm >}}RTO{{< /glossterm >}} will be activated when moving all throttles to idle.<span></span>Default value is 85. | Float | No |

{{< /table-wrapper >}}


### [GEAR_WARNING_SYSTEM]

This section defines the functionality of the gear warning system for the aircraft. This is generally related to the throttle lever position and the flap deflection. Available parameters are:

{{< table-wrapper "250px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="gear_warning_available" />}}`gear_warning_available` | Sets the type of gear warning system available on the aircraft. | Integer:<span></span>{{< params/smallfont >}}0 = None<span></span>1 = Normal<span></span>2 = Amphibian<span></span>(audible alert for water vs. land setting){{< /params/smallfont >}} | Yes |
| {{< anchor id="pct_throttle_limit" />}}`pct_throttle_limit` | The throttle limit, below which the gear warning will activate if the gear is not down and locked while the flaps are deflected to at least the setting for [`flap_limit_idle`](#flap_limit_idle) below. This flap limit can be 0 so that the warning effectively is a function of the throttle. A value between: 0 (idle) and 1.0 (Max throttle).<span></span>Default value is 0. | Float | No |
| {{< anchor id="flap_limit_idle" />}}`flap_limit_idle` | This limit is the flap deflection above which the warning will activate if the gear is not down and locked while the throttle is below the limit specified by [`pct_throttle_limit`](#pct_throttle_limit). Setting this limit to a value greater than 0, the pilot can reduce the throttle to idle without activating the warning (this is often utilized in jets to decelerate/descend the aircraft).<span></span>Default value is 0. | Float | No |
| {{< anchor id="flap_limit_power" />}}`flap_limit_power` | The flap limit, above which the warning will activate (regardless of throttle position).<span></span>Default value is 0. | Float | No |

{{< /table-wrapper >}}


### [LIGHTS]

This section controls the lights on the aircraft. The given index value can then be passed to the corresponding light SimVar to apply a different behavior to different lights. Note that there is an additional option in [The SimObject Editor](../../../devmode/editors/simobject-editor/the-simobject-editor/) to enable/disable the light in the simulation for testing, but this option is *not* included in the associated CFG file: **Turn Light On** / **Off**. This option will *only* work if  is enabled:

{{< image-center
    src="images/5_Content_Config/CFGs/system/system_1_lights.png"
    alt="Enable / Disable A Light Using Live Edition" >}}

Available parameters are:

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="lightdef.N" />}}`lightdef.N` | Each light has it's own definition as a hash map (explained below) where each item in the table has it's own definition. Lights are numbered from 0. | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

The hash map that each light takes is comprised of the following `key:value` pairs, separated by the `#` symbol:

{{< table-wrapper "160px" "200px" "" "100px" >}}

| Key | Value | Description | Required |
|---|---|---|:---:|
| {{< anchor id="Name" />}}`Name` | String | This is a name string that is used as an alias to identify the light. It will also be used as the reference index for SimVars, and note that the name is the only guaranteed reference to the component due to the fact that the [Modular Aircraft Merging](../../modular-simobjects/modular-simobject-merging/) process may change the index. The name cannot contain special characters or spaces. Note that this can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | Yes |
| {{< anchor id="Type" />}}`Type` | Integer:<span></span>{{< params/smallfont >}}1 = Beacon<span></span>2 = Strobe<span></span>3 = Navigation or Position<span></span>4 = Panel (Interior only)<span></span>5 = Landing<span></span>6 = Taxi<span></span>7 = Recognition<span></span>8 = Wing<span></span>9 = Logo<span></span>10 = Cabin (Interior only)<span></span>11 = Pedestal (Interior only)<span></span>12 = Glareshield (Interior only)<span></span>13 = Ambient{{< /params/smallfont >}} | Tells the sim what type of light is being defined for the aircraft.<span></span>Note that the *ambient* light type is *not* connected to a circuit type and you have to write to their [LIGHT_POTENTIOMETER](../../../programming-apis/simvars/aircraft-simvars/aircraft-system-variables/#LIGHT_POTENTIOMETER) SimVar to control them. These lights are also *only for use in the cockpit* and may not work elsewhere. | Yes |
| {{< anchor id="Index" />}}`Index` | Integer | This is the index of the electrical `circuit.N` that controls the light. Note that the value is the **type** index for the circuit, not the circuit index itself. Also note that if you set an index of 0 - or omit this key from the map - then the light will be part of the "general" circuit, meaning that a change to **any** light circuit will affect *all *lights with index 0 (or no defined index). | No |
| {{< anchor id="LocalPosition" />}}`LocalPosition` | [List](../cfg-files-general-information/#list) of 3 values: z, x, y | The local position offset relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point). Values are in {{< glossterm >}}ft{{< /glossterm >}}. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | Yes |
| {{< anchor id="LocalRotation" />}}`LocalRotation` | [List](../cfg-files-general-information/#list) of 3 values: x, y, z | The local angle of rotation for the light. Values are in degrees from -360° to 360°. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | Yes |
| {{< anchor id="EffectFile" />}}`EffectFile` | FX file ID | The [FX file](../system/light-fx-properties/) that describes the light. These files have `*.fx` extensions and should be placed in the root effects folder of the preset/common/attachment. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled.<span></span>For more information, please see here: [Implementing Lights](../system/implementing-lights/)<span></span>It should be noted that you do not have to create your own `*.fx` files and can use "common" light effects instead. For that you simply give the name of one of the `*.fx` files found in the common effects folder. For more information on these common effects, please see here: [Common *.FX Files](../system/light-fx-properties/#common-fx-files) | Yes |
| {{< anchor id="Node" />}}`Node` | Node name | The aircraft node to which you attach the light. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | No |
| {{< anchor id="PotentiometerIndex" />}}`PotentiometerIndex` | Integer | This drives the intensity of the light indexed when using the SimVar `LIGHT_POTENTIOMETER`. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | Yes |
| {{< anchor id="EmMesh" />}}`EmMesh` | File ID | The name of the emissive mesh to use. Note that the material used for the mesh must be named LIGHTS and use the [Standard](../../../models-and-textures/textures/materials/flightsim-materials/#standard) material type. This parameter can be edited directly in the simulation when [Live Edition](../../../devmode/editors/simobject-editor/the-simobject-editor/#edition-information-live-edition) is enabled. | No |
| {{< anchor id="EmMeshMaterialName" />}}`EmMeshMaterialName` | String | The name of the material that the emissive mesh uses. | No |

{{< /table-wrapper >}}

Below you can see an example of a light definition:

``` cpp
lightdef.18 = Name:light_strobe Type:4 #Index:0 #LocalPosition:-1.2,0.65,14.0 #LocalRotation:0,0,0 #EffectFile:fx_cockpit_small_yellow, #PotentiometerIndex:2
```

It is worth noting that we have a page giving an overview of how lights should be setup from the following link:

-   [Implementing Lights](../system/implementing-lights/)


#### Legacy Lights

When working with legacy aircraft from before MSFS 2020 (for example) you will find that lights were defined slightly differently. Here we explain the format used for those lights, but for new aircraft **you should be using the `lightdef.N` parameter**.

Legacy lights are defined using the following parameter:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="light.N" />}}<span class="legacy">`light.N`</span> | This is a light definition comprised of a list of values. Lights are numbered from 0. | [List](../cfg-files-general-information/#list) of Values | No |

{{< /table-wrapper >}}

The table for these lights takes 8 entries, listed below:

{{< table-wrapper "100px" "" "150px" "100px" >}}

| Position | Description | Type | Required |
|---|---|---|:---:|
| 0 | This defines which circuit, or switch, the light is connected to. Multiple lights may be connected to a single switch. | Integer:<span></span>{{< params/smallfont >}}1 = Beacon<span></span>2 = Strobe<span></span>3 = Navigation or Position<span></span>4 = Panel<span></span>5 = Landing<span></span>6 = Taxi<span></span>7 = Recognition<span></span>8 = Wing<span></span>9 = Logo<span></span>10 = Cabin<span></span>11 = Pedestal<span></span>12 = Glareshield<span></span>13 = Ambient{{< /params/smallfont >}} | Yes |
| 1 | The z position relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point), in {{< glossterm >}}ft{{< /glossterm >}}. | Float | Yes<span></span>{{< params/smallfont >}}(unless a [node](#light-nodes) is specified){{< /params/smallfont >}} |
| 2 | The x position relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point), in {{< glossterm >}}ft{{< /glossterm >}}. | Float | Yes<span></span>{{< params/smallfont >}}(unless a [node](#light-nodes) is specified){{< /params/smallfont >}} |
| 3 | The y position relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point), in {{< glossterm >}}ft{{< /glossterm >}}. | Float | Yes<span></span>{{< params/smallfont >}}(unless a [node](#light-nodes) is specified){{< /params/smallfont >}} |
| 4 | The X axis rotation, in degrees. | Float | No |
| 5 | The Y axis rotation, in degrees. | Float | No |
| 6 | The Z axis rotation, in degrees. | Float | No |
| 7 | The FX file name that is used by this light (for example, fx_navred). These files have `*.fx` extensions and should be placed in the root effects folder. | String | Yes |

{{< /table-wrapper >}}

{{< anchor id="light-nodes" >}}{{< /anchor >}}When writing out a light definition, you may specify a node on the aircraft model instead of the (z/x/y) position, and omit or include the rotation parameters depending on requirements. Below are examples of various combinations of data you can use to define a light:

```cpp
; light.n = CircuitType, NODE_HELPER_NAME, fxfile
light.0 = 3, light_navigation_node, fx_navred

; light.n = CircuitType, ZOffset, XOffset, YOffset, XRotationInDegrees, YRotationInDegrees, ZRotationInDegrees, fxfile
light.0 = 3, -2.6, -17.4, 3.6, 90.0, 0.0, 0.0, fx_navred

; light.n = CircuitType, NODE_HELPER_NAME, XRotationInDegrees, YRotationInDegrees, ZRotationInDegrees, fxfile
light.0 = 3, light_navigation_node, 90.0, 0.0, 0.0, fx_navred
```


### [NIGHT_VISION]

This section defines whether the aircraft pilot has access to night vision goggles or not when flying the aircraft. The available parameters are as follows:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Available-NIGHT_VISION" />}}`Available` | When set to 1 (True), the pilot will have night vision available to them If set to 0 (false) they will not.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="Intensity" />}}`Intensity` | This is used to set the intensity of the night vision effect, which will primarily affect how bright any lights will be in the view. Value should be between 0 and 300, with a recommended setting somewhere between 200 and 300.<span></span>Default value is 300. | Float | No |

{{< /table-wrapper >}}


### [ELECTRICAL]

This section controls everything related to the aircraft electrical systems. The electrical system is **modular** in nature and is based on a combination of *component*, *configuration*, and *connection* parameters. This section also has the following parameters that can be used to select a specific version of the system to be used, and requires *both* the major and minor values to be set, eg:

``` cpp
[ELECTRICAL]
Major=2
Minor=1
```

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Major" />}}`Major` | What version of the electrical system you are using. Can be one of the following:<span></span>{{< params/smallfont >}}**0.0**: This is for aircraft using the legacy FSX electrical system. When using this version, only the parameters listed below are used, and none of the components.<span></span>**1.0**: This should be used for those aircraft imported from Microsoft Flight Simulator 2020. When using this version, only the parameters and components [listed here](../system/legacy-electrical-system/) can be used to define the electrical system.<span></span>**2.0**: This is the first iteration of the full Microsoft Flight Simulator 2024 modular electrical system.<span></span>2.1: This version has changes to the way that breakers are handled to fix an issue where they were on a line leading to a bus (typically bus-to-bus or supplier-to-bus) but didn't get any load, and weren't tripping.<span></span>2.2: This version fixes the electrical SimVars ignoring the unit requested by the user and always using the default one.{{< /params/smallfont >}} | Integer | Yes |
| {{< anchor id="Minor" />}}`Minor` | What minor version of the electrical system you are using. See the `Major` description for details. | Integer | Yes |

{{< /table-wrapper >}}

An electrical system is defined by its main **components**, of which there are multiple types:


{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="circuit.N" />}}`circuit.N` | Defines one or more electrical circuits. A circuit consumes power, requiring current to function (see [Circuits](../../../programming-apis/simvars/aircraft-simvars/aircraft-electrics-variables/#circuits) for governing SimVars).<span></span>Details on the circuit map contents are given here: [circuit.N](../system/modular-electrical-system-information/#circuitn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="battery.N" />}}`battery.N` | This defines one or more batteries to be used in the electrical system. A battery is a power source with a set capacity in ampere hours (see [Batteries](../../../programming-apis/simvars/aircraft-simvars/aircraft-electrics-variables/#batteries) for governing SimVars).<span></span>Details on the battery map contents are given here: [battery.N](../system/modular-electrical-system-information/#batteryn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="externalpower.N" />}}`externalpower.N` | Defines one or more external power sources that form a part of the electrical system. This external power source will delivers power for as long as it is available (see [External Power](../../../programming-apis/simvars/aircraft-simvars/aircraft-electrics-variables/#external-power) for governing SimVars).<span></span>Details on the external power map contents are given here: [externalpower.N](../system/modular-electrical-system-information/#externalpowern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="generator.N" />}}`generator.N` | Defines one or more generators that form a part of the electrical system. A generator is a power source inside the aircraft which will deliver power for as long as it is available (see [Generators](../../../programming-apis/simvars/aircraft-simvars/aircraft-electrics-variables/#generators).<span></span>Details on the tank map contents are given here: [generator.N](../system/modular-electrical-system-information/#generatorn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="bus.N" />}}`bus.N` | Defines one or buses that form a part of the electrical system. A bus is a component that connects lines and other components within the electrical system (see [General / Buses](../../../programming-apis/simvars/aircraft-simvars/aircraft-electrics-variables/#general--buses) for governing SimVars).<span></span>Note that only buses may have multiple lines connected to them (all other components can only have *one* line connection).<span></span>Details on the bus map contents are given here: [bus.N](../system/modular-electrical-system-information/#busn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="relay.N" />}}`relay.N` | Defines one or relays that form a part of the electrical system. A relay is a component that can be used to connect/disconnet another line depending on whether the relay is powered or not.<span></span>Details on the bus map contents are given here: [relay.N](../system/modular-electrical-system-information/#relayn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

To help with the configuration of the components you have **configuration** items:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="supplier.N" />}}`supplier.N` | Defines the attributes of a source supplier of power, either **AC**, **DC**, or a **Battery**.<span></span>Details on the supplier map contents are given here: [supplier.N](../system/modular-electrical-system-information/#suppliern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="consumer.N" />}}`consumer.N` | Defines the attributes of power consumer (Battery or Custom).<span></span>Details on the consumer map contents are given here: [consumer.N](../system/modular-electrical-system-information/#consumern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="curve.N" />}}`curve.N` | A curve is defined as a list of paired values that can be used by other components.<span></span>Details on the curve map contents are given here: [curve.N](../system/modular-electrical-system-information/#curven) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

Finally you have the **connection** components:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="line.N" />}}`line.N` | A line is used to connect two components based on the assigned connection attributes. Each component can only have one line connection, unless it is a [Bus](../system/modular-electrical-system-information/#busn), which can have more.<span></span>Details on the line map contents are given here: [line.N](../system/modular-electrical-system-information/#linen) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="connection.N" />}}`connection.N` | A connection defines the behaviour of electricity when passed through a line.<span></span>Details on the connection map contents are given here: [connection.N](../system/modular-electrical-system-information/#connectionn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="breaker.N" />}}`breaker.N` | A breaker is used to protect components from current overflow, and is used as part of the definition of a [Connection](../system/modular-electrical-system-information/#connectionn).<span></span>Details on the breaker map contents are given here: [breaker.N](../system/modular-electrical-system-information/#breakern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="transformer.N" />}}`transformer.N` | A transformer modifies the output voltage, and is used as part of the definition of a [Connection](../system/modular-electrical-system-information/#connectionn).<span></span>Details on the transformer map contents are given here: [transformer.N](../system/modular-electrical-system-information/#transformern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="diode.N" />}}`diode.N` | A diode is used to direct the flow of electricity in a single direction along the line, and is used as part of the definition of a [Connection](../system/modular-electrical-system-information/#connectionn).<span></span>Details on the diode map contents are given here: [diode.N](../system/modular-electrical-system-information/#dioden) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}


### [HYDRAULIC_SYSTEM]<span class="legacy"></span>

This section controls the hydraulic pressure systems.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This section is **only** for legacy Microsoft Flight Simulator 2020 aircraft, and for all new aircraft you should instead be using the `[HYDRAULICS_SYSTEM_EX1]` parameters. Note that you cannot use both this system and the modern system in the same aircraft.

{{< /callout >}}

Available parameters are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="normal_pressure" />}}<span class="legacy">`normal_pressure`</span> | The normal hydraulic pressure, in {{< glossterm >}}psi{{< /glossterm >}}.<span></span>Default value is 0. | Float | No |
| {{< anchor id="electric_pumps" />}}<span class="legacy">`electric_pumps`</span> | The number of electric pumps for the hydraulics.<span></span>Default value is 0. | Integer | No |
| {{< anchor id="engine_map-HYDRAULIC_SYSTEM" />}}<span class="legacy">`engine_map`</span> | This is a table of whether an engine has a hydraulic unit or not.<span></span>For example:<span></span>`1, 0, 0, 1, 0, 0, 0 ,0 ,0, 0, 0, 0, 0, 0, 0, 0, 0`<span></span>This means there are pumps on engines 1 and 4, but not on any other.<span></span>Default value is 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0. | [List](../cfg-files-general-information/#list) of bools | No |
| {{< anchor id="ailerons_require_hydraulics" />}}<span class="legacy">`ailerons_require_hydraulics`</span> | Sets whether the ailerons require hydraulics (TRUE, 1) or not (FALSE, 0).<span></span>Default is 0 (FALSE). | Bool | No |
| {{< anchor id="rudder_require_hydraulics" />}}<span class="legacy">`rudder_require_hydraulics`</span> | Sets whether the rudder requires hydraulics (TRUE, 1) or not (FALSE, 0).<span></span>Default is 0 (FALSE). | Bool | No |
| {{< anchor id="spoilers_require_hydraulics" />}}<span class="legacy">`spoilers_require_hydraulics`</span> | Sets whether the spoilers require hydraulics (TRUE, 1) or not (FALSE, 0).<span></span>Default is 0 (FALSE). | Bool | No |
| {{< anchor id="elevator_require_hydraulics" />}}<span class="legacy">`elevator_require_hydraulics`</span> | Sets whether the elevator requires hydraulics (TRUE, 1) or not (FALSE, 0).<span></span>Default is 0 (FALSE). | Bool | No |

{{< /table-wrapper >}}


### [HYDRAULICS_SYSTEM_EX1]

This section controls everything related to the aircraft hydraulics system. The hydraulics system is **modular** in nature and is based on a combination of *components*, that are connected by *lines*, and each line can have special *line features*.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This section is required for all modern aircraft, and only legacy Microsoft Flight Simulator 2020 aircraft should use the less comprehensive <span class="legacy">`[HYDRAULIC_SYSTEM]`</span> section. Also note that you cannot use both systems in the same aircraft.

{{< /callout >}}

Apart from components and line features, you also have the following parameter that is used to tell the simulation which version of the hydraulics system is being used:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Version-HYDRAULICS_SYSTEM_EX1" />}}`Version` | What version of the hydraulic system you are using. Can be one of the following:<span></span>{{< params/smallfont >}}**0**: Should not be used, and has no meaning.<span></span>**1**: The initial implementation of the hydraulics system.<span></span>**2**: Exposes the actuator `DropPressure` parameter and changes its default value to 10% of `MinimalPressure` (previously the *internal* default was 0%).<span></span>**Latest**: The most up to date version of the system, which may contain breaking changes.{{< /params/smallfont >}} | Integer / String | Yes |

{{< /table-wrapper >}}

A hydraulic system is defined by its main **components**, of which there are multiple types:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Reservoir.N" />}}`Reservoir.N` | The reservoir is a tank that stores hydraulic fluid as part of the hydraulic system.<span></span>Details on the reservoir map contents are given here: [Reservoir.N](../system/modular-hydraulics-system-information/#reservoirn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Pump.N" />}}`Pump.N` | A pump is used as part of the hydraulics to pressurise the system.<span></span>Details on the pump map contents are given here: [Pump.N](../system/modular-hydraulics-system-information/#pumpn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="PTU.N" />}}`PTU.N` | The PTU (Power Transfer Unit) is a hydraulic pump that uses the fluid under pressure from one circuit to run and pressurize another circuit without exchanging fluid.<span></span>Details on the PTU map contents are given here: [PTU.N](../system/modular-hydraulics-system-information/#ptun) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Actuator.N" />}}`Actuator.N` | This component acts as the link between the hydraulic system and the other aircraft parts.<span></span>Details on the actuator map contents are given here: [Actuator.N](../system/modular-hydraulics-system-information/#actuatorn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Junction.N-HYDRAULICS_SYSTEM_EX1" />}}`Junction.N` | A junction forms a crossroad for various lines to go through.<span></span>Details on the junction map contents are given here: [Junction.N](../system/modular-hydraulics-system-information/#junction) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Line.N-HYDRAULICS_SYSTEM_EX1" />}}`Line.N` | These define how all the components are linked to one another.<span></span>Details on the line map contents are given here: [Line.N](../system/modular-hydraulics-system-information/#linen) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Trigger.N" />}}`Trigger.N` | These define trigger events which can control several parts of the system based on specific situations.<span></span>Details on the line map contents are given here: [Trigger.N](../system/modular-hydraulics-system-information/#triggern) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

Additionally, you can add the following **line features** to the system lines:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Accumulator.N" />}}`Accumulator.N` | This line feature stores hydraulic fluid under pressure to be able to deliver at least a certain amount of fluid in the case of a system failure.<span></span>Details on the accumulator map contents are given here: [Accumulator.N](../system/modular-hydraulics-system-information/#accumulatorn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Valve.N-HYDRAULICS_SYSTEM_EX1" />}}`Valve.N` | This line feature is used to control the flow of hydraulic fluid through the system.<span></span>Details on the valve map contents are given here: [Valve.N](../system/modular-hydraulics-system-information/#valven) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

Each of the components listed above can be defined multiple times as parameters within the [HYDRAULICS_SYSTEM_EX1] configuration header. You can find more information on setting up the hydraulics system form the following page:

- [Hydraulics System Setup Information](../system/modular-hydraulics-system-information/)

And you can find examples of use here:

- [Hydraulic System Examples](../system/hydraulic-system-examples/)


### [PNEUMATIC_SYSTEM]<span class="legacy"></span>

This section controls the pneumatic system of the aircraft.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This section is **only** for legacy Microsoft Flight Simulator 2020 aircraft, and for all new aircraft you should instead be using the `[PNEUMATIC_SYSTEM_EX1]` parameters. Note that you cannot use both this system and the modern system in the same aircraft.Available parameters are:

{{< /callout >}}

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="max_pressure-PNEUMATIC_SYSTEM" />}}<span class="legacy">`max_pressure`</span> | The maximum permitted pressure for the pneumatic system, in {{< glossterm >}}psi{{< /glossterm >}}.<span></span>Default value is 0. | Float | No |
| {{< anchor id="apu_max_pressure" />}}<span class="legacy">`apu_max_pressure`</span> | The maximum pressure from the bleed permitted for the {{< glossterm >}}APU{{< /glossterm >}}, in {{< glossterm >}}psi{{< /glossterm >}}.<span></span>Default value is 18. | Float | No |
| {{< anchor id="bleed_air_scalar" />}}<span class="legacy">`bleed_air_scalar`</span> | Pneumatic pressure is a function of bleed air from the turbine engine. This scalar is used to multiply this bleed air pressure.<span></span>Default value is 1. | Float | No |

{{< /table-wrapper >}}


### [PNEUMATIC_SYSTEM_EX1]

This section controls everything related to the aircraft pneumatic systems.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This section is required for all modern aircraft, and only legacy Microsoft Flight Simulator 2020 aircraft should use the less comprehensive `[PNEUMATIC_SYSTEM] ` section. Also note that you cannot use both systems in the same aircraft.

{{< /callout >}}

Apart from components and line features, you also have the following parameters:

{{< table-wrapper "250px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Version-PNEUMATIC_SYSTEM_EX1" />}}`Version` | What version of the hydraulic system you are using. Can be one of the following:<span></span>{{< params/smallfont >}}**1**: The current stable iteration of the system.<span></span>**Latest**: The most up to date version of the system, which may contain breaking changes.{{< /params/smallfont >}} | Integer / String | Yes |
| {{< anchor id="AreasMinTemperature" />}}`AreasMinTemperature` | The lowest temperature (in °C) adjustable on the area knobs in the aircraft cockpit. | Float | Yes |
| {{< anchor id="AreasMaxTemperature" />}}`AreasMaxTemperature` | The highest temperature (in °C) adjustable on the area knobs in the aircraft cockpit. | Float | Yes |
| {{< anchor id="MaxDifferencialPressure" />}}`MaxDifferencialPressure` | The maximum difference of pressure allowed between the aircraft cabin and the ambient air outside, in {{< glossterm >}}psi{{< /glossterm >}}.<span></span>Default value is 8.6. | Float | No |
| {{< anchor id="AreasMaxTemperatureInput" />}}`AreasMaxTemperatureInput` | The maximum temperature (°C) allowed to be pushed in the areas to avoid discomfort to the people inside of them.<span></span>Default value is 70. | Float | No |

{{< /table-wrapper >}}

A pneumatic system is defined by its main **components**, of which there are multiple types:

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="APU.N" />}}`APU.N` | An auxiliary source of power providing airflow to turn on the engines or airflow to the main system in case of emergency.<span></span>Details on the APU map contents are given here: [APU](../system/modular-pneumatics-system-information/#apun) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Engine.N" />}}`Engine.N` | Primary engine providing air flow to the system.<span></span>Details on the engine map contents are given here: [Engine](../system/modular-pneumatics-system-information/#enginen) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="RamAir.N" />}}`RamAir.N` | A source of air flow that is based on the aircraft speed.<span></span>Details on the ram-air map contents are given here: [RamAir](../system/modular-pneumatics-system-information/#ramairn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="ExternalUnit.N" />}}`ExternalUnit.N` | A source of air flow that is based on the aircraft speed.<span></span>Details on the ram-air map contents are given here: [ExternalUnit](../system/modular-pneumatics-system-information/#externalunitn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Pack.N" />}}`Pack.N` | This component takes the bleed air coming from the engines and cools it.<span></span>Details on the pack map contents are given here: [Pack](../system/modular-pneumatics-system-information/#packn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="MixerUnit.N" />}}`MixerUnit.N` | This component receives all the air flow coming from the packs, ram air, and the loop coming back from the areas, and then mixes them all together before sending the result into the areas.<span></span>Details on the mixer unit map contents are given here: [MixerUnit](../system/modular-pneumatics-system-information/#mixerunitn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Area.N" />}}`Area.N` | A zone of the aircraft into which air will be routed (cockpit, cabin, etc…).<span></span>Details on the area map contents are given here: [Area](../system/modular-pneumatics-system-information/#arean) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Outlet.N" />}}`Outlet.N` | This component allows other systems to be fed air from the pneumatic system. These are systems that might be using air flow as a primary power source or as an emergency one, like wing deicing or brakes.<span></span>Details on the outlet map contents are given here: [Outlet](../system/modular-pneumatics-system-information/#outletn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Junction.N-PNEUMATIC_SYSTEM_EX1" />}}`Junction.N` | A junction forms a crossroad for various lines to go through.<span></span>Details on the junction map contents are given here: [Junction](../system/modular-pneumatics-system-information/#junctionn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Line.N-PNEUMATIC_SYSTEM_EX1" />}}`Line.N` | These define how all the components are linked to one another.<span></span>Details on the line map contents are given here: [Line](../system/modular-pneumatics-system-information/#linen) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Curve.N-PNEUMATIC_SYSTEM_EX1" />}}`Curve.N` | Used to define the engine temperature output(s).<span></span>Details on the curve map contents are given here: [Curve](../system/modular-pneumatics-system-information/#curven) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}

Additionally, you can add the following **line features** to the system lines:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Fan.N" />}}`Fan.N` | This line feature is used to create pressure difference (and thus, flow) in a line.<span></span>Details on the fan map contents are given here: [Fan](../system/modular-pneumatics-system-information/#fann) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Valve.N-PNEUMATIC_SYSTEM_EX1" />}}`Valve.N` | This line feature will limit the air flow going through it.<span></span>Details on the valve map contents are given here: [Valve](../system/modular-pneumatics-system-information/#valven) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}


### [VACUUM_SYSTEM]

This section controls the aircraft vacuum system. Vacuum system suction is controlled by the `[PNEUMATIC_SYSTEM_EX1]` section, specifically the `Outlet.N` hash map.

Available parameters are:

{{< table-wrapper "250px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="max_pressure-VACUUM_SYSTEM" />}}`max_pressure` | The maximum suction pressure, in {{< glossterm >}}inHg{{< /glossterm >}}.<span></span>Default value is 0. | Float | No |
| {{< anchor id="vacuum_type" />}}`vacuum_type` | The type of vacuum system installed on the aircraft.<span></span>Default value is 1. | Integer:<span></span>{{< params/smallfont >}}1 = engine pump<span></span>2 = pneumatic<span></span>3 = venturi{{< /params/smallfont >}} | No |
| {{< anchor id="electric_backup_pressure" />}}`electric_backup_pressure` | The electrical backup pressure value, in {{< glossterm >}}inHg{{< /glossterm >}}.<span></span>Default value is 0. | Float | No |
| {{< anchor id="engine_map-VACUUM_SYSTEM" />}}`engine_map` | This is a table of whether an engine has a vacuum pump unit or not.<span></span>For example:<span></span>`1, 0, 0, 1, 0, 0, 0 ,0 ,0, 0, 0, 0, 0, 0, 0, 0, 0`<span></span>This means there are pumps on engines 1 and 4, but not on any other.<span></span>Default value is 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0. | [List](../cfg-files-general-information/#list) of bools | No |
| {{< anchor id="suction_gain" />}}`suction_gain` | Speed at which suction grows.<span></span>Default value is 0.85. | Float | No |
| {{< anchor id="suction_min" />}}`suction_min` | Minimum suction value possible when system is operating.<span></span>Default value is 4.05. | Float | No |

{{< /table-wrapper >}}


### [PITOT_STATIC]

A pitot-static system is a system of pressure-sensitive instruments that is most often used in aviation to determine an aircraft's airspeed, Mach number, altitude, and altitude trend. This section permits you to set certain attributes for using this system. Available parameters are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="vertical_speed_time_constant" />}}`vertical_speed_time_constant` | This is a speed-time constant, used for the vertical speed generation in gauges. Values in 1/seconds. Increasing will cause a more instantaneous reaction in the visual speed indicator | Float | Yes |
| {{< anchor id="pitot_heat" />}}`pitot_heat` | Pitot heat scalar value used to weight temperature increase for pitot system. | Float | Yes |

{{< /table-wrapper >}}


### [STALL_WARNING]

This section controls the stall warning system. Available parameters are:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="type" />}}`type` | The warning system type.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 = normal<span></span>1 = electric{{< /params/smallfont >}} | No |
| {{< anchor id="stick_shaker" />}}`stick_shaker` | Whether force feedback stick shaking is enabled (TRUE, 1) or not (FALSE, 0). | Bool | No |

{{< /table-wrapper >}}


### [DEICE_SYSTEM]

This section controls the de-ice system. Available parameters are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="structural_deice_type" />}}`structural_deice_type` | The deice type on the aircraft.<span></span>Note that if the structural deice type is set to "Electrical" (4), then it is *always* linked to the first defined circuit of the type `CIRCUIT_DEICE`, and will only run if this circuit is switched on.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 = none<span></span>1 = bleed air heated leading edge<span></span>2 = bleed air boots<span></span>3 = engine vacuum pump boots<span></span>4 = Electrical{{< /params/smallfont >}} | No |
| {{< anchor id="windshield_deice_rate" />}}`windshield_deice_rate` | Sets the rate at which the windshield will get deiced when the deice system is enabled. Value is in percent/second.<span></span>Default value is 0.00223 %/sec. | Float | No |
| {{< anchor id="structural_deice_rate" />}}`structural_deice_rate` | Sets the rate at which the aircraft structure will get deiced when the deice system is enabled. Value is in percent/second.<span></span>**NOTE**: If the deice system is **electrical** you should be using the `structural_electrical_deice_rate` parameter instead of this one.<span></span>Default value is 0.00128 %/sec. | Float | No |
| {{< anchor id="structural_electrical_deice_rate" />}}`structural_electrical_deice_rate` | Sets the rate at which the aircraft structure will get deiced when the deice system is enabled. Value is in percent/second.<span></span>**NOTE**: This parameter is only used if the deice system is **electrical**. If it's not then you should be using the `structural_deice_rate` parameter instead of this one.<span></span>Default value is 0.0005 %/sec. | Float | No |

{{< /table-wrapper >}}


### [RADIOS]

This section controls the aircraft radios. Note all systems listed here start at `N` = 1, and the available parameters are:

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="TransponderDefault" />}}`TransponderDefault` | Default Frequency of the aircraft (will be overridden by FLT and ATC values).<span></span>Default value is 1234. | Float | No |
| {{< anchor id="Flarm" />}}`Flarm` | The distance below which the FLARM system will detect threat objects, in meters. If set to -1 the system is disabled.<span></span>Default value is -1. | Float | No |
| {{< anchor id="Tcas" />}}`Tcas` | Sets the status of the TCAS system, where:<span></span>{{< params/smallfont >}}If set to >1 the TCAS mode will be set to Auto<span></span>If set to 1 the TCAS mode will be set to XPNDR<span></span>If set to 0 the TCAS mode will be set to Standby{{< /params/smallfont >}}<span></span>Default value is 1. | Float | No |
| {{< anchor id="Audio.N" />}}`Audio.N` | Set whether audio system `N` is available (TRUE, 1) or not (FALSE, 0). Note that only 1 audio panel can be defined, and further definitions will be ignored by the simulation currently. | Bool | Yes |
| {{< anchor id="Com.N" />}}`Com.N` | Set whether the com receiver `N` is available (TRUE, 1) or not (FALSE, 0) and whether it has a standby (TRUE, 1) or not (FALSE, 0). At least 1 com receiver needs to be defined, and you can have a maximum of 3. | [List](../cfg-files-general-information/#list) of Bools | Yes |
| {{< anchor id="Nav.N" />}}`Nav.N` | Set whether the navigation receiver `N` is available (TRUE, 1) or not (FALSE, 0), whether it has a standby (TRUE, 1) or not (FALSE, 0), and whether it has glide-slope (TRUE, 1) or not (FALSE, 0). At least 1 navigation receiver needs to be defined, and you can have a maximum of 4. | [List](../cfg-files-general-information/#list) of Bools | Yes |
| {{< anchor id="Adf.N" />}}`Adf.N` | Set whether the {{< glossterm >}}ADF{{< /glossterm >}} system `N` is available (TRUE, 1) or not (FALSE, 0) and whether it has a standby (TRUE, 1) or not (FALSE, 0). At least 1 {{< glossterm >}}ADF{{< /glossterm >}} system needs to be defined, and you can have a maximum of 2. | [List](../cfg-files-general-information/#list) of Bools | Yes |
| {{< anchor id="Transponder.N" />}}`Transponder.N` | Set whether the transponder `N` is available (TRUE, 1) or not (FALSE, 0). Only 1 transponder can be defined, and further definitions will be ignored by the simulation currently. Note that if the electrical system does not have a `CIRCUIT_XPNDR` [circuit](../system/modular-electrical-system-information/#circuitn) then the transponder will always work and be powered. | Bool | Yes |
| {{< anchor id="Marker.N" />}}`Marker.N` | Set whether the marker system `N` is available (TRUE, 1) or not (FALSE, 0). Note that only 1 marker can be defined, and further definitions will be ignored by the simulation currently. | Bool | Yes |
| {{< anchor id="Tacan.N" />}}`Tacan.N` | Set whether {{< glossterm >}}Tacan{{< /glossterm >}} *`N`* is available, where `N` can be 1 or 2 (only a maximum of 2 {{< glossterm >}}Tacan{{< /glossterm >}} systems can be on any aircraft).<span></span>When you add this parameter it requires two values where the first sets whether the **active** frequency is available (1, TRUE) or not (0, FALSE) and the second sets whether the **standby** frequency is available (1, TRUE) or not (0, FALSE). For example:<span></span>`Tacan.1 = 1, 0`<span></span>The line above adds the first {{< glossterm >}}Tacan{{< /glossterm >}} receiver with an active frequency and no standby frequency. | [List](../cfg-files-general-information/#list) of Bools | No |

{{< /table-wrapper >}}


### [AUTOPILOT]

This section controls the aircraft autopilot systems for both planes and helicopters.

The available parameters for **planes** are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="autopilot_available-AUTOPILOT" />}}`autopilot_available` | Setting this to 1 (TRUE) makes the autopilot system available to the aircraft, otherwise set it to 0 (FALSE) to disable autopilot. | Bool | Yes |
| {{< anchor id="flight_director_available-AUTOPILOT" />}}`flight_director_available` | Setting this to 1 (TRUE) makes the flight director available to the aircraft, otherwise setting it to 0 (FALSE) will disable the flight director. | Bool | Yes |
| {{< anchor id="min_feet_for_ap" />}}`min_feet_for_ap` | Set the height (in {{< glossterm >}}ft{{< /glossterm >}}) below which the autopilot is automatically disabled.<span></span>Default is -1000 (essentially disabled). | Float | No |
| {{< anchor id="min_flight_time_for_ap" />}}`min_flight_time_for_ap` | Set the time (in seconds) after takeoff until the autopilot can be enabled.<span></span>Default is 0 (essentially disabled). | Float | No |
| {{< anchor id="default_vertical_speed" />}}`default_vertical_speed` | The default vertical speed, in {{< glossterm >}}ft{{< /glossterm >}} per second, that the autopilot will command when selecting a large altitude change. | Float | Yes |
| {{< anchor id="autothrottle_available" />}}`autothrottle_available` | When this is set to 1 (TRUE) it makes available an autothrottle system on the aircraft. Set to 0 (FALSE) otherwise.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="autothrottle_arming_required" />}}`autothrottle_arming_required` | When this is set to 1 (TRUE) the autothrottle is required to be armed prior to it being engaged. Setting it to 0 (FALSE) allows the autothrottle to be engaged directly.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="autothrottle_does_not_move_lever" />}}`autothrottle_does_not_move_lever` | When this is set to 1 (TRUE) the autothrottle will not move the throttle lever. Set it to 0 (FALSE) if this is not the behavior you require.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="autothrottle_managed_by_plane" />}}`autothrottle_managed_by_plane` | When this is set to 1 (TRUE) the autothrottle will be managed automatically by the aircraft. Set it to 0 (FALSE) if this is not the behavior you require.<span></span>Default value is 1. | Bool | No |
| {{< anchor id="autothrottle_takeoff_ga" />}}`autothrottle_takeoff_ga` | If this is set to 1 (TRUE) then takeoff / go-around operations with the autothrottle will be enabled. 0 (FALSE) disables this behavior.<span></span>Default value is the value for [`autothrottle_arming_required`](#autothrottle_arming_required). | Float | No |
| {{< anchor id="autothrottle_max_rpm" />}}`autothrottle_max_rpm` | This sets the highest engine speed that the autothrottle will attempt to maintain as a percentage of the maximum engine speed.<span></span>Default value is 90. | Float | No |
| {{< anchor id="auto_throttle_derivative_boundary" />}}`auto_throttle_derivative_boundary` | The derivative gain boundary, a value that can be used to limit the derivative term in the {{< glossterm >}}PID{{< /glossterm >}} controller that drives the behavior of the auto throttle.<span></span>For more information on PIDs please see here: [PID Primer](../../../samples-tutorials/primers/pid-primer/)<span></span>Defaults value is 100. | Float | No |
| {{< anchor id="auto_throttle_derivative_control" />}}`auto_throttle_derivative_control` | The derivative gain, a value that can be use to tune the magnitude of the contribution of the derivative term in the {{< glossterm >}}PID{{< /glossterm >}} controller that drives the behavior of the auto throttle.<span></span>For more information on PIDs please see here: [PID Primer](../../../samples-tutorials/primers/pid-primer/)<span></span>Defaults value is 0.2 | Float | No |
| {{< anchor id="auto_throttle_integrator_boundary" />}}`auto_throttle_integrator_boundary` | The ntegrator gain boundary, a value that can be used to limit the integrator term in the {{< glossterm >}}PID{{< /glossterm >}} controller that drives the behavior of the auto throttle.<span></span>For more information on PIDs please see here: [PID Primer](../../../samples-tutorials/primers/pid-primer/)<span></span>Defaults value is 5. | Float | No |
| {{< anchor id="auto_throttle_integrator_control" />}}`auto_throttle_integrator_control` | The integrator gain, a value that can be use to tune the magnitude of the contribution of the instantaneous error over time in the {{< glossterm >}}PID{{< /glossterm >}} controller that drives the behavior of the auto throttle.<span></span>For more information on PIDs please see here: [PID Primer](../../../samples-tutorials/primers/pid-primer/)<span></span>Defaults value is 0.0005. | Float | No |
| {{< anchor id="auto_throttle_proportional_control" />}}`auto_throttle_proportional_control` | The proportional gain, a value that can be used to tune the magnitude of the contribution of the current error in the {{< glossterm >}}PID{{< /glossterm >}} controller that drives the behavior of the auto throttle.<span></span>For more information on PIDs please see here: [PID Primer](../../../samples-tutorials/primers/pid-primer/)<span></span>Defaults value is 0.01. | Float | No |
| {{< anchor id="pitch_takeoff_ga" />}}`pitch_takeoff_ga` | The default pitch that the Takeoff/Go-Around mode references, in degrees.<span></span>Default value is 8.0. | Float | No |
| {{< anchor id="altimeter_indicator" />}}`altimeter_indicator` | Indicates which altimeter indicator system on the aircraft is being referenced by the autopilot, where 0 is the first.<span></span>Default value is 0. | Integer | No |
| {{< anchor id="attitude_indicator" />}}`attitude_indicator` | Indicates which attitude indicator system on the aircraft is being referenced by the autopilot, where 0 is the first.<span></span>Default value is 0. | Integer | No |
| {{< anchor id="direction_indicator" />}}`direction_indicator` | Indicates which direction indicator system on the aircraft is being referenced by the autopilot, where 0 is the first.<span></span>Default value is 0. | Integer | No |
| {{< anchor id="use_no_default_pitch" />}}`use_no_default_pitch` | Setting this to 1 (TRUE) tells the autopilot not to use the default pitch option. Set to 0 (FALSE) to use it.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="default_pitch_mode" />}}`default_pitch_mode` | This determines the default pitch mode when the autopilot is enabled.<span></span>Default value is 1. | Integer:<span></span>{{< params/smallfont >}}0 = None<span></span>1 = Pitch<span></span>2 = Altitude<span></span>3 = Vertical Speed{{< /params/smallfont >}} | No |
| {{< anchor id="max_pitch" />}}`max_pitch` | The maximum pitch angle, in degrees, that the autopilot will command either up or down.<span></span>Default value is 0. | Float | No |
| {{< anchor id="max_pitch_acceleration" />}}`max_pitch_acceleration` | The maximum angular pitch acceleration, in degrees per second squared, that the autopilot will command up or down.<span></span>Default value is 1. | Float | No |
| {{< anchor id="max_pitch_velocity_lo_alt" />}}`max_pitch_velocity_lo_alt` | The maximum angular pitch velocity, in degrees per second, which the autopilot will command when at an altitude below that specified by the parameter [`max_pitch_velocity_lo_alt_breakpoint`](max_pitch_velocity_lo_alt_breakpoint).<span></span>Default value is 2. | Float | No |
| {{< anchor id="max_pitch_velocity_hi_alt" />}}`max_pitch_velocity_hi_alt` | The maximum angular pitch velocity, in degrees per second, which the autopilot will command when at an altitude above the altitude specified by the parameter [`max_pitch_velocity_hi_alt_breakpoint`](max_pitch_velocity_hi_alt_breakpoint). The maximum velocity is interpolated between the hi and lo altitude velocities when between the hi and lo altitude breakpoints.<span></span>Default value is 1.5. | Float | No |
| {{< anchor id="max_pitch_velocity_lo_alt_breakpoint" />}}`max_pitch_velocity_lo_alt_breakpoint` | The altitude below which the autopilot maximum pitch velocity is limited by the parameter [`max_pitch_velocity_lo_alt`](max_pitch_velocity_lo_alt).<span></span>Default value is 20000. | Float | No |
| {{< anchor id="max_pitch_velocity_hi_alt_breakpoint" />}}`max_pitch_velocity_hi_alt_breakpoint` | The altitude above which the autopilot maximum pitch velocity is limited by the parameter [`max_pitch_velocity_hi_alt`](max_pitch_velocity_hi_alt). The maximum velocity is interpolated between the hi and lo altitude velocities when between the hi and lo altitude breakpoints.<span></span>Default value is 28000. | Float | No |
| {{< anchor id="max_pitch_velocity_lo_ang" />}}`max_pitch_velocity_lo_ang` | This defines the fly-by-wire load factor hold system's max pitch velocity at low angle differences. This parameter - along with [`max_pitch_velocity_hi_ang`](max_pitch_velocity_hi_ang) - gives more control over the fly-by-wire pitch rate and therefore the maximum load factor achievable by the aircraft.<span></span>Default value is 1. | Float | No |
| {{< anchor id="max_pitch_velocity_hi_ang" />}}`max_pitch_velocity_hi_ang` | This defines the fly-by-wire load factor hold system's max pitch velocity at high angle differences. This parameter - along with [`max_pitch_velocity_lo_ang`](max_pitch_velocity_lo_ang) - gives more control over the fly-by-wire pitch rate and therefore the maximum load factor achievable by the aircraft.<span></span>Default value is 5. | Float | No |
| {{< anchor id="use_no_default_bank" />}}`use_no_default_bank` | Setting this to 1 (TRUE) tells the autopilot not to use the default bank option. Set to 0 (FALSE) to use it.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="default_bank_mode" />}}`default_bank_mode` | This determines the default bank mode when the autopilot is enabled.<span></span>Default value is 0. | Enum:<span></span>{{< params/smallfont >}}0 = None<span></span>1 = Wing level<span></span>2 = Heading<span></span>3 = Roll Hold{{< /params/smallfont >}} | No |
| {{< anchor id="max_bank_acceleration" />}}`max_bank_acceleration` | The maximum angular bank acceleration, in degrees per second squared, that the autopilot will command left or right.<span></span>Default value is 1.8. | Float | No |
| {{< anchor id="max_bank_velocity" />}}`max_bank_velocity` | The maximum angular bank velocity, in degrees per second, which the autopilot will command left or right. This parameter takes a series of values, separated by commas, where each value corresponds to a specific bank switch position (see [`AP_MAX_BANK_SET`](../../../programming-apis/key-events/aircraft-autopilot/flight-assist-events/#AP_MAX_BANK_SET])). Example:<span></span>`max_bank_velocity = 225, 10`<span></span>Note that the number of entries given for this parameter should correspond with the number of values given for `max_bank`.<span></span>Default value is 3, and you can have a maximum of 6 values. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="max_bank" />}}`max_bank` | The maximum bank angle, in degrees, that the autopilot will command either left or right.<span></span>This parameter takes a series of values, separated by commas, where each value corresponds to a specific bank switch position (see [`AP_MAX_BANK_SET`](../../../programming-apis/key-events/aircraft-autopilot/flight-assist-events/#AP_MAX_BANK_SET)). Example:<span></span>`max_bank = 210, 30`<span></span>Note that the number of entries given for this parameter should correspond with the number of values given for `max_bank_velocity`.<span></span>Default value is 25, and you can have a maximum of 6 values. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="auto_max_bank" />}}`auto_max_bank` | If 1 (TRUE) it adds an extra max bank selection for the autopilot that automatically changes depending on the airspeed. For more information, please see [`AP_MAX_BANK_SET`](../../../programming-apis/key-events/aircraft-autopilot/flight-assist-events/#AP_MAX_BANK_SET).<span></span>Set to 0 (FALSE) to disable the option.<span></span>Default value is 0. | Bool | No |
| {{< anchor id="auto_max_bank_table" />}}`auto_max_bank_table` | Sets the correspondence between an airspeed (in {{< glossterm >}}knots{{< /glossterm >}}) and a max bank value (in degrees), when [`auto_max_bank`](#auto_max_bank) is enabled. For example:<span></span>`auto_max_bank_table = 0.0:15.0, 249.90:15.0, 250.0:25.0`<span></span>Default value is: `0.0:15.0, 249.9:15.0, 250.0:25.0` | [1D Curve](../cfg-files-general-information/#1d_curve) of Floats | No |
| {{< anchor id="auto_max_bank_velocity_table" />}}`auto_max_bank_velocity_table` | Sets the correspondence between the angular bank velocity (in {{< glossterm >}}knots{{< /glossterm >}}) and a max bank value (in degrees / second). For example:<span></span>`auto_max_bank_velocity_table = 0:30, 200:30, 550:10`<span></span>Default value is: `0.0:max_bank_velocity` | [1D Curve](../cfg-files-general-information/#1d_curve) of Floats | No |
| {{< anchor id="auto_max_bank_min_alt" />}}`auto_max_bank_min_alt` | Sets the altitude (in {{< glossterm >}}ft{{< /glossterm >}}) above ground level below which the max bank angle is limited (see [`auto_max_bank_min_alt_angle`](#auto_max_bank_min_alt_angle)) in feet.<span></span>Default value is 0. | Float | No |
| {{< anchor id="auto_max_bank_min_alt_angle" />}}`auto_max_bank_min_alt_angle` | Sets the max bank angle (in degrees) when the plane is in auto max bank angle mode below the minimum altitude set by [`auto_max_bank_min_alt`](#auto_max_bank_min_alt).<span></span>Default value is 0. | Float | No |
| {{< anchor id="pitch_pid_reset_mode" />}}`pitch_pid_reset_mode` | This parameter can be used to set the way that the pitch PID calculations will be updated. It can have the following values:<span></span>{{< params/smallfont >}}0 - **The PID will be "dirty", ie: it maintains the accumulated integral**. The behavior of the autopilot will depend on what was happening when the autopilot was switched off previously. The autopilot will jump to the last pitch input and will start adjusting from there. This could mean there will be extremely exaggerated corrections.<span></span>1 - **The PID will be reset to 0**. The autopilot will always go back to a 0 (neutral) input and start adjusting from there. If the current input is strong, a noticeable correction will be made. If not, the correction may not be noticeable.<span></span>2 - **The PID will be reset to the current plane state.** The autopilot will start adjusting from the current input position. There should be no correction felt and the transition to autopilot control should be smooth in all cases. **This is the recommended mode**.{{< /params/smallfont >}}<span></span>**NOTE**: A PID reset is triggered if the PID controller is executed in a frame and was not executed for the previous 10 frames. Usually this happens when an autopilot mode using the PID is switched ON.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 - Dirty<span></span>1 - Reset<span></span>2 - Current<span></span>(recommended){{< /params/smallfont >}} | No |
| {{< anchor id="pitch_pid_max_I_accumulation" />}}`pitch_pid_max_I_accumulation` | This sets the maximum accumulation permitted for the integral of the pitch PID.<span></span>Default value is 1. | Float | No |
| {{< anchor id="roll_pid_reset_mode" />}}`roll_pid_reset_mode` | This parameter can be used to set the way that the roll PID calculations will be updated. It can have the following values:<span></span>{{< params/smallfont >}}0 - **The PID will be "dirty", ie: it maintains the accumulated integral**. The behavior of the autopilot will depend on what was happening when the autopilot was switched off previously. The autopilot will jump to the last pitch input and will start adjusting from there. This could mean there will be extremely exaggerated corrections.<span></span>1 - **The PID will be reset to 0**. The autopilot will always go back to a 0 (neutral) input and start adjusting from there. If the current input is strong, a noticeable correction will be made. If not, the correction may not be noticeable.<span></span>2 - **The PID will be reset to the current plane state.** The autopilot will start adjusting from the current input position. There should be no correction felt and the transition to autopilot control should be smooth in all cases. **This is the recommended mode**.{{< /params/smallfont >}}<span></span>**NOTE**: A PID reset is triggered if the PID controller is executed in a frame and was not executed for the previous 10 frames. Usually this happens when an autopilot mode using the PID is switched ON.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 - Dirty<span></span>1 - Reset<span></span>2 - Current<span></span>(recommended){{< /params/smallfont >}} | No |
| {{< anchor id="roll_pid_max_I_accumulation" />}}`roll_pid_max_I_accumulation` | This sets the maximum accumulation permitted for the integral of the roll {{< glossterm >}}PID{{< /glossterm >}}.<span></span>Default value is 1. | Float | No |
| {{< anchor id="heading_pid_reset_mode" />}}`heading_pid_reset_mode` | This parameter can be used to set the way that the heading PID calculations will be updated. It can have the following values:<span></span>{{< params/smallfont >}}0 - **The PID will be "dirty", ie: it maintains the accumulated integral**. The behavior of the autopilot will depend on what was happening when the autopilot was switched off previously. The autopilot will jump to the last pitch input and will start adjusting from there. This could mean there will be extremely exaggerated corrections.<span></span>1 - **The PID will be reset to 0**. The autopilot will always go back to a 0 (neutral) input and start adjusting from there. If the current input is strong, a noticeable correction will be made. If not, the correction may not be noticeable.<span></span>2 - **The PID will be reset to the current plane state.** The autopilot will start adjusting from the current input position. There should be no correction felt and the transition to autopilot control should be smooth in all cases. **This is the recommended mode**.{{< /params/smallfont >}}<span></span>**NOTE**: A PID reset is triggered if the PID controller is executed in a frame and was not executed for the previous 10 frames. Usually this happens when an autopilot mode using the PID is switched ON.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 - Dirty<span></span>1 - Reset<span></span>2 - Current<span></span>(recommended){{< /params/smallfont >}} | No |
| {{< anchor id="heading_pid_max_I_accumulation" />}}`heading_pid_max_I_accumulation` | This sets the maximum accumulation permitted for the integral of the heading {{< glossterm >}}PID{{< /glossterm >}}.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="heading_mode_prefer_smallest_angle" />}}`heading_mode_prefer_smallest_angle` | When this is set to 0/`false`, the heading mode will keep the current rotation direction when attempting to make a turn, ie: if your aircraft is pointing towards 90° (East), and you set your AP to go to 0° (North) it will start turning to its left, if you then keep moving the heading selector left and go beyond the halfway point all the way to 180° (South), it will still keep turning left until it reaches that heading. If it is set to 1/`true` then instead the direction of the rotation will change to the right when you go beyond 270° (West) as it would then have a smaller angle going right.<span></span>Note that even if the parameter is set to 0/`false`, this behavior only applies when the difference between the current heading and the target heading is greater than 5°.<span></span>Default value is 1. | Bool | No |
| {{< anchor id="head_hold_pid" />}}`head_hold_pid` | The full heading hold {{< glossterm >}}PID{{< /glossterm >}} definition for the aircraft, as a table. Follows the format of:<span></span>`P, I1, I2, D, I1-boundary, I2-Boundary, D-boundary`<span></span>Default values are `0, 0, 0, 0, 0, 0, 0`. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="airspeed_hold_pid" />}}`airspeed_hold_pid` | The full airspeed hold {{< glossterm >}}PID{{< /glossterm >}} definition for the aircraft, as a table. Follows the format of:<span></span>`P, I1, I2, D, I1-boundary, I2-Boundary, D-boundary`<span></span>Default values are `0, 0, 0, 0, 0, 0, 0`. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="min_altitude_ref" />}}`min_altitude_ref` | Sets the minimum altitude (in {{< glossterm >}}ft{{< /glossterm >}}) that can be set in the Autopilot.<span></span>Defaults to -99900. | Float | No |
| {{< anchor id="max_altitude_ref" />}}`max_altitude_ref` | Sets the maximum altitude (in {{< glossterm >}}ft{{< /glossterm >}}) that can be set in the Autopilot.<span></span>Defaults to 99900. | Float | No |
| {{< anchor id="yaw_damper_gain" />}}`yaw_damper_gain` | The proportional gain on the yaw dampers yaw rate error.<span></span>Default value is 0. | Float | No |
| {{< anchor id="min_vertical_speed_ref" />}}`min_vertical_speed_ref` | Sets the minimum vertical speed (in {{< glossterm >}}ft{{< /glossterm >}} per minute) that can be set in the Autopilot.<span></span>Defaults to -9900. | Float | No |
| {{< anchor id="max_vertical_speed_ref" />}}`max_vertical_speed_ref` | Sets the maximum vertical speed (in {{< glossterm >}}ft{{< /glossterm >}} per minute) that can be set in the Autopilot.<span></span>Defaults to 9900. | Float | No |
| {{< anchor id="min_IAS_ref" />}}`min_IAS_ref` | Sets the minimum {{< glossterm >}}IAS{{< /glossterm >}} reference (in {{< glossterm >}}kias{{< /glossterm >}}) that can be set in the Autopilot.<span></span>Default is 0. | Float | No |
| {{< anchor id="max_IAS_ref" />}}`max_IAS_ref` | Sets the maximum {{< glossterm >}}IAS{{< /glossterm >}} reference (in {{< glossterm >}}kias{{< /glossterm >}}) that can be set in the Autopilot.<span></span>Default is 990. | Float | No |
| {{< anchor id="min_Mach_ref" />}}`min_Mach_ref` | Sets the minimum {{< glossterm >}}mach{{< /glossterm >}} that can be set in the Autopilot.<span></span>Defaults to 0. | Float | No |
| {{< anchor id="max_Mach_ref" />}}`max_Mach_ref` | Sets the maximum {{< glossterm >}}mach{{< /glossterm >}} that can be set in the Autopilot.<span></span>Defaults to 3. | Float | No |
| {{< anchor id="alt_mode_slot_index" />}}`alt_mode_slot_index` | Set the default alt mode slot index (from 0 to 3). This is the index for the SimVar `AUTOPILOT ALTITUDE LOCK VAR` which the altitude hold mode will track when captured. You can change this using the [`ALTITUDE_SLOT_INDEX_SET`](../../../programming-apis/key-events/aircraft-autopilot/flight-assist-events/#ALTITUDE_SLOT_INDEX_SET) event ID or retrieve it using the [`AUTOPILOT ALTITUDE SLOT INDEX`](../../../programming-apis/simvars/aircraft-simvars/aircraft-autopilot/assistant-variables/#AUTOPILOT-ALTITUDE-SLOT-INDEX) SimVar.<span></span>When this parameter is set to 1, 2 or 3, the altitude capture will watch the altitude set at that index, unless overridden by changing the currently observed slot using the key event[`ALTITUDE_SLOT_INDEX_SET`](../../../programming-apis/key-events/aircraft-autopilot/flight-assist-events/#ALTITUDE_SLOT_INDEX_SET). If the currently observed slot has been changed when altitude is captured, the set altitude in the currently observed slot will be copied to the `alt_mode_slot_index` slot and the currently observed slot will also be changed to that slot.<span></span>When this config parameter is set to 0, the altitude capture will always use whatever the currently observed slot is set to and will not change slots or write to any slots on capture.<span></span>Default value is 0. | Integer | No |
| {{< anchor id="flc_min_pitch_low_alt" />}}`flc_min_pitch_low_alt` | Sets the minimum AP pitch (in degrees) when the plane is in {{< glossterm >}}FLC{{< /glossterm >}} mode and below [`flc_min_low_alt_limit`](#flc_min_low_alt_limit).<span></span>Default value is 0. | Float | No |
| {{< anchor id="flc_min_low_alt_limit" />}}`flc_min_low_alt_limit` | Sets the maximum height (in {{< glossterm >}}ft{{< /glossterm >}}) below which the pitch in {{< glossterm >}}FLC{{< /glossterm >}} mode is limited. Disabled if <=0.<span></span>Default value is 0. | Float | No |
| {{< anchor id="min_feet_for_athr" />}}`min_feet_for_athr` | Set the height (in {{< glossterm >}}ft{{< /glossterm >}}) below which the auto-throttle is automatically disabled.<span></span>Default value is -1000 (essentially disabled). | Float | No |
| {{< anchor id="altitude_english_slow_increment" />}}`altitude_english_slow_increment` | Sets the slow increments (in {{< glossterm >}}ft{{< /glossterm >}}) of the autopilot's altitude when in english (empirical) units.<span></span>Default value is 1000. | Float | No |
| {{< anchor id="altitude_english_fast_increment" />}}`altitude_english_fast_increment` | Sets the fast increments (in {{< glossterm >}}ft{{< /glossterm >}}) of the autopilot's altitude when in english (empirical) units.<span></span>Default value is 2000. | Float | No |
| {{< anchor id="altitude_english_fastest_increment" />}}`altitude_english_fastest_increment` | Sets the fastest increments (in {{< glossterm >}}ft{{< /glossterm >}}) of the autopilot's altitude when in english (empirical) units.<span></span>Default value is 5000. | Float | No |
| {{< anchor id="altitude_metric_slow_increment" />}}`altitude_metric_slow_increment` | Sets the slow increments (in meters) of the autopilot's altitude when in metric (SI) units.<span></span>Default value is 50. | Float | No |
| {{< anchor id="altitude_metric_fast_increment" />}}`altitude_metric_fast_increment` | Sets the fast increments (in meters) of the autopilot's altitude when in metric (SI) units.<span></span>Default value is 100. | Float | No |
| {{< anchor id="altitude_metric_fastest_increment" />}}`altitude_metric_fastest_increment` | Sets the fastest increments (in meters) of the autopilot's altitude when in metric (SI) units.<span></span>Default value is 1000. | Float | No |
| {{< anchor id="metric_VS_increment" />}}`metric_VS_increment` | Sets the increments of the autopilot's vertical speed when in metric units (meters per minute).<span></span>Default value is 50. | Float | No |
| {{< anchor id="english_VS_increment" />}}`english_VS_increment` | Sets the increments of the autopilot's vertical speed when in english units ({{< glossterm >}}ft{{< /glossterm >}} per minute).<span></span>Default value is 100. | Float | No |
| {{< anchor id="IAS_slow_increment" />}}`IAS_slow_increment` | Sets the slow increments of the autopilot's target speed (in {{< glossterm >}}knots{{< /glossterm >}}).<span></span>Default value is 1. | Float | No |
| {{< anchor id="IAS_fast_increment" />}}`IAS_fast_increment` | Sets the fast increments of the autopilot's target speed (in {{< glossterm >}}knots{{< /glossterm >}}).<span></span>Default value is 5. | Float | No |
| {{< anchor id="IAS_fastest_increment" />}}`IAS_fastest_increment` | Sets the fastest increments of the autopilot's target speed (in {{< glossterm >}}knots{{< /glossterm >}}).<span></span>Default value is 10. | Float | No |
| {{< anchor id="mach_increment" />}}`mach_increment` | Sets the increments of the autopilot's target speed (in {{< glossterm >}}mach{{< /glossterm >}}).<span></span>Default value is 0.01. | Float | No |
| {{< anchor id="hdg_ref_var" />}}`hdg_ref_var` | Set the compass variable to be used as the source of heading reference.<span></span>Default value is 0. | Enum:<span></span>0 = Magnetic<span></span>1 = Gyro | No |
| {{< anchor id="auto_throttle_hold_vs" />}}`auto_throttle_hold_vs` | If set to 0 (FALSE), the auto throttle will not attempt to hold the VS when attempting to hold an airspeed. If set to 1 (TRUE) it will.<span></span>Default value is 1 (TRUE). | Boolean | No |
| {{< anchor id="auto_rudder_use_pedals" />}}`auto_rudder_use_pedals` | If set to 0 (FALSE), the auto rudder will not move the cockpit pedals. If set to 1 (TRUE) it will.<span></span>Default value is 1 (TRUE). | Boolean | No |
| {{< anchor id="auto_disengage_with_pilot_input" />}}`auto_disengage_with_pilot_input` | When this is set to 1 (TRUE) then the autopilot will be disengaged when any pilot action on inputs is greater than 50% of the axis for more than 1 second.<span></span>Default value is 1 (TRUE). | Boolean | No |
| {{< anchor id="basic_modes_disengage_with_FBW" />}}`basic_modes_disengage_with_FBW` | If set to 1 (TRUE) and the fly-by-wire is set to "ON" and the auto-pilot is on, then the Pitch, Bank and Yaw dampening modes are disengaged.<span></span>Default value is 1 (TRUE). | Boolean | No |
| {{< anchor id="no_alt_capture_in_vs_mode" />}}`no_alt_capture_in_vs_mode` | When set to 1 (TRUE), this will disable the altitude capture by autopilot when the VS mode is engaged.<span></span>Default value is 0 (FALSE). | Boolean | No |
| {{< anchor id="pitch_use_elevator_only" />}}`pitch_use_elevator_only` | If set to 1 (TRUE), the autopilot/fly-by-wire will *not* use trim for pitch inputs.<span></span>Default value is 0 (FALSE), so it uses trimming for pitch inputs. | Boolean | No |
| {{< anchor id="FBWPitchTrimSpeedScalar" />}}`FBWPitchTrimSpeedScalar` | This value can be used to scale the speed at which pitch trim is applied using a fly-by-wire system.<span></span>Default value is 1. | Float | No |
| {{< anchor id="FBWHighSpeedRollSpeedScalar" />}}`FBWHighSpeedRollSpeedScalar` | This value can be used to scale the speed at which roll is applied using a fly-by-wire system.<span></span>Default value is 1. | Float | No |

{{< /table-wrapper >}}

The parameters available to **helicopters** are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="autopilot_available-AUTOPILOT-Helicopter" />}}`autopilot_available` | Setting this to 1 (TRUE) makes the autopilot system available to the aircraft, otherwise set it to 0 (FALSE) to disable autopilot. | Bool | Yes |
| {{< anchor id="flight_director_available-AUTOPILOT-Helicopter" />}}`flight_director_available` | Setting this to 1 (TRUE) makes the flight director available to the aircraft, otherwise setting it to 0 (FALSE) will disable the flight director. | Bool | Yes |
| {{< anchor id="pitch_attitude_hold_i" />}}`pitch_attitude_hold_i` | Pitch attitude hold integral controller scalar.<span></span>Default value is 0.5. | Float | No |
| {{< anchor id="pitch_attitude_hold_p" />}}`pitch_attitude_hold_p` | Pitch attitude hold proportional controller scalar.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="pitch_attitude_hold_d" />}}`pitch_attitude_hold_d` | Pitch attitude hold derivative controller scalar.<span></span>Default value is 0. | Float | No |
| {{< anchor id="pitch_attitude_hold_vel" />}}`pitch_attitude_hold_vel` | Pitch attitude hold change velocity scalar.<span></span>Default value is 1. | Float | No |
| {{< anchor id="bank_attitude_hold_i" />}}`bank_attitude_hold_i` | Bank attitude hold integral controller scalar.<span></span>Default value is 0.5. | Float | No |
| {{< anchor id="bank_attitude_hold_p" />}}`bank_attitude_hold_p` | Bank attitude hold proportional controller scalar.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="bank_attitude_hold_d" />}}`bank_attitude_hold_d` | Bank attitude hold derivative controller scalar.<span></span>Default value is 0. | Float | No |
| {{< anchor id="bank_attitude_hold_vel" />}}`bank_attitude_hold_vel` | Bank attitude hold change velocity scalar.<span></span>Default value is 1. | Float | No |
| {{< anchor id="heading_hold_rate" />}}`heading_hold_rate` | The heading hold rate.<span></span>Default value is 0.2. | Float | No |
| {{< anchor id="heading_hold_rate_max" />}}`heading_hold_rate_max` | The maximum heading hold rate.<span></span>Default value is 3. | Float | No |
| {{< anchor id="heading_hold_bank_ang_max" />}}`heading_hold_bank_ang_max` | The heading hold maximum banking angle.<span></span>Default value is 15. | Float | No |
| {{< anchor id="heading_hold_i" />}}`heading_hold_i` | Heading hold integral controller scalar.<span></span>Default value is 2. | Float | No |
| {{< anchor id="heading_hold_p" />}}`heading_hold_p` | Heading hold proportional controller scalar.<span></span>Default value is 5. | Float | No |
| {{< anchor id="heading_hold_d" />}}`heading_hold_d` | Heading hold derivative controller scalar.<span></span>Default value is 5. | Float | No |
| {{< anchor id="altitude_hold_rate" />}}`altitude_hold_rate` | The altitude hold rate.<span></span>Default value is 3. | Float | No |
| {{< anchor id="altitude_hold_max" />}}`altitude_hold_max` | The maximum altitude hold.<span></span>Default value is 500. | Float | No |
| {{< anchor id="altitude_hold_pitch_ang_max" />}}`altitude_hold_pitch_ang_max` | The altitude hold maximum pitch angle.<span></span>Default value is 20. | Float | No |
| {{< anchor id="vs_hold_pitch_i" />}}`vs_hold_pitch_i` | Vertical speed hold pitch integral scalar.<span></span>Default value is 0.02. | Float | No |
| {{< anchor id="vs_hold_pitch_p" />}}`vs_hold_pitch_p` | Vertical speed hold pitch proportional scalar.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="vs_hold_pitch_d" />}}`vs_hold_pitch_d` | Vertical speed hold pitch derivitive scalar.<span></span>Default value is 0.1. | Float | No |
| {{< anchor id="pa_collective_offset" />}}`pa_collective_offset` | Collective offset scalar.<span></span>Default value is 0.65. | Float | No |
| {{< anchor id="vs_hold_collective_i" />}}`vs_hold_collective_i` | Vertical speed hold collective integral scalar.<span></span>Default value is 0.0005. | Float | No |
| {{< anchor id="vs_hold_collective_p" />}}`vs_hold_collective_p` | Vertical speed hold collective proportional scalar.<span></span>Default value is 0.0005. | Float | No |
| {{< anchor id="vs_hold_collective_d" />}}`vs_hold_collective_d` | Vertical speed hold collective derivitive scalar.<span></span>Default value is 0.0025. | Float | No |
| {{< anchor id="attitude_hold_off_speed" />}}`attitude_hold_off_speed` | Speed scalar on the attitude off control.<span></span>Default value is 10. | Float | No |
| {{< anchor id="attitude_hold_on_speed" />}}`attitude_hold_on_speed` | Speed scalar on the attitude on control.<span></span>Default value is 30. | Float | No |
| {{< anchor id="pedal_assist_off_speed" />}}`pedal_assist_off_speed` | Pedal assist off speed scalar.<span></span>Default value is 20. | Float | No |
| {{< anchor id="pedal_assist_on_speed" />}}`pedal_assist_on_speed` | Pedal assist on speed scalar.<span></span>Default value is 40. | Float | No |
| {{< anchor id="pedal_assist_heading_max_angle" />}}`pedal_assist_heading_max_angle` | Pedal assist heading maximum angle.<span></span>Default value is 10. | Float | No |
| {{< anchor id="pedal_assist_heading_angle_scalar" />}}`pedal_assist_heading_angle_scalar` | Pedal assist heading angle scalar.<span></span>Default value is 0.025. | Float | No |
| {{< anchor id="speed_hold_pitch_i" />}}`speed_hold_pitch_i` | Speed hold pitch integrator scalar.<span></span>Default value is 0.02. | Float | No |
| {{< anchor id="speed_hold_pitch_p" />}}`speed_hold_pitch_p` | Speed hold pitch proportional scalar.<span></span>Default value is 0.5. | Float | No |
| {{< anchor id="speed_hold_pitch_d" />}}`speed_hold_pitch_d` | Speed hold pitch derivitive scalar.<span></span>Default value is 0.1. | Float | No |
| {{< anchor id="speed_hold_pitch_ang_max" />}}`speed_hold_pitch_ang_max` | Speed hold pitch maximum angle.<span></span>Default value is 20. | Float | No |
| {{< anchor id="speed_hold_bank_i" />}}`speed_hold_bank_i` | Speed hold bank integrator scalar.<span></span>Default value is 0.02. | Float | No |
| {{< anchor id="speed_hold_bank_p" />}}`speed_hold_bank_p` | Speed hold bank proportional scalar.<span></span>Default value is 0.5. | Float | No |
| {{< anchor id="speed_hold_bank_d" />}}`speed_hold_bank_d` | Speed hold bank derivitive scalar.<span></span>Default value is 0.1. | Float | No |
| {{< anchor id="speed_hold_bank_ang_max" />}}`speed_hold_bank_ang_max` | Speed hold bank maximum angle.<span></span>Default value is 20. | Float | No |
| {{< anchor id="speed_hold_collective_i" />}}`speed_hold_collective_i` | Speed hold collective integrator scalar.<span></span>Default value is 0.005. | Float | No |
| {{< anchor id="speed_hold_collective_p" />}}`speed_hold_collective_p` | Speed hold collective proportional scalar.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="speed_hold_collective_d" />}}`speed_hold_collective_d` | Speed hold collective derivitive scalar.<span></span>Default value is 0.05. | Float | No |
| {{< anchor id="auto_hover_vertical_i" />}}`auto_hover_vertical_i` | Vertical integrator scalar for auto-hover.<span></span>Default value is 0.01. | Float | No |
| {{< anchor id="auto_hover_vertical_imax" />}}`auto_hover_vertical_imax` | Maximum vertical integrator scalar for auto-hover.<span></span>Default value is 0.1. | Float | No |
| {{< anchor id="auto_hover_vertical_p" />}}`auto_hover_vertical_p` | Vertical proportional scalar for auto-hover.<span></span>Default value is 0.5. | Float | No |
| {{< anchor id="auto_hover_vertical_pmax" />}}`auto_hover_vertical_pmax` | Maximum vertical proportional scalar for auto-hover.<span></span>Default value is 0.1. | Float | No |

{{< /table-wrapper >}}


### [SMOKESYSTEM]

This section controls the aircraft smoke system. Available parameter is:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="smoke.N" />}}`smoke.N` | Each parameter *`N`* defines a smoke point position, where *`N`* starts at 0. Points are defined as a table of values using the following order:<span></span>`z, x, y, fx_name`<span></span>The position values are the local position offset relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point) (in {{< glossterm >}}ft{{< /glossterm >}}) and the `fx_name` value is the name of one of the FX files that should be used. | [List](../cfg-files-general-information/#list) of Floats | No |

{{< /table-wrapper >}}


### [folding_wings]

If the aircraft being defined has folding wings, this section should be included. Available parameters are:

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="wing_fold_system_type" />}}`wing_fold_system_type` | The type of system used to fold the wings.<span></span>Default value is 0. | Integer:<span></span>{{< params/smallfont >}}0 = Hydraulic<span></span>1 = Electrical<span></span>2 = Pneumatic<span></span>3 = Manual{{< /params/smallfont >}} | No |
| {{< anchor id="fold_rates" />}}`fold_rates` | The folding rates for the left wing and right wing, as a table of two values (left, right). Rates are expressed as 1/seconds.<span></span>Default values are 0.1, 0.12. | [List](../cfg-files-general-information/#list) of Floats | No |

{{< /table-wrapper >}}


### [TailHook]

This section controls the tailhook of the aircraft (if required). Available parameters are:

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="has_tailhook" />}}`has_tailhook` | Sets whether the aircraft has a tailhook (1, TRUE) or not (0, FALSE). Note that you will need to have set up the `[INTERACTIVE POINTS]` correctly for the aircraft - see here for details: [Carrier Landings](flight-model/additional-flight-model-information/#carrier-landings).<span></span>Default value is 0 (FALSE). | Boolean | No |
| {{< anchor id="cable_force_adjust" />}}`cable_force_adjust` | This is a scaling factor that can be used to adjust the cable spring force when an aircraft is hooked. The value acts as a multiplier, so a value of 2 would be double the spring force, while a value of 0.5 would half the spring force. You can change this value from the default if you're not satisfied with how the aircraft is arrested by the cables: for example, stopping a lightweight aircraft may require a lower force multiplier compared to stopping a very heavy one.<span></span>Default value is 1. | Float | No |

{{< /table-wrapper >}}


### [launch_assistance]

This section controls the launchbar (assisted takeoff) parameters for an aircraft that requires them. Available parameters are:

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

These parameters are currently purely visual as you cannot set an aircraft to take off from an aircraft carrier. Future updates may change this.

{{< /callout >}}

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="launch_bar_pivot" />}}`launch_bar_pivot` | Position of pivot attachment point relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point). Values are in {{< glossterm >}}ft{{< /glossterm >}}.<span></span>Default value is 0, 0, 0. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="launch_bar_lug" />}}`launch_bar_lug` | Position of lug attachment point relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point). Values are in {{< glossterm >}}ft{{< /glossterm >}}.<span></span>Default value is 0, 0, 0. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="launch_bar_moveable" />}}`launch_bar_moveable` | Sets whether the launchbar is movable or not.<span></span>Default value is 0 (FALSE). | Boolean | No |

{{< /table-wrapper >}}


### [VOICEALERTS]

This section controls any voice alerts for the aircraft. Available parameters are:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="LowFuelPct" />}}`LowFuelPct` | Sets the low fuel warning voice alert, as a table of 3 values in the following order:<span></span>`check_value, check_type, check_frequency`<span></span>For check_type `+1`, `-1`, or `0`, representing greater than, less than or equal to. | [List](../cfg-files-general-information/#list) of Floats | No |
| {{< anchor id="OverGLimit" />}}`OverGLimit` | Sets the over {{< glossterm >}}G{{< /glossterm >}} limit, as a table of 3 values in the following order:<span></span>`check_value, check_type, check_frequency`<span></span>For check_type `+1`, `-1`, or `0`, representing greater than, less than or equal to. | [List](../cfg-files-general-information/#list) of Floats | No |

{{< /table-wrapper >}}


### [PRESSURIZATION]

This section controls the cabin pressurization systems. Available parameters are:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="design_cabin_pressure" />}}`design_cabin_pressure` | The cabin pressure, as designed, in {{< glossterm >}}psi{{< /glossterm >}}. This value is used to set the [`PRESSURIZATION CABIN ALTITUDE GOAL`](../../../programming-apis/simvars/aircraft-simvars/aircraft-system-variables/#PRESSURIZATION-CABIN-ALTITUDE-GOAL) SimVar. | Float | No |
| {{< anchor id="max_pressure_differential" />}}`max_pressure_differential` | The maximum pressure deferential permitted, in {{< glossterm >}}psi{{< /glossterm >}}. | Float | No |

{{< /table-wrapper >}}


### [AUXILIARY POWER UNIT]

This section controls {{< glossterm >}}apu{{< /glossterm >}} systems. Available parameters are:

{{< table-wrapper "250px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Available-AUXILIARY POWER UNIT" />}}`Available` | Indicates whether there is an {{< glossterm >}}APU{{< /glossterm >}} system (TRUE, 1) or not (FALSE, 0). | Bool | No |
| {{< anchor id="apu_pct_rpm_per_second" />}}`apu_pct_rpm_per_second` | Controls the speed at which the {{< glossterm >}}APU{{< /glossterm >}}'s RPM increases. Note that this is only applicable when the aircraft electrical system is [Version](#Major) 2 or higher.<span></span>Default is 0.4. | Float | No |

{{< /table-wrapper >}}


### [WATER BALLAST SYSTEM]

This section controls the water balance system. Available parameters are:

{{< table-wrapper "250px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Version-WATER-BALLAST-SYSTEM" />}}`Version` | The version of the water ballast system being used. This will impact how the [Tank.N](#Tank.N-WATER-BALLAST-SYSTEM) parameter is defined.<span></span>If not supplied then the version will be considered as 1. | Integer | No |
| {{< anchor id="NumberOfReleaseValves" />}}`NumberOfReleaseValves` | The number of ballast release valves available. | Integer | No |
| {{< anchor id="DumpRate" />}}`DumpRate` | The dump rate for the ballast, in {{< glossterm >}}gallon{{< /glossterm >}}s per second. | Float | No |
| {{< anchor id="Tank.N-WATER-BALLAST-SYSTEM" />}}`Tank.N` | **Version 2 And Above**:<span></span>{{< params/smallfont >}}Each parameter *`N`* defines a ballast tank, where *`N`* starts at 0. Tank details are defined as a hash map with the following format:<span></span>`Tank.N = #Name:<string> #Capacity:<val> #position: <x>,<y>,<z> #Valve:<index> #DefaultFillPct:<val>`<span></span> - `Name`: The name of the tank<span></span> - `Capacity`: The tank capacity, in {{< glossterm >}}gallon{{< /glossterm >}}s<span></span> - `Position`: The local position offset relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point) (in {{< glossterm >}}ft{{< /glossterm >}})<span></span> - `Valve`: the valve index (from 1 to `NumberOfReleaseValves`).<span></span> - `DefaultFillPct`: The default percentage of the tank that should be filled.{{< /params/smallfont >}}<span></span>**Versions before 2**:<span></span>{{< params/smallfont >}}Each parameter *`N`* defines a ballast tank, where *`N`* starts at 0. Tank details are defined as a table of values in the following order:<span></span>`max_weight, z, x, y, valve_index`<span></span>The weight is in {{< glossterm >}}gallon{{< /glossterm >}}s, the position values are the local position offset relative to the [Datum Reference Point](../../modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point) (in {{< glossterm >}}ft){{< /glossterm >}}, and the index is the valve index (from 1 to `NumberOfReleaseValves`). Tanks are numbered from 0 to 5 where:<span></span> - 0 = Front Fuselage<span></span> - 1 = Rear Fuselage<span></span> - 2 = Left Outboard<span></span> - 3 = Left Inboard<span></span> - 4 = Right Inboard<span></span> - 5 = Right Outboard{{< /params/smallfont >}}<span></span>**NOTE**: You can only define a maximum of 6 water ballast tanks using the legacy version. | **Version 2+**:<span></span>{{< params/smallfont >}}Hash map{{< /params/smallfont >}}<span></span>**Previous Versions**:<span></span>{{< params/smallfont >}}[List](../cfg-files-general-information/#list) of Floats{{< /params/smallfont >}} | No |

{{< /table-wrapper >}}


### [Liquid Dropping System]

This section controls everything related to the aircraft Liquid Dropping System. This is a modular system that is made up from various connected components. The available components and parameters are as follows:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Tank.N-Liquid Dropping System" />}}`Tank.N` | The tank that holds the liquid which is to be available for dropping.<span></span>Details on the tank map contents are given here: [Tank.N](../system/modular-liquid-dropping-system-information/#tankn)[ ](../system/modular-liquid-dropping-system-information/#tankn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Door.N" />}}`Door.N` | A door that can be opened and closed to control the liquid dropping.<span></span>Details on the door map contents are given here: [Door.N](../system/modular-liquid-dropping-system-information/#doorn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Scoop.N" />}}`Scoop.N` | This is the scoop which can be opened or closed to take on liquid and fill the tank(s).<span></span>Details on the scoop map contents are given here: [Scoop.N](../system/modular-liquid-dropping-system-information/#scoopn) | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Curve.N-Liquid Dropping System" />}}`Curve.N` | This defines a curve which is used to define a [Door](../system/modular-liquid-dropping-system-information/#doorn) (or [Scoop](../system/modular-liquid-dropping-system-information/#scoopn)) drop (or intake) rate for the liquids in the tank(s) connected.<span></span>Details on the curve map contents are given here: [Curve.N](../system/modular-liquid-dropping-system-information/#curven) | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}


### [Burner_System]

This section controls the burner system used by hot balloon sim objects. Available parameters are:

{{< table-wrapper "150px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="Burner.N" />}}`Burner.N` | This defines one or more liquid propane gas burners for a hot air balloon.<span></span>Details on the scoop map contents are given here: [Burner.N](../system/modular-burner-system-information/#burnern). | [Hash Map](../cfg-files-general-information/#hash-map) | No |
| {{< anchor id="Valve.N-Burner_System" />}}`Valve.N` | This defines one or more valves required by the burners of a hot air balloon.<span></span>Details on the valve map contents are given here: [Valve.N](../system/modular-burner-system-information/#valven). | [Hash Map](../cfg-files-general-information/#hash-map) | No |

{{< /table-wrapper >}}


### [LocalVars]

This section can be used to set the initial value of *persistent* local variables to be used in the [XML Model Behaviours templates](../../models/modelbehaviors/model-behaviors/) and [gauges](../../modular-simobjects/aircraft/instruments/instruments/). These local vars are accessed using the "`L:`" var identifier in [Reverse Polish Notation,](../../../programming-apis/reverse-polish-notation/) and if you are using the [JavaScript](../../../programming-apis/javascript/javascript/) API then it's done the same way as for SimVars, using the `GetSimVarValue(name, unit, dataSource = "")` function. **These variables are shared between aircraft if multiple instances of the aircraft are spawned.** In general this is not what you want and you should use the scoped `L:1` variable type instead, defined in the `[LocalVars_EX1]` section.

When an aircraft is selected by a user and the flight is first started, these "`L:`" vars are defined using the `LocalVar.N` parameter and then initialised using a default value (done using the `LocalVarDefault.N` parameter). Any changes to these variables that have been made will then be saved to a file (`state.cfg`) when the flight is exited. This file will be saved to a local location on the users computer using the following path schema:

-   `STEAM: C:\Users\<USERNAME>\AppData\Roaming\Microsoft Flight Simulator\SimObjects\<AIRCRAFT_NAME>\state.cfg`

-   `MS STORE: C:\Users\<USERNAME>\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\SimObjects\<AIRCRAFT_NAME>\state.cfg`

The next time the aircraft is used, the local variables will be initialised as before, only now they will be set to the values stored in the `state.cfg`.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

The variables defined here take precedence over those stored in the `FLT` file, and will overwrite any with the same name that are saved to that file when an aircraft is loaded.

{{< /callout >}}

Note that if you define a variable here but don't initialise it with a default value, then the first time it is used it will be considered as having a value of 0.

{{< table-wrapper "200px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="LocalVar.N-LocalVars" />}}`LocalVar.N` | This defines the name of one or more local variables that will have their value saved. Each variable should be defined as a string, and is indexed from 1. For example:<span></span>`LocalVar.1 = myLocalVariable` | String | No |
| {{< anchor id="LocalVarDefault.N-LocalVars" />}}`LocalVarDefault.N` | This defines a local variable default value. Each variable defined using the parameter should have a corresponding default value and index, with the indexing starting at 1. For example:<span></span>`LocalVarDefault.1 = 10` | int/float/string, etc... | No |

{{< /table-wrapper >}}


### [LocalVars_EX1]

This section can be used to set the initial value of *persistent* local variables to be used in the [XML Model Behaviours templates](../../models/modelbehaviors/model-behaviors/) and [gauges](../../modular-simobjects/aircraft/instruments/instruments/). These local vars are accessed using the "`L:1`" var identifier in [Reverse Polish Notation,](../../../programming-apis/reverse-polish-notation/) and if you are using the [JavaScript](../../../programming-apis/javascript/javascript/) API then it's done the same way as for SimVars, using the `GetSimVarValue(name, unit, dataSource = "")` function. **These variables are scoped to each instance of the aircraft that use them, so each instance will have a unique version of the local variables you define in this section** (unlike the un-scoped `L` var type defined in the `[LocalVars.N]` section).

When an aircraft is selected by a user and the flight is first started, these "`L:1`" vars are defined using the `LocalVar.N` parameter and then initialised using a default value (done using the `LocalVarDefault.N` parameter). Any changes to these variables that have been made will then be saved to a file (`state.cfg`) when the flight is exited. This file will be saved to a local location on the users computer using the following path schema:

- `STEAM: C:\Users\<USERNAME>\AppData\Roaming\Microsoft Flight Simulator\SimObjects\<AIRCRAFT_NAME>\state.cfg`

- `MS STORE: C:\Users\<USERNAME>\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\SimObjects\<AIRCRAFT_NAME>\state.cfg`

The next time the aircraft is used, the local variables will be initialised as before, only now they will be set to the values stored in the `state.cfg`.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

The variables defined here take precedence over those stored in the `FLT` file, and will overwrite any with the same name that are saved to that file when an aircraft is loaded.

{{< /callout >}}

Note that if you define a variable here but don't initialise it with a default value, then the first time it is used it will be considered as having a value of 0.

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="LocalVar.N-LocalVars_EX1" />}}`LocalVar.N` | This defines the name of one or more local variables that will have their value saved. Each variable should be defined as a string, and is indexed from 1. For example:<span></span>`LocalVar.1 = myLocalVariable` | String | No |
| {{< anchor id="LocalVarDefault.N-LocalVars_EX1" />}}`LocalVarDefault.N` | This defines a local variable default value. Each variable defined using the parameter should have a corresponding default value and index, with the indexing starting at 1. For example:<span></span>`LocalVarDefault.1 = 10` | int/float/string, etc... | No |

{{< /table-wrapper >}}


### [WASM_SYSTEM.*N*]

This section is used to set up a reference to a WASM system module. This is an *indexed* section, with the indices starting at 0 and going up by 1 in consecutive order. Each indexed section is used to setup a single WASM system, and has the following parameters:

{{< table-wrapper "300px" "" "150px" "100px" >}}

| Parameter | Description | Type | Required |
|---|---|---|:---:|
| {{< anchor id="ModulePath" />}}`ModulePath` | This is the path to the WASM module relative to the root of your package. This path must point to a location *in the same package as the SimObject referencing the module*, as you cannot reference modules from outside the package. If you wish to share a module between multiple packages, then it should be configured as a [SimAttachment](../../modular-simobjects/modular-simobject-project-structure/#attachments).<span></span>`ModulePath=SimObjects/Airplanes/Asobo_ES30/attachments/asobo/Function_Exterior/wasm/ES30_ElectricMotor_Simulation.wasm` | String | Yes |
| {{< anchor id="SystemName" />}}`SystemName` | The name of the system that is being added to the SimObject, for example:<span></span>`SystemName=motor_sim`<span></span>This name is used to determine the name of the callback in the code, and allows to you have multiple systems with different names in the same base module. | String | Yes |
| {{< anchor id="ParameterString" />}}`ParameterString` | This is a string of data given back during the call to the INIT callback of the system. It may be, for example, the name of the aircraft variation so the module can selectively init variables, the number of engines, etc... How this string is parsed is up to the code in the module.<span></span>`ParameterString="AircraftVariationName, 1"` | String | No |

{{< /table-wrapper >}}

For more information on WASM System modules, please see the following page:

-   [Creating WASM Systems](../../../programming-apis/wasm/creating-wasm-systems/)