HELICOPTER VARIABLES

The tables below indicate the properties for the Simulation Variables that can be used to get and set properties related specifically to helicopters. 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

 

 

Collective

Simulation Variable Description Units Settable
COLLECTIVE POSITION The position of the helicopter\'s collective. 0 is fully up, 100 fully depressed. Percent Over 100

 

 

Rotors

Simulation Variable Description Units Settable
DISK BANK ANGLE:index

Rotor bank angle of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Radians
DISK BANK PCT:index

Rotor bank percent of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
DISK CONING PCT:index

Rotor coning percent of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
DISK PITCH ANGLE:index

Rotor pitch angle of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Radians
DISK PITCH PCT:index

Rotor pitch percent of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
HOVER INDUCED VELOCITY The difference between average rotor inflow and outflow velocity (\(Vi_0\)) in meters per second. Meters per second
NUMBER OF MAIN ROTORS This will return the number of main rotors available for the helicopter. This will be 2 if neither [MAINROTOR] nor [SECONDARYROTOR] are flagged as tail rotors, or 1 otherwise. Integer
ROTOR BRAKE ACTIVE

Whether the rotor brake is active (1, TRUE) or not (0, FALSE).

Bool
ROTOR BRAKE HANDLE POS

The percentage actuated of the rotor brake handle.

Percent Over 100
ROTOR CHIP DETECTED

Whether the rotor chip is detected (1,TRUE) or not (0, FALSE).

Bool
ROTOR CLUTCH ACTIVE

Whether the rotor clutch is active (1, TRUE) or not (0, FALSE).

Bool
ROTOR CLUTCH SWITCH POS

The rotor clutch switch position, either on (1 TRUE) or off (0, FALSE).

Bool
ROTOR COLLECTIVE BLADE PITCH PCT

The rotor collective blade pitch.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
ROTOR CYCLIC BLADE MAX PITCH POSITION

The position (angle) at which blade has the maximum cyclic pitch.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Degrees
ROTOR CYCLIC BLADE PITCH PCT

The rotor cyclic blade (maximum) pitch.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
ROTOR GOV ACTIVE:index

Whether the rotor governor is active (1, TRUE) or not (0, FALSE).

The SimVar takes an index value, which is the index of the engine to target. Note that an index of 0 will target the first engine (for backwards compatibility since this SimVar was changed to take an index).

Bool
ROTOR GOV TARGET PCT:index

Sets a target RPM as a ratio of nominal RPM for the indexed engine governor. For example, if the helicopter has a nominal RPM of 390 and its idle state RPM is 52% of this value, then setting the target value here to 0.52 will make the governor target the proper 200 RPM when idle.

The SimVar takes an index value, which is the index of the engine to target. Note that an index of 0 will target the first engine (for backwards compatibility since this SimVar was changed to take an index).

Percent Over 100
ROTOR GOV ENGINE TRIM:index

Retrieves the trim offset percentage for the governor target RPM of the indexed engine.

The SimVar takes an index value, which is the index of the engine to target. Note that an index of 0 will target the first engine (for backwards compatibility since this SimVar was changed to take an index).

Percent Over 100
ROTOR GOV SWITCH POS:index

The rotor governor switch position, either on (1 TRUE) or off (0, FALSE).

The SimVar takes an index value, which is the index of the engine to target. Note that an index of 0 will target the first engine (for backwards compatibility since this SimVar was changed to take an index).

Bool
ROTOR LATERAL TRIM PCT

The rotor lateral trim percentage.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
ROTOR LONGITUDINAL TRIM PCT

The rotor longitudinal trim percentage.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent Over 100
ROTOR ROTATION ANGLE:index

Rotor rotation angle of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Radians
ROTOR RPM:index

The indexed rotor RPM.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

RPM
ROTOR RPM PCT:index

Percent max rated rpm of the given rotor index.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

Percent Over 100
ROTOR TEMPERATURE

The main rotor transmission temperature.

Rankine
STRUCT ROTOR POSITION:index

The position of the indexed rotor.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

SIMCONNECT_DATA_XYZ

feet

TAIL ROTOR BLADE PITCH PCT The pitch position of the tailrotor blades. Percent Over 100
TAIL ROTOR PEDAL POSITION Percent tail rotor pedal deflection. Percent Over 100

 

 

Engine

Simulation Variable Description Units Settable
ENG ROTOR RPM:index

Returns the indexed rotor RPM.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

NOTE: This is available in multiplayer to all far aircraft. See here for more information: Note On SimVars In Multiplayer.

Percent scalar 16K (Max rpm * 16384)
ENG TORQUE PERCENT:index

Returns the indexed rotor torque.

The SimVar takes an index value, which is the index of the rotor to target. Note that an index of 0 will target the first rotor.

Percent scalar 16K (Ft/lbs * 16384)
HELICOPTER_MASTER_THROTTLE_POSITION Returns the position of the master throttle as a value between 0 and 1. Percent Over 100

 

 

Sling

Simulation Variable Description Units Settable
IS ATTACHED TO SLING Set to true if this object is attached to a sling. Bool
NUM SLING CABLES The number of sling cables (not hoists) that are configured for the helicopter. Number
SLING ACTIVE PAYLOAD STATION:index, param The payload station (identified by the parameter) where objects will be placed from the sling (identified by the index). Number
SLING CABLE BROKEN:index THis will be True (1) if the indexed cable is broken, or False (0) otherwise. Bool
SLING CABLE EXTENDED LENGTH:index The length of the indexed cable extending from the aircraft. Feet (ft)
SLING HOIST PERCENT DEPLOYED:index The percentage of the full length of the sling cable deployed. Percent Over 100
SLING HOIST SWITCH:index This will be True (1) if the hoist is enabled or False (0) otherwise. Bool
SLING HOOK IN PICKUP MODE This will be True (1) if the hook is in pickup mode or False (0) otherwise. When True, the hook will be capable of picking up another object. Bool
SLING OBJECT ATTACHED:index

If the SimVar units are set as boolean, this will return True (1) if a sling object is attached, or False (0) otherwise.

If the SimVar units are set as a string, tis will return the container title of the object.

Note that there can be multiple sling positions, indexed from 1. The sling positions are set in the Aircraft Configuration File.

Bool/String