Energy Storage

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

Required arguments

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

Fuel Tank

string
type
The name of the beam which will cause the tank to leak when broken.
A leaking fuel tank will lose fuel rapidly.
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.
number
type
energyType.energyDensity or 0
default
Overide 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.
number
type
energyType.fuelLiquidDensity or 0
default
Overide 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.
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"]},
number
type
0
default
Volume capacity of the fuel tank (L)
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.

string
type
The name of the beam which will cause the tank to leak when broken.
number
type
41000000 / 5
default
Overide 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.
number
type
0
default
Volume capacity of the fuel tank (L)
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.

number
type
0
default
Battery capacity at full charge (kWh)
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: May 6, 2024

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.