Experimental Fuel Persistence Mod

This mod was tested across all vanilla cars, though not all configs. If you encounter any issues with vanilla vehicles, DM or post them here, and include the config you were using, if it isn't already included in the game. Issues caused by mods will not be fixed, that is up to you to add functionality for, which really isn't hard to do.

Spoiler: Adding functionality for mods (advanced)

First, unpack the mod in the mod manager. You can do that by double clicking the mod and clicking unpack.



Then, click "Open in Explorer", this will bring you to the mod directory. Keep this folder open for now.

Go into the game and spawn the car you wish to add support for. Let's say you want to add support for the Gavril Vertex. Open the console using the tilda key (~) or (`) under the escape key. Look closely at the output for the name of your vehicle:

"/vehicles/gavril_vertex/"

Make the folder in /vehicles/ as so:


Now, copy the lua folder from the atv folder into the folder you just made.

Enter the lua folder in the new folder you just made for the car, and open fuelManager.lua.

Copy and paste this outside of a function:

local function printTable(tbl, indent)
indent = indent or 0
local indentString = string.rep(" ", indent)

for key, value in pairs(tbl) do
if type(value) == "table" then
print(indentString .. tostring(key) .. ": {")
printTable(value, indent + 1)
print(indentString .. "}")
else
print(indentString .. tostring(key) .. ": " .. tostring(value))
end
end
end

And then paste this inside of the onInit() function:

printTable(energyStorage.getStorages())

This will provide us with the names of the fuel tanks on the car.

Save, go into the game, and press CTRL + R to reload the Lua environment. Scroll up to the printed information:

As we can see, the main fuel tank is called mainTank, and remainingVolume is the field that indicates how much fuel is left.

With this, we can see it's already implemented into the table of storages here, meaning we don't need to do anything. However, this may not be the case for all vehicles, and some vehicles can have multiple fuel tanks, so it's still important to check. You should also check this for battery configurations.

If you did everything correctly, it should begin working. You can repack by going back to the first step and clicking "Pack", if you feel its necessary.

This mod allows you to break your car without resetting burnt fuel. Only CTRL + R or vehicle configuration will reset your fuel level. If you think I should add more, like maybe even saving fuel across game sessions (if that's even possible), up to even mileage, feel free to pitch in ideas. I have no clue why nobody has made anything like this before as far as I know.

Updates:
(v1.1): Added support for the Bruckell Nine in v0.34

 

this is cool i hope you develop more on it

 

will this be getting updated for 0.34? it, at least for me, doesn't work after the update
--- Post updated ---

nvm

 

The latest vehicle likely needs added. I'll look into it now.

 

Yes please add a persistent odometer I am begging you cus this is a feature that I have been trying to implement all the way back in 0.23 and never got it to fn work !

 

Does/would this work with modded/automation vehicles? Or does it need to be physically coded fully for each car by you?

Also, would this work in multiplayer if set up by the host? I would guess the answer would be no as it probably wouldnt be able to keep track of everyone's fuel properly.
But in theory at least if everyone is in different cars it may work.

Thanks

Edit: I have tested both of these things and they work flawlessly. Even having multiple people in the same type of car works and it only resets each persons car. Overall very happy, this makes endurance races possible and i can finally force pits without going off of tire wear which is inconsistent.

 

Please add support for modded vehicles.

 

Try reading.

 

Yes it does but you need to configure that. Here is the code that worked for me "
local M = {}

local storages = {{name = 'mainTank', field = 'remainingVolume', lastVolume = -1}, {name = 'mainBattery', field = 'storedEnergy', lastVolume = -1}} -- All possible storages. Any storages present on the vehicle will be managed by the script.
-- name is the name of the storage.
-- field is what determines the "fuel level" of the storage.
-- lastVolume is to be ignored, but still included predefined as -1.
local presentStorages = {}
local scheduleFuelSet = false
local loaded = false

local function onInit()
loaded = false

-- Attempt to find valid storages based on the defined list
for _, storage in ipairs(storages) do
local storageRef = energyStorage.getStorage(storage.name)
if storageRef then
presentStorages[storage.name] = storageRef
end
end
end

local function onReset()
if not loaded then return end

-- Store the remaining volumes or energy from all present storages
for _, storage in ipairs(storages) do
local storageRef = presentStorages[storage.name]
if storageRef then
storage.lastVolume = storageRef[storage.field] -- Set the lastVolume using the correct field
end
end
scheduleFuelSet = true
end

local function onUpdate()
if scheduleFuelSet then
-- Print fuel info for debugging
for _, storage in ipairs(storages) do
local storageRef = presentStorages[storage.name]
if storageRef then
storageRef["set" .. storage.field:sub(1, 1):upper() .. storage.field:sub(2)](storageRef, storage.lastVolume)
end
end
scheduleFuelSet = false
end

loaded = true
end

M.onInit = onInit
M.onReset = onReset
M.updateGFX = onUpdate

return M"

 

How to add support for all mod vehicles automatically?

 

Author hasent been online in 6 months, mod ahsent been updated since jan 2025 and theres intructiosn how to add it if you bothered to read

 

:

 

To anyone struggling here is the code that worked for me. I made the vehicle folder and i used this code.
"
local M = {}

local storages = {{name = 'mainTank', field = 'remainingVolume', lastVolume = -1}, {name = 'mainBattery', field = 'storedEnergy', lastVolume = -1}} -- All possible storages. Any storages present on the vehicle will be managed by the script.
-- name is the name of the storage.
-- field is what determines the "fuel level" of the storage.
-- lastVolume is to be ignored, but still included predefined as -1.
local presentStorages = {}
local scheduleFuelSet = false
local loaded = false

local function onInit()
loaded = false

-- Attempt to find valid storages based on the defined list
for _, storage in ipairs(storages) do
local storageRef = energyStorage.getStorage(storage.name)
if storageRef then
presentStorages[storage.name] = storageRef
end
end
end

local function onReset()
if not loaded then return end

-- Store the remaining volumes or energy from all present storages
for _, storage in ipairs(storages) do
local storageRef = presentStorages[storage.name]
if storageRef then
storage.lastVolume = storageRef[storage.field] -- Set the lastVolume using the correct field
end
end
scheduleFuelSet = true
end

local function onUpdate()
if scheduleFuelSet then
-- Print fuel info for debugging
for _, storage in ipairs(storages) do
local storageRef = presentStorages[storage.name]
if storageRef then
storageRef["set" .. storage.field:sub(1, 1):upper() .. storage.field:sub(2)](storageRef, storage.lastVolume)
end
end
scheduleFuelSet = false
end

loaded = true
end

M.onInit = onInit
M.onReset = onReset
M.updateGFX = onUpdate

return M"