Aircraft Misc. Variables

AIRCRAFT MISC VARIABLES

The tables below indicate the properties for the Simulation Variables that can be used to get and set properties various miscellaneous properties related to the aircraft. For information on the units listed for each variable, please see here: Simulation Variable Units

NOTE: When Microsoft Flight Simulator 2024 is running in multiplayer mode, only a small number of variables are communicated between aircraft. Those variables that are available will say so in the description as being either for "All Aircraft" or for "Shared Cockpit".

You can find a complete index of all available SimVars here: SimVar Index

Aircraft States

Simulation Variable	Description	Units
`CONTRAILS CONDITIONS MET`	True if the aircraft has met the conditions required to spawn the contrail VFX.	Bool
`IS SLEW ACTIVE`	True if slew is active.	Bool
`IS SLEW ALLOWED`	True if slew is enabled.	Bool
`IS USER SIM`	Is this the user loaded aircraft.	Bool
`ON ANY RUNWAY`	Whether or not the plane is currently on a runway.	Bool
`PLANE IN PARKING STATE`	Whether or not the plane is currently parked (true) or not (false).	Bool
`SURFACE CONDITION`	The state of the surface directly under the aircraft.	Enum: 0 = Normal 1 = Wet 2 = Icy 3 = Snow
`SURFACE INFO VALID`	True indicates that the `SURFACE CONDITION` return value is meaningful.	Bool
`SURFACE TYPE`	The type of surface under the aircraft.	Enum: 0 = Concrete 1 = Grass 2 = Water 3 = Grass_bumpy 4 = Asphalt 5 = Short_grass 6 = Long_grass 7 = Hard_turf 8 = Snow 9 = Ice 10 = Urban 11 = Forest 12 = Dirt 13 = Coral 14 = Gravel 15 = Oil_treated 16 = Steel_mats 17 = Bituminus 18 = Brick 19 = Macadam 20 = Planks 21 = Sand 22 = Shale 23 = Tarmac 24 = Wright flyer track
`STRUCTURAL ICE PCT`	Amount of ice on aircraft structure. 100 is fully iced.	Percent Over 100
`TITLE`	Title from aircraft.cfg.	String (max 128 chars)
`LIVERY NAME`	Name from livery.cfg.	String (max 128 chars)
`LIVERY FOLDER`	Folder where livery.cfg is stored.	String (max 128 chars)
`WINDSHIELD RAIN EFFECT AVAILABLE`	Is visual effect available on this aircraft.	Bool

Aircraft Position, Direction And Speed

