AIRCRAFT FUEL SYSTEM EVENTS

The event IDs listed here are all related to the fuel systems of an aircraft.

 

 

Cross Feed

Event ID Key Name Parameters Description
CROSS_FEED_OPEN KEY_CROSS_FEED_OPEN

N/A

Opens cross feed valve (when used in conjunction with "isolate" tank)
CROSS_FEED_TOGGLE KEY_CROSS_FEED_TOGGLE

N/A

Toggles crossfeed valve (when used in conjunction with "isolate" tank)
CROSS_FEED_OFF KEY_CROSS_FEED_OFF

N/A

Closes crossfeed valve (when used in conjunction with "isolate" tank)
CROSS_FEED_LEFT_TO_RIGHT KEY_CROSS_FEED_LEFT_TO_RIGHT

N/A

Sets the fuel crossfeed to be from left to right.
CROSS_FEED_RIGHT_TO_LEFT KEY_CROSS_FEED_RIGHT_TO_LEFT

N/A

Sets the fuel crossfeed to be from right to left.

 

 

Fuel Selector

Event ID Key Name Parameters Description
FUEL_SELECTOR_ALL KEY_FUEL_SELECTOR_ALL

N/A

Turn fuel selector 1 to the ALL position.
FUEL_SELECTOR_CENTER KEY_FUEL_SELECTOR_CENTER

N/A

Turns selector 1 to CENTER position.
FUEL_SELECTOR_LEFT KEY_FUEL_SELECTOR_LEFT

N/A

Turns selector 1 to LEFT position (fuel will be retrieved from Left Tip then Left Aux then Left Main).
FUEL_SELECTOR_LEFT_AUX KEY_FUEL_SELECTOR_LEFT_AUX

N/A

Turns selector 1 to LEFT AUX position.
FUEL_SELECTOR_LEFT_MAIN KEY_FUEL_SELECTOR_LEFT_MAIN

N/A

Sets the fuel selector for engine 1 to the left Main tank.

FUEL_SELECTOR_OFF KEY_FUEL_SELECTOR_OFF

N/A

Turn fuel selector 1 to the OFF position.
FUEL_SELECTOR_RIGHT KEY_FUEL_SELECTOR_RIGHT

N/A

Turns selector 1 to RIGHT position (fuel will be retrieved from Right Tip then Right Aux then Right Main).
FUEL_SELECTOR_RIGHT_AUX KEY_FUEL_SELECTOR_RIGHT_AUX

N/A

Turns selector 1 to RIGHT AUX position.
FUEL_SELECTOR_RIGHT_MAIN KEY_FUEL_SELECTOR_RIGHT_MAIN

N/A

Sets the fuel selector for engine 1 to the right Main tank.

FUEL_SELECTOR_SET KEY_FUEL_SELECTOR_SET

[0]: Number

Sets selector 1 position (see the Fuel Selector Codes list for the correct code to use).
FUEL_SELECTOR_1_ISOLATE KEY_FUEL_SELECTOR_1_ISOLATE

N/A

Sets fuel selector 1 to "Isolate".
FUEL_SELECTOR_1_CROSSFEED KEY_FUEL_SELECTOR_1_CROSSFEED

N/A

Sets fuel selector 1 to "Crossfeed".
FUEL_SELECTOR_2_ALL KEY_FUEL_SELECTOR_2_ALL

N/A

Turns selector 2 to ALL position.
FUEL_SELECTOR_2_CENTER KEY_FUEL_SELECTOR_2_CENTER

N/A

Turns selector 2 to CENTER position.
FUEL_SELECTOR_2_CROSSFEED KEY_FUEL_SELECTOR_2_CROSSFEED

N/A

Sets fuel selector 2 to "Crossfeed".
FUEL_SELECTOR_2_ISOLATE KEY_FUEL_SELECTOR_2_ISOLATE

N/A

Sets fuel selector 2 to "Isolate".
FUEL_SELECTOR_2_LEFT KEY_FUEL_SELECTOR_2_LEFT

N/A

Turns selector 2 to LEFT position (fuel will be retrieved from Left Tip then Left Aux then Left Main).
FUEL_SELECTOR_2_LEFT_AUX KEY_FUEL_SELECTOR_2_LEFT_AUX

