> For the complete documentation index, see [llms.txt](https://sjdawson.gitbook.io/trucksimulatorplugin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sjdawson.gitbook.io/trucksimulatorplugin/features/drivetrain.md).

# Drivetrain

Properties, events and actions relating to drivetrain data

## Properties

### Eco Range

`TruckSimulatorPlugin.Drivetrain.EcoRange`

This property will be `True` when you're in the current "economical range" of RPM of the engine. This is usually represented in-game on the RPM gauge in your truck as a green section.

{% hint style="warning" %}
This property is manually programmed based on the in game visual, so may not be 100% accurate. Please [open an issue on GitHub](https://github.com/sjdawson/TruckSimulatorPlugin/issues/new) if you have a truck where the value isn't correct.
{% endhint %}

### Fuel Range (Stabilised)

`TruckSimulatorPlugin.Drivetrain.FuelRangeStable`

The default property available from the existing telemetry data has an issue where it periodically drops to 0 for a brief moment. This property aims to stabilise that information by displaying the last known good value in the frames where it would usually drop to 0.

### Average Consumption (l/100mi, mpg (UK), mpg (US))

`TruckSimulatorPlugin.Drivetrain.FuelValue.AverageConsumptionLitresPer100Mile`\
`TruckSimulatorPlugin.Drivetrain.FuelValue.AverageConsumptionMilesPerGallonUK`\
`TruckSimulatorPlugin.Drivetrain.FuelValue.AverageConsumptionMilesPerGallonUS`

Display the current average consumption of your truck, in different commonly used units.

### Gear Dashboard

`TruckSimulatorPlugin.Drivetrain.GearDashboard`

Displays the current gear similar to what the on-screen UI of the game shows in the status bar, taking account for crawler gears, multiple reverse gears and automatic transmissions.

{% hint style="warning" %}
This property may not work as intended for ATS, as it's designed around the number of gears most commonly available in ETS2
{% endhint %}
