Getting Started
Official Content
Tutorials
Modding
World Editor
Support
BeamNG.tech

Energy Storage

This feature is supported as of BeamNG.tech and .drive version 0.8.0 to latest.

Energy storage is used to identify a tank of fuel, a set of batteries, or a tank of nitrous.

 Required arguments

type
name
string
type
The type of energy stored
The available options are “fuelTank”, “n2oTank”" and “electricBattery”. Each of those has unique parameters shown below.
name
name
string
type
The name of the energy storage
In case of a vehicle with multiple fuel tanks, each name must be unique.

 Fuel Tank

breakTriggerBeam
name
string
type
The name of the beam which will cause the tank to leak when broken.
A leaking fuel tank will lose fuel rapidly.
energyType
name
string
type
Presets for energy density and weight density.
The values with predefined energy density and weight density are “gasoline”, “diesel” and “kerosene”. When using any other value, you need to add the energyDensity and fuelLiquidDensity properties.
energyDensity
name
number
type
energyType.energyDensity or 0
default
Override for the energy density of the fuel (J/kg)
Used mostly when using a type of fuel which isn’t listed. Shouldn’t be used otherwise.
fuelLiquidDensity
name
number
type
energyType.fuelLiquidDensity or 0
default
Override for the weight density of the fuel (kg/L)
Used mostly when using a type of fuel which isn’t listed. Shouldn’t be used otherwise.
fuel
name
string
type
Identifies the set of nodes that represent this fuel tank.

Used for fuel weight simulations.

All of the nodes in this group will gain equal amounts extra weight, totalling to the weight of the fuel in the tank.

"fuel": {"[engineGroup]:":["fuel"]},
fuelCapacity
name
number
type
0
default
Volume capacity of the fuel tank (L)
startingFuelCapacity
name
number
type
fuelCapacity
default
Initial volume of fuel in the tank (L)
This is usually tied to a variable .

 N2O Tank

The N2O tank is used along with the nitrous power adder.

breakTriggerBeam
name
string
type
The name of the beam which will cause the tank to leak when broken.
energyDensity
name
number
type
41000000 / 5
default
Override for the energy density of the fuel (J/kg)
Default value takes into account a 1:5 N2O to fuel ratio. Shouldn’t be changed for most gasoline cars.
capacity
name
number
type
0
default
Volume capacity of the fuel tank (L)
startingCapacity
name
number
type
capacity
default
Initial volume of nitrous in the tank (L)

 Electric Battery

Electric battery refers to the main power battery of electric cars.

batteryCapacity
name
number
type
0
default
Battery capacity at full charge (kWh)
startingCapacity
name
number
type
capacity
default
Initial charge of the battery

 Examples

Typical fuel tank. Note the variable used for the starting fuel capacity

"energyStorage": [
        ["type", "name"],
        ["fuelTank", "mainTank"],
],
"mainTank": {
        "energyType":"gasoline",
        "fuelCapacity": 45,
        "startingFuelCapacity": "$fuel",
        "fuel": {"[engineGroup]:":["fuel"]},
        "breakTriggerBeam": "fuelTank",
},

10 pound nitrous bottle

"energyStorage": [
        ["type", "name"],
        ["n2oTank", "mainBottle"],
],
"mainBottle": {
        "capacity": 4.54,
        "startingCapacity": 4.54,
},

50 kWh battery

"energyStorage": [
        ["type", "name"],
        ["electricBattery", "mainBattery"],
],
"mainBattery": {
        "energyType":"electricEnergy",
        "batteryCapacity": 50,
        "startingCapacity": "$fuel",
},
Last modified: January 24, 2025

On this page:

Any further questions?

Join our discord
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.