N/A

Turns selector 2 to LEFT AUX position.
FUEL_SELECTOR_2_LEFT_MAIN KEY_FUEL_SELECTOR_2_LEFT_MAIN

N/A

Sets the fuel selector for engine 2 to the left Main tank.
FUEL_SELECTOR_2_OFF KEY_FUEL_SELECTOR_2_OFF

N/A

Turns selector 2 to OFF position.
FUEL_SELECTOR_2_RIGHT KEY_FUEL_SELECTOR_2_RIGHT

N/A

Turns selector 2 to RIGHT position (fuel will be retrieved from Right Tip then Right Aux then Right Main)
FUEL_SELECTOR_2_RIGHT_AUX KEY_FUEL_SELECTOR_2_RIGHT_AUX

N/A

Turns selector 2 to RIGHT AUX position.
FUEL_SELECTOR_2_RIGHT_MAIN KEY_FUEL_SELECTOR_2_RIGHT_MAIN

N/A

Sets the fuel selector for engine 2 to the right Main tank.
FUEL_SELECTOR_2_SET KEY_FUEL_SELECTOR_2_SET

[0]: Number

Sets selector 2 position (see the Fuel Selector Codes list for the correct code to use).
FUEL_SELECTOR_3_ALL KEY_FUEL_SELECTOR_3_ALL

N/A

Turns selector 3 to ALL position.
FUEL_SELECTOR_3_CENTER KEY_FUEL_SELECTOR_3_CENTER

N/A

Turns selector 3 to CENTER position.
FUEL_SELECTOR_3_CROSSFEED KEY_FUEL_SELECTOR_3_CROSSFEED

N/A

Sets fuel selector 3 to "Crossfeed".
FUEL_SELECTOR_3_ISOLATE KEY_FUEL_SELECTOR_3_ISOLATE

N/A

Sets fuel selector 3 to "Isolate".
FUEL_SELECTOR_3_LEFT KEY_FUEL_SELECTOR_3_LEFT

N/A

Turns selector 3 to LEFT position (fuel will be retrieved from Left Tip then Left Aux then Left Main).
FUEL_SELECTOR_3_LEFT_AUX KEY_FUEL_SELECTOR_3_LEFT_AUX

N/A

Turns selector 3 to LEFT AUX position.
FUEL_SELECTOR_3_LEFT_MAIN KEY_FUEL_SELECTOR_3_LEFT_MAIN

N/A

Sets the fuel selector for engine 3 to the left Main tank.
FUEL_SELECTOR_3_OFF KEY_FUEL_SELECTOR_3_OFF

N/A

Turns selector 3 to OFF position.
FUEL_SELECTOR_3_RIGHT KEY_FUEL_SELECTOR_3_RIGHT

N/A

Turns selector 3 to RIGHT position (fuel will be retrieved from Right Tip then Right Aux then Right Main).
FUEL_SELECTOR_3_RIGHT_AUX KEY_FUEL_SELECTOR_3_RIGHT_AUX

N/A

Turns selector 3 to RIGHT AUX position.
FUEL_SELECTOR_3_RIGHT_MAIN KEY_FUEL_SELECTOR_3_RIGHT_MAIN

N/A

Sets the fuel selector for engine 3 to the right Main tank.
FUEL_SELECTOR_3_SET KEY_FUEL_SELECTOR_3_SET

[0]: Number

Sets selector 3 position (see the Fuel Selector Codes list for the correct code to use).
FUEL_SELECTOR_4_ALL KEY_FUEL_SELECTOR_4_ALL

N/A

Turns selector 4 to ALL position.
FUEL_SELECTOR_4_CENTER KEY_FUEL_SELECTOR_4_CENTER

N/A

Turns selector 4 to CENTER position.
FUEL_SELECTOR_4_CROSSFEED KEY_FUEL_SELECTOR_4_CROSSFEED

N/A

Sets fuel selector 4 to "Crossfeed".
FUEL_SELECTOR_4_ISOLATE KEY_FUEL_SELECTOR_4_ISOLATE

N/A

