Fuel Module
Simulates fuel consumption based on engine power output and efficiency. Consumption is computed from the engine's current power generation, maximum power and thermal efficiency.
Key Features
- Physically-based consumption calculation using engine power and efficiency
- Automatic engine shutdown when fuel depleted
- Real-time consumption metrics (L/100km, MPG, km/L)
- Idle consumption simulation
- Configurable consumption multiplier for gameplay balancing
Configuration
Basic Settings
| Property | Description |
|---|---|
Amount |
Current fuel in tank (liters). Automatically clamped between 0 and capacity |
Capacity |
Maximum tank capacity (liters). Motorcycles: 10-25 L, Compact cars: 35-50 L, Mid-size cars: 50-70 L, SUVs/Trucks: 70-120 L |
Consumption Parameters
| Property | Description |
|---|---|
Efficiency |
Thermal efficiency (0-1 range). Percentage of fuel energy converted to mechanical work. Gasoline engines: 0.25-0.35, Diesel engines: 0.35-0.45, Racing engines: 0.35-0.40 |
Idle Consumption |
Fuel consumption at idle as fraction of maximum (0-1 range). Economy cars: 0.05-0.08, Standard cars: 0.08-0.12, Performance cars: 0.12-0.20 |
Consumption Multiplier |
Multiplier for fuel consumption rate. Use for gameplay balancing without changing the physical model. 0.5 = Half consumption (double range), 1.0 = Realistic consumption, 2.0 = Double consumption (half range) |
Events
| Event | Description |
|---|---|
OnOutOfFuel |
Unity event triggered when tank becomes empty. Engine automatically stops when triggered |
Public Properties
Consumption Metrics (Read-Only)
| Property | Description |
|---|---|
ConsumptionLitersPer100Kilometers |
Current consumption in L/100km (European metric) |
ConsumptionMPG |
Current consumption in miles per gallon (US metric) |
ConsumptionKilometersPerLiter |
Current consumption in km/L |
ConsumptionLitersPerSecond |
Instantaneous fuel flow rate |
FuelPercentage |
Fuel level as percentage (0-1) |
HasFuel |
True if fuel available or module disabled |
Fuel Consumption Model
The model assumes gasoline with approximately 36 MJ/L energy content (10 kWh/L). Consumption is calculated from:
maxConsumptionPerHour = (engineMaxPower / 10) * (1 - efficiency)
consumptionPerHour = (generatedPower / maxPower) * maxConsumptionPerHour
Consumption is clamped to minimum idle consumption rate and adjusted by the consumption multiplier.