Simulation Variable	Description	Units
`ACCELERATION BODY X`	Acceleration relative to aircraft X axis, in east/west direction.	Feet (ft) per second squared
`ACCELERATION BODY Y`	Acceleration relative to aircraft Y axis, in vertical direction.	Feet (ft) per second squared
`ACCELERATION BODY Z`	Acceleration relative to aircraft Z axis, in north/south direction.	Feet (ft) per second squared
`ACCELERATION WORLD X`	Acceleration relative to the earth X axis, in east/west direction.	Feet (ft) per second squared
`ACCELERATION WORLD Y`	Acceleration relative to the earth Y axis, in vertical direction.	Feet (ft) per second squared
`ACCELERATION WORLD Z`	Acceleration relative to the earth Z axis, in north/south direction.	Feet (ft) per second squared
`AIRCRAFT AGL`	The altitude of the aircraft above the surface of the world terrain.	Feet (ft)
`AIRCRAFT ALTITUDE ABOVE OBSTACLES`	The altitude of the aircraft above the surface of the world terrain, including any obstacles like buildings.	Feet (ft)
`SURFACE RELATIVE GROUND SPEED`	The speed of the aircraft relative to the speed of the first surface directly underneath it. Use this to retrieve, for example, an aircraft's taxiing speed while it is moving on a moving carrier. It also applies to airborne aircraft, for example when a helicopter is successfully hovering above a moving ship, this value should be zero. The returned value will be the same as `GROUND VELOCITY` if the first surface beneath it is not moving.	Feet per second
`GROUND VELOCITY`	Speed relative to the earths surface. NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.	Knots
`PLANE ALTITUDE`	Altitude of aircraft.	Feet (ft)
`PLANE ALT ABOVE GROUND`	Altitude above the surface of the world, including obstacles like buildings.	Feet (ft)
`PLANE ALT ABOVE GROUND MINUS CG`	Altitude above the surface, including obstacles like buildings, minus CG.	Feet (ft)
`PLANE BANK DEGREES`	Bank angle, although the name mentions degrees the units used are radians.	Radians
`PLANE HEADING DEGREES GYRO`	Heading indicator taken from the aircraft gyro.	Degrees
`PLANE HEADING DEGREES MAGNETIC`	Heading relative to magnetic north - although the name mentions degrees the units used are radians.	Radians
`PLANE HEADING DEGREES TRUE`	Heading relative to true north - although the name mentions degrees the units used are radians.	Radians
`PLANE LATITUDE`	Latitude of aircraft, North is positive, South negative.	Radians
`PLANE LONGITUDE`	Longitude of aircraft, East is positive, West negative.	Radians
`PLANE PITCH DEGREES`	Pitch angle, although the name mentions degrees the units used are radians.	Radians
`PLANE TOUCHDOWN BANK DEGREES`	This float represents the bank of the player's plane from the last touchdown.	Degrees
`PLANE TOUCHDOWN HEADING DEGREES MAGNETIC`	This float represents the magnetic heading of the player's plane from the last touchdown.	Degrees
`PLANE TOUCHDOWN HEADING DEGREES TRUE`	This float represents the true heading of the player's plane from the last touchdown.	Degrees
`PLANE TOUCHDOWN LATITUDE`	This float represents the plane latitude for the last touchdown.	Radians
`PLANE TOUCHDOWN LONGITUDE`	This float represents the plane longitude for the last touchdown.	Radians
`PLANE TOUCHDOWN NORMAL VELOCITY`	This float represents the player's plane speed according to ground normal from the last touchdown.	Feet (ft) per second
`PLANE TOUCHDOWN PITCH DEGREES`	This float represents the pitch of the player's plane from the last touchdown.	Degrees
`RELATIVE WIND VELOCITY BODY X`	Lateral (X axis) speed relative to wind.	Feet (ft) per second
`RELATIVE WIND VELOCITY BODY Y`	Vertical (Y axis) speed relative to wind.	Feet (ft) per second
`RELATIVE WIND VELOCITY BODY Z`	Longitudinal (Z axis) speed relative to wind.	Feet (ft) per second
`ROTATION ACCELERATION BODY X`	Rotation acceleration relative to aircraft X axis.	Radians per second squared
`ROTATION ACCELERATION BODY Y`	Rotation acceleration relative to aircraft Y axis.	Radians per second squared
`ROTATION ACCELERATION BODY Z`	Rotation acceleration relative to aircraft Z axis.	Radians per second squared
`ROTATION VELOCITY BODY X`	Rotation velocity relative to aircraft X axis.	Feet (ft) per second
`ROTATION VELOCITY BODY Y`	Rotation velocity relative to aircraft Y axis.	Feet (ft) per second
`ROTATION VELOCITY BODY Z`	Rotation velocity relative to aircraft Z axis.	Feet (ft) per second
`SLOPE TO ATC RUNWAY`	The slope between the plane and the expected landing position of the runway. Returns 0 if no runway is assigned.	Radians
`VELOCITY BODY X`	True lateral speed, relative to aircraft X axis.	Feet (ft) per second
`VELOCITY BODY Y`	True vertical speed, relative to aircraft Y axis.	Feet (ft) per second
`VELOCITY BODY Z`	True longitudinal speed, relative to aircraft Z axis.	Feet (ft) per second
`VERTICAL SPEED`	The current indicated vertical speed for the aircraft.	Feet (ft) per second

Aircraft Warnings