Sets fuel selector 4 to "Isolate".
FUEL_SELECTOR_4_OFF KEY_FUEL_SELECTOR_4_OFF

N/A

Turns selector 4 to OFF position.
FUEL_SELECTOR_4_LEFT KEY_FUEL_SELECTOR_4_LEFT

N/A

Turns selector 4 to LEFT position (fuel will be retrieved from Left Tip then Left Aux then Left Main).
FUEL_SELECTOR_4_LEFT_AUX KEY_FUEL_SELECTOR_4_LEFT_AUX

N/A

Turns selector 4 to LEFT AUX position.
FUEL_SELECTOR_4_LEFT_MAIN KEY_FUEL_SELECTOR_4_LEFT_MAIN

N/A

Sets the fuel selector for engine 4 to the left Main tank.
FUEL_SELECTOR_4_RIGHT KEY_FUEL_SELECTOR_4_RIGHT

N/A

Turns selector 4 to RIGHT position (fuel will be retrieved from Right Tip then Right Aux then Right Main).
FUEL_SELECTOR_4_RIGHT_AUX KEY_FUEL_SELECTOR_4_RIGHT_AUX

N/A

Turns selector 4 to RIGHT AUX position.
FUEL_SELECTOR_4_RIGHT_MAIN KEY_FUEL_SELECTOR_4_RIGHT_MAIN

N/A

Sets the fuel selector for engine 4 to the right Main tank.
FUEL_SELECTOR_4_SET KEY_FUEL_SELECTOR_4_SET

[0]: Number

Sets selector 4 position (see the Fuel Selector Codes list for the correct code to use).

 

 

Fuel System

These key event IDs are used to control the modern Microsoft Flight Simulator 2024 [FUEL_SYSTEM].

 

Event ID Key Name Parameters Description
FUELSYSTEM_JUNCTION_SET KEY_FUELSYSTEM_JUNCTION_SET

[0]: Junction Index

[1]: Option index

Set the current junction options for which lines are open or closed at any given time. This event requires two parameters: the first is the index of the junction (as defined by the N index of the Junction.N parameter), and the second is the Option index, which is what sets the lines to open/close.
FUELSYSTEM_PUMP_OFF KEY_FUELSYSTEM_PUMP_OFF

[0]: Pump Index

Turn a fuel pump off. The event requires the N index of the Pump.N parameter to define the pump to use.
FUELSYSTEM_PUMP_ON KEY_FUELSYSTEM_PUMP_ON

[0]: Pump Index

Turn a fuel pump on. The event requires the N index of the Pump.N parameter to define the pump to use.
FUELSYSTEM_PUMP_SET KEY_FUELSYSTEM_PUMP_SET

[0]: Pump Index

[1]: Status
0 = Off
1 = On
2 = Auto

Set a fuel pump to be either on or off or auto. The event requires the N index of the Pump.N parameter to define the pump to use.
FUELSYSTEM_PUMP_TOGGLE KEY_FUELSYSTEM_PUMP_TOGGLE

[0]: Pump Index

Toggle a fuel pump on/off. The event requires the N index of the Pump.N parameter to define the pump to use.
FUELSYSTEM_TRIGGER_OFF KEY_FUELSYSTEM_TRIGGER_OFF

[0]: Trigger Index

Turn a trigger event off. The event requires the N index of the Trigger.N parameter to define the trigger to switch off.
FUELSYSTEM_TRIGGER_ON KEY_FUELSYSTEM_TRIGGER_ON

[0]: Trigger Index

Turn a trigger event on. The event requires the N index of the Trigger.N parameter to define the trigger to switch off.
FUELSYSTEM_TRIGGER_SET KEY_FUELSYSTEM_TRIGGER_SET

[0]: Trigger Index

[1]: Status, either on (1) or off (0)

Set a trigger event to be either on or off. The event requires the N index of the Trigger.N parameter to define the trigger to switch off.
FUELSYSTEM_TRIGGER_TOGGLE KEY_FUELSYSTEM_TRIGGER_TOGGLE

[0]: Trigger Index

Toggle a trigger event on/off. The event requires the N index of the Trigger.N parameter to define the trigger to switch off.
FUELSYSTEM_VALVE_CLOSE KEY_FUELSYSTEM_VALVE_CLOSE

