Troubleshooting

Fuel not saving after restart

Cause: Fuel data is stored in vehicle entity data, which may not persist across server restarts without a vehicle persistence script.

Solution:

• Use a vehicle persistence/garage script that saves vehicle data
• Ensure the persistence script saves and restores vehicle fuel levels
• Check that GetFuelLevel and SetFuel exports are being called by your garage script

Electric vehicles showing gas stations

Cause: Vehicle model not added to the electricModels table.

Solution:

1. Open config.lua
2. Find the electricModels table
3. Add your vehicle model in UPPERCASE:

["YOURVEHICLE"] = true,

Supercharger stations not appearing

Cause: Supercharger prop not loaded or script load order issue.

Solution:

• Ensure supercharger prop resource starts before bit-fuel
• Verify prop resource is properly installed
• Check server console for prop loading errors

Petrol can not working

Cause: Inventory system not properly configured or item not added.

Solution:

1. Verify inventory configuration (Config.useOXinventory, Config.useQSinventory, or Config.customInventory)
2. Check that WEAPON_PETROLCAN item exists in your inventory items database
3. Verify customInventoryAddItem and customInventoryRemoveItem functions match your inventory system

Fuel consumption too fast/slow

Cause: Incorrect RPM consumption rates or vehicle class multipliers.

Solution:

• Adjust Fuel.FuelUsage values in config.lua (lower = slower consumption)
• Modify Fuel.Classes multipliers for specific vehicle types
• Test with different values to find balanced consumption

Players not paying for fuel

Cause: Bank account configuration mismatch.

Solution:

• Verify Config.bankaccount matches your framework's bank account name
• For ESX: Usually "bank"
• For QBCore: Usually "bank"
• Check framework's account system documentation

Notifications not showing

Cause: Custom notification function not configured.

Solution:

1. Open config.lua
2. Find the notifications function
3. Replace with your notification system:

function notifications(notitype, message, time)
    -- Example for okokNotify:
    TriggerEvent('okokNotify:Alert', '', message, time, notitype)
    
    -- Example for ESX default:
    -- ESX.ShowNotification(message)
    
    -- Example for QBCore:
    -- QBCore.Functions.Notify(message, notitype)
end

Gas station blips not showing

Cause: Blip configuration issue or stations.lua not properly configured.

Solution:

• Verify Blips.blip, Blips.blipColor, and Blips.blipScale are set correctly
• Check stations.lua for gas station coordinates
• Ensure resource has started properly (check F8 console)

Script not starting

Cause: Missing dependencies or incorrect server.cfg configuration.

Solution:

1. Verify resource folder name is exactly bit-fuel
2. Check server.cfg has ensure bit-fuel below framework and inventory
3. Verify no encrypted file modifications
4. Check server console for error messages
5. Ensure framework (ESX/QBCore) is running before bit-fuel

Fuel prices not applying correctly

Cause: Incorrect fuel price tick configuration.

Solution:

• Review Config.fuelPriceTickElectric, Config.fuelPriceTickGas95, Config.fuelPriceTickGas98
• Verify Config.fuelingTimeTick is set correctly (default: 10000ms = 10 seconds)
• Test fuel purchase to verify pricing calculation

[!TIP] If you're experiencing issues not listed here, check the F8 console for error messages and verify all configuration values match your server setup.