Simulation Variable	Description	Units
`WARNING FUEL`	This is the current state of the fuel warning, either on (`true`) or off (`false`).	Bool
`WARNING FUEL LEFT`	This is the current state of the left fuel tank warning, either on (`true`) or off (`false`).	Bool
`WARNING FUEL RIGHT`	This is the current state of the right fuel tank warning, either on (`true`) or off (`false`).	Bool
`WARNING LOW HEIGHT`	This is the current state of the low height warning, either on (`true`) or off (`false`).	Bool
`WARNING OIL PRESSURE`	This is the current state of the oil pressure warning, either on (`true`) or off (`false`).	Bool
`WARNING VACUUM`	This is the current state of the vacuum system warning, either on (`true`) or off (`false`).	Bool
`WARNING VACUUM LEFT`	This is the current state of the left vacuum system warning, either on (`true`) or off (`false`).	Bool
`WARNING VACUUM RIGHT`	This is the current state of the right vacuum system warning, either on (`true`) or off (`false`).	Bool
`WARNING VOLTAGE`	This is the current state of the electrical system voltage warning, either on (`true`) or off (`false`).	Bool

Aircraft Wear And Tear States

The SimVars listed here are all related to the [WEAR_AND_TEAR_SYSTEM]. Most of the SimVars in this section require an ID value or name, as well as an (optional in some cases) index value. For example, if you are targeting the first piston engine of a two engine aircraft, then you could access it using the following formats:

1 (A:1:WEAR AND TEAR LEVEL:'PISTON_ENGINE'_n, percent)
1 (A:1:WEAR AND TEAR LEVEL:39, percent)

In both cases the wear and tear level check is being done on the 1st piston engine.

Simulation Variable	Parameters	Description	Units
`WEAR AND TEAR CHECK PROGRESSION`	[0] Component ID [1] Component Index (optional)	This SimVar is only valid during the pre-flight inspection phase of a flight, it is used to get (or set) the timer used for the inspection interaction (the circular progress bar) with a particular component. The component is identified by the given component ID/name and index. See the Wear And Tear Component IDs section for a full list of component names/IDs.	Percent Over 100
`WEAR AND TEAR EXPOSED PARTS LEVEL`	N/A	This SimVar returns the *average* wear and tear level of the exposed parts of the aircraft. The SimVar does not take any ID or index, as it is based on an internal calculation which takes data from multiple different sources, like the control surfaces, engines, etc... The SimVar returns a value between 0 and 1 where a 1 means that the aircraft is fully functional and undamaged, and a value of 0 means that the aircraft is seriously damaged and potentially unflyable.	Percent Over 100
`WEAR AND TEAR EXPOSED PARTS LOWEST LEVEL`	N/A	This SimVar returns the *lowest* wear and tear level of the exposed parts of the aircraft. The SimVar does not take any ID or index, as it is based on an internal calculation which takes data from multiple different sources, like the control surfaces, engines, etc... The SimVar returns a value between 0 and 1 where a 1 means that the aircraft is fully functional and undamaged, and a value of 0 means that the aircraft is seriously damaged and potentially unflyable.	Percent Over 100
`WEAR AND TEAR IS FAILED`	[0] Component ID [1] Component Index (optional)	This SimVar will return TRUE (1) if the given component ID/name has failed completely, ie: it's "health" has fallen to zero and the component is considered by the simulation as "broken". If the component is still functioning, regardless of how "weak" it may be, then this will return FALSE (1). See the Wear And Tear Component IDs section for a full list of component names/IDs.	Bool
`WEAR AND TEAR IS WEAK`	[0] Component ID [1] Component Index (optional)	This SimVar will return TRUE (1) if the given component ID/name is considered as being "weak", ie: it's "health" has fallen to a point where it could fail or break, and the compònent may have reduced functionality. If the component is not considered as "weak" (even if its wear and tear value is less than 1), then this will return FALSE (1). See the Wear And Tear Component IDs section for a full list of component names/IDs.	Bool
`WEAR AND TEAR LEVEL`	[0] Component ID [1] Component Index (optional)	This SimVar returns the current wear and tear level of the component or system being referenced, where a value of 1 is a fully functional and undamaged component, and a value of 0 means that the component has failed. The SimVar requires an ID value or name, and may also use an additional index value to tell the simulation exactly which one of the components of the given type you are targeting. See the Wear And Tear Component IDs section for a full list of component names/IDs.	Percent Over 100
`WEAR AND TEAR WEAK VALUE`	[0] Component ID [1] Component Index (optional)	This SimVar returns the current "weakness" level of the component or system being referenced, where a value of 1 is a fully functional (but not necessarily undamaged) component, and a value of 0 means that the component has failed. If this value is less than 1, then the component will experience reduced functionality and may also be more prone to failure and breaking. The SimVar requires an ID value or name, and may also use an additional index value to tell the simulation exactly which one of the components of the given type you are targeting. See the Wear And Tear Component IDs section for a full list of component names/IDs.	Percent Over 100

Wear And Tear Component IDs

Below is the list of components IDs that can be used in the Wear And Tear SimVars as the ID or name of the component to check.

0: FUEL_TANK
1: FUEL_PUMP
2: FUEL_VALVE
3: FUEL_JUNCTION
4: FUEL_LINE
5: FLAPS_LEFT
6: FLAPS_RIGHT
7: FLAPS_LEFT_CABLE
8: FLAPS_RIGHT CABLE
9: AILERONS_LEFT
10: AILERONS_RIGHT
11: AILERONS_LEFT_CABLE
12: AILERONS_RIGHT_CABLE
13: ELEVATOR
14: ELEVATOR_CABLE
19: RUDDER
20: RUDDER_CABLE
21: HYDRAULIC_RESERVOIR
22: HYDRAULIC_PUMP
23: HYDRAULIC_VALVE
24: HYDRAULIC_ACTUATOR
25: HYDRAULIC_PTU
26: HYDRAULIC_ACCUMULATOR
27: HYDRAULIC_LINE
28: ELECTRICAL_ALTERNATOR
29: ELECTRICAL_BATTERY
30: ELECTRICAL_IDG
31: ELECTRICAL_RAT
32: ELECTRICAL_BUS
33: ELECTRICAL_CIRCUIT
34: ELECTRICAL_RECTIFIERS
35: LANDING_GEAR
36: BRAKE
37: TIRE
38: TIRE_PRESSURE
39: PISTON_ENGINE
40: TURBINE_ENGINE
41: OIL_TANK_INTEGRITY
42: OIL_TANK_AMOUNT
43: AUTOPILOT_BANK
44: AUTOPILOT_PITCH
45: AUTOPILOT_YAW
46: GENERAL

Aircraft Structs

Simulation Variable	Description	Units
`EYEPOINT POSITION`	The eyepoint position relative to the reference datum position for the aircraft.	`SIMCONNECT_DATA_XYZ` feet
`STRUC AIRSPEED HOLD PID CONSTS`	Returns the various airspeed PID constants. This is generally only used for AI controlled aircraft and boats, although it may be useful when working with RTCs and the user aircraft.	`PID_STRUCT`
`STRUC HEADING HOLD PID CONSTS`	Returns the various airspeed PID constants. This is generally only used for AI controlled aircraft and boats, although it may be useful when working with RTCs and the user aircraft.	`PID_STRUCT`
`STRUCT BODY ROTATION ACCELERATION`	The body rotation acceleration.	`SIMCONNECT_DATA_XYZ` radians per second
`STRUCT BODY ROTATION VELOCITY`	The body rotation velocity.	`SIMCONNECT_DATA_XYZ` radians per second
`STRUCT BODY VELOCITY`	The object body velocity.	`SIMCONNECT_DATA_XYZ` feet per second
`STRUCT ENGINE POSITION:index`	The position of the indexed engine relative to the Datum Reference Point for the aircraft.	`SIMCONNECT_DATA_XYZ` feet.
`STRUCT EYEPOINT DYNAMIC ANGLE`	The angle of the eyepoint view. Zero, zero, zero is straight ahead.	`SIMCONNECT_DATA_XYZ` radians
`STRUCT EYEPOINT DYNAMIC OFFSET`	A variable offset away from the EYEPOINT POSITION.	`SIMCONNECT_DATA_XYZ` feet
`STRUCT LATLONALT`	Returns the latitude, longitude and altitude of the user aircraft.	`SIMCONNECT_DATA_LATLONALT`
`STRUCT LATLONALTPBH`	Returns the lattitude, longitude, altitude, pitch, bank and heading of the user aircraft.	Returns a struct with 6 values: lat, lon, alt, pitch, bank, heading