[0]: Valve Index

Close a specific valve in the fuel system. The event requires the N index of the Valve.N parameter to define the valve to target.
FUELSYSTEM_VALVE_OPEN KEY_FUELSYSTEM_VALVE_OPEN

[0]: Valve Index

Open a specific valve in the fuel system. The event requires the N index of the Valve.N parameter to define the valve to target.
FUELSYSTEM_VALVE_SET KEY_FUELSYSTEM_VALVE_SET

[0]: Valve Index

[1]: Status, either open (1) or closed (0)

Set a valve to be either open or closed. The event requires the N index of the Valve.N parameter to define the valve to target.
FUELSYSTEM_VALVE_TOGGLE KEY_FUELSYSTEM_VALVE_TOGGLE

[0]: Valve Index

Toggle a valve open/closed. The event requires the N index of the Valve.N parameter to define the valve to target.

 

 

Fuel Transfer Keys

The following keys are only required when using the legacy [FUEL] system.

 

Event ID Key Name Parameters Description
SET_FUEL_TRANSFER_CUSTOM KEY_SET_FUEL_TRANSFER_CUSTOM N/A Set the fuel transfer mode to the "custom" setting. Requires that at least 1 transfer pump has been defined in the flight_model.cfg file using the fuel_transfer_pump.N parameter.
FUEL_TRANSFER_CUSTOM_INDEX_TOGGLE KEY_FUEL_TRANSFER_CUSTOM_INDEX_TOGGLE [0]: pump Index Toggle a custom fuel transfer pump on/off. The index is the Pump ID value supplied as part of the fuel pump definition for the fuel_transfer_pump.N parameter in the flight_model.cfg file.
SET_FUEL_TRANSFER_FORWARD KEY_SET_FUEL_TRANSFER_FORWARD N/A Set the fuel transfer system to use the "forward" setting, which pumps from tank 1 to tank 2.
SET_FUEL_TRANSFER_AFT KEY_SET_FUEL_TRANSFER_AFT N/A Set the fuel transfer system to use the "aft" setting, which pumps from tank 2 to tank 1.
SET_FUEL_TRANSFER_AUTO KEY_SET_FUEL_TRANSFER_AUTO N/A Set the fuel transfer pump to automatically balance the fuel in tanks 1 and 2 to maintain the CG.
SET_FUEL_TRANSFER_OFF KEY_SET_FUEL_TRANSFER_OFF N/A Set the fuel transfer pump to off.

 

 

Miscellaneous

Event ID Key Name Parameters Description
ADD_FUEL_QUANTITY KEY_ADD_FUEL_QUANTITY

[0]: The fuel quantity

Adds fuel to the aircraft, 25% of capacity by default. 0 to 65535 (max fuel) can be passed.
ELECT_FUEL_PUMP_SET KEY_ELECT_FUEL_PUMP_SET [0]: Value

Set the electrical pump status for all engines. Values are as follows:

  • 0 = Off
  • 1 = On
  • 2 = Auto

These keys are only useful when using the legacy [FUEL] system.

ELECT_FUEL_PUMP1_SET
ELECT_FUEL_PUMP2_SET
ELECT_FUEL_PUMP3_SET
ELECT_FUEL_PUMP4_SET

KEY_ELECT_FUEL_PUMP1_SET

KEY_ELECT_FUEL_PUMP2_SET

KEY_ELECT_FUEL_PUMP3_SET

KEY_ELECT_FUEL_PUMP4_SET

[0]: Value

Set the electrical pump status for engines 1-4. Values are as follows:

  • 0 = Off
  • 1 = On
  • 2 = Auto

These keys are only useful when using the legacy [FUEL] system.

ENGINE_FUELFLOW_BUG_POSITION1
ENGINE_FUELFLOW_BUG_POSITION2
ENGINE_FUELFLOW_BUG_POSITION3
ENGINE_FUELFLOW_BUG_POSITION4

N/A

Not currently used in the simulation.
FUEL_DUMP_SWITCH_SET KEY_FUEL_DUMP_SWITCH_SET