Airspeed

Simulation Variable	Description	Units
`AIRCRAFT WIND X`	Wind component in aircraft lateral (X) axis.	Knots
`AIRCRAFT WIND Y`	Wind component in aircraft vertical (Y) axis.	Knots
`AIRCRAFT WIND Z`	Wind component in aircraft longitudinal (Z) axis.	Knots
`AIRSPEED BARBER POLE`	Redline airspeed (dynamic on some aircraft).	Knots
`AIRSPEED INDICATED`	Indicated airspeed.	Knots
`AIRSPEED MACH`	Current mach.	Mach
`AIRSPEED SELECT INDICATED OR TRUE`	The airspeed, whether true or indicated airspeed has been selected.	Knots
`AIRSPEED TRUE`	True airspeed.	Knots
`AIRSPEED TRUE RAW`	Equivalent to `AIRSPEED TRUE`, but does not account for wind when used to Set Airspeed value	Knots
`BARBER POLE MACH`	Mach associated with maximum airspeed.	Mach
`TOTAL VELOCITY`	Velocity regardless of direction. For example, if a helicopter is ascending vertically at 100 fps, getting this variable will return 100.	Feet (ft per second
`WINDSHIELD WIND VELOCITY`	Longitudinal speed of wind on the windshield.	Feet (ft per second

Temperature

Simulation Variable	Description	Units	Settable
`STANDARD ATM TEMPERATURE`	Outside temperature on the standard ATM scale.	Rankine
`TOTAL AIR TEMPERATURE`	Total air temperature is the air temperature at the front of the aircraft where the ram pressure from the speed of the aircraft is taken into account.	Celsius

Ornithopter

Simulation Variable	Parameters	Description	Units
`ORNITHOPTER CONTROL LEVERS X`	N/A	The deflection control left / right, usually used for animation.	Position 16k
`ORNITHOPTER CONTROL LEVERS Y`	N/A	The deflection control fore / aft, usually used for animation.	Position 16k
`ORNITHOPTER DIVE MODE ENABLED`	N/A	Returns whether the ornithopter dive mode is enabled (TRUE) or not (FALSE).	Boolean
`ORNITHOPTER GLIDE MODE ENABLED`	N/A	Returns whether the ornithopter glide mode is enabled (TRUE) or not (FALSE).	Boolean
`ORNITHOPTER WINGS BRAKE ENABLED`	N/A	Returns whether the ornithopter wing brake is enabled (TRUE) or not (FALSE).	Boolean
`ORNITHOPTER WINGS BRAKE ACTIVE`	N/A	Returns whether the ornithopter wing brake is active (TRUE) or not (FALSE).	Boolean
`ORNITHOPTER WING HORIZONTAL TILT`	[0] Wing Index	The horizontal tilt of the indexed wing expressed as a value between 0 and 1.	Percent Over 100
`ORNITHOPTER WING PITCH`	[0] Wing Index	The pitch of the indexed wing expressed as a value between 0 and 1.	Percent Over 100
`ORNITHOPTER WING VERTICAL TILT`	[0] Wing Index	The vertical tilt of the indexed wing expressed as a value between 0 and 1.	Percent Over 100
`ORNITHOPTER WINGS BLUR`	N/A	The current amount of blur applied to the animation of the ornithopter wings when flapping, expressed as a value between 0 (none) and 1 (maximum).	Percent Over 100
`ORNITHOPTER WINGS CLUTCH STATE`	N/A	The current progress of engaging/disengaging the clutch on the wings when entering or leaving glide mode, expressed as a value between 0 and 1.	Percent Over 100
`ORNITHOPTER WINGS FOLDING OPERATION ID`	N/A	Returns a value that defines the current folding operation of the wings, where: 0 - stand by 1 - parking (slow mode) 2 - setting up (slow mode) 3 - folding for diving (fast mode) 4 - unfolding from a dive (fast mode)	Number
`ORNITHOPTER WORLD LIFT`	N/A	Returns the current total lift of the ornithopter.	Pounds (lbs)