[0]: Bool

Set to 1 (TRUE) or 0 (FALSE). The switch can only be set to TRUE if fuel_dump_rate is specified in the aircraft configuration file, indicating that a fuel dump system exists.

This key is only useful when using the legacy [FUEL] system.

FUEL_DUMP_TOGGLE KEY_FUEL_DUMP_TOGGLE

N/A

Used to turn on (1, TRUE) or off (0, FALSE) the fuel dump switch.

This key is only useful when using the legacy [FUEL] system.

MANUAL_FUEL_PRESSURE_PUMP KEY_MANUAL_FUEL_PRESSURE_PUMP

N/A

Activate the manual fuel pressure pump. Used for both modern [FUEL_SYSTEM] and legacy [FUEL] systems.
MANUAL_FUEL_PRESSURE_PUMP_SET KEY_MANUAL_FUEL_PRESSURE_PUMP_SET

[0]: The pump index

[1]: A value between 0 and 16384

Set the position of the fuel manual pump handle, as a percentage. This key is only useful when using the modern [FUEL_SYSTEM].
MANUAL_FUEL_TRANSFER KEY_MANUAL_FUEL_TRANSFER

[0]: Bool

When set to 1 (TRUE) it sets the fuel transfer mode to manual.
RELEASE_DROP_TANK_ALL KEY_RELEASE_DROP_TANK_ALL

N/A

Release all external tanks that can be jettisoned.
RELEASE_DROP_TANK_1 KEY_RELEASE_DROP_TANK_1

N/A

Release the first external tank that can be jettisoned.
RELEASE_DROP_TANK_2 KEY_RELEASE_DROP_TANK_2

N/A

Release the second external tank that can be jettisoned.
REPAIR_AND_REFUEL KEY_REPAIR_AND_REFUEL

N/A

Fully repair and refuel the user aircraft. Ignored if flight realism is enforced.
REQUEST_FUEL_KEY KEY_REQUEST_FUEL

N/A

Request a fuel truck. The aircraft must be in a parking spot for this to be successful.
ANTIDETONATION_TANK_VALVE_TOGGLE KEY_TOGGLE_ANTIDETONATION_TANK_VALVE

[0]: Tank index (optional)

Toggle the anti-detonation valve. Pass a value to determine which tank to use if there are multiple tanks. See the Fuel Selector Codes list for the correct tank code to use. Note that this key requires the [ANTIDETONATION_SYSTEM.N] system to have been set up in the engine configuration file.
NITROUS_TANK_VALVE_TOGGLE KEY_TOGGLE_NITROUS_TANK_VALVE

[0]: Tank index (optional)

Toggle the nitrous valve. Pass a value to determine which tank to use if there are multiple tanks. See the Fuel Selector Codes list for the correct tank code to use. Note that this key requires the [NITROUS_SYSTEM.N] system to have been set up in the engine configuration file.

 

 

Fuel Selector Codes

FuelSelector Code
FUEL_TANK_SELECTOR_OFF 0
FUEL_TANK_SELECTOR_ALL 1
FUEL_TANK_SELECTOR_LEFT 2
FUEL_TANK_SELECTOR_RIGHT 3
FUEL_TANK_SELECTOR_LEFT_AUX 4
FUEL_TANK_SELECTOR_RIGHT_AUX 5
FUEL_TANK_SELECTOR_CENTER 6
FUEL_TANK_SELECTOR_CENTER2 7
FUEL_TANK_SELECTOR_CENTER3 8
FUEL_TANK_SELECTOR_EXTERNAL1 9
FUEL_TANK_SELECTOR_EXTERNAL2 10
FUEL_TANK_SELECTOR_RIGHT_TIP 11
FUEL_TANK_SELECTOR_LEFT_TIP 12
FUEL_TANK_SELECTOR_CROSSFEED 13
FUEL_TANK_SELECTOR_CROSSFEED_L2R 14
FUEL_TANK_SELECTOR_CROSSFEED_R2L 15
FUEL_TANK_SELECTOR_BOTH 16
FUEL_TANK_SELECTOR_EXTERNAL_ALL 17
FUEL_TANK_SELECTOR_ISOLATE 18