Documentation
Fix common Fuel Stations problems: no stations, creator permission, pumps that do nothing, invisible EV chargers, wrong fuel grade, empty stations, fuel resets and delivery job issues.
What goes wrong most often, what it actually means, and what to do about it. For anything not listed here, set Config.Debug = true, restart the resource and read the server and F8 consoles — every load, sync and refusal is logged.
The resource folder was renamed. It must be called exactly qs-fuelstations — rename it back and update the ensure line.
The SQL was not imported, or was imported into a different database from the one in your mysql_connection_string. Import sql/database.sql into the right one and restart. A "No stations in `fuel_stations`" warning means the table exists but is empty — import the seed, or place stations with /fuelcreator.
The player has none of the permissions in Config.Creator.aces and is not a framework admin. Add add_ace identifier.license:… fuelstations.creator allow to server.cfg and restart the server so the line is read. On vRPex, ACE is the only route.
The interface ships ready to use in web/build. If that folder is missing or incomplete — often after an FTP upload that skipped files — download the resource again from the CFX Portal and replace the folder. Open F8 and look for an error that names a missing file.
Correct behaviour. Config.FuelPrices, Config.Economy, Config.ElectricModels and Config.VehicleFuelTypes only seed an empty fuel_settings table. Change them in /fuelcreator → Economy instead.
The chosen translation lacks a line that English has. The script uses the English line meanwhile, so nothing breaks. Add the key to your locale file to silence it.
A pump only works when it belongs to a station. Check, in order:
The pump is inside a station's radius. Open the creator, select the nearest station and raise its radius, or create a station there.
That station sells the right kind: a fuel pump needs a station selling petrol or diesel, a charger one selling electric.
The prop's model is in Config.PumpModels. Custom map pumps must be added there.
With Config.UseTarget = true there is no [E] prompt — use the target eye.
The charger models are not streamed. Add ensure fuelstations-props to server.cfg before qs-fuelstations, and make sure the folder was uploaded with its stream/ files.
The vehicle is registered for another grade. Every model not listed runs on petrol, so an addon EV or diesel truck must be added in /fuelcreator → Economy → Vehicles by its spawn name, with the right grade.
Its stock reached 0%. A delivery driver refills it, or an admin can set Fuel in stock back to 100 in the creator. If stations empty too fast, raise Config.DivideStationLevel; to turn stock off entirely, set Config.EveryStationHasFuelLevel = false.
That model has no petroltank bone, so the filler cap was guessed from the rear wheels. Add the model to Config.CustomOffsets with a left and a right point, relative to the vehicle's centre:
Config.CustomOffsets = {
['mycar'] = { vec3(-0.9, -1.6, 0.4), vec3(0.9, -1.6, 0.4) },
}The player walked further than Config.CableMaxLength (7 m) from the pump. Park closer, or raise the value. With Config.AddExplosion = true, tearing the hose also causes an explosion at the pump.
The account they chose could not cover the bill, so what was in it was taken. Leave only bank enabled in Config.FuelPaymentMethods if you want card-only stations.
Open Economy → Consumption Model and start from a preset: Casual, Balanced or Hardcore. The readouts show how long a tank lasts parked, cruising and flat out. For a single class or model, use Vehicle Classes or Vehicles instead. Switching the model off hands drain back to GTA.
Another script is also setting the tank — usually a second fuel script or a garage that restores an old value. Remove other fuel resources, and make garages save and restore fuel through GetFuel / SetFuel (see Integrations).
Config.PriceMode is 'static', or the grade's volatility in Config.Market.types is 0. The market moves every tickMinutes (30) by small steps; run fuelmarket tick in the console to see it move now.
Config.EnableJob is false. If it is true, check the console for "Job ped … could not be loaded" — Config.PedType must be a valid ped model.
Config.JobRespectStock is true and every station is at 100%. Wait for players to buy fuel, or set it to false to always offer work.
The console says "Job vehicle … is not a vehicle model on this server": Config.TruckToSpawn or Config.TrailerToSpawn names a model that is not streamed. Also make sure the spawn points are clear of other vehicles.
Your key system was not detected, so no keys were given. Make sure it starts before qs-fuelstations, or set Config.Vehiclekeys by hand.
The server only accepts a delivery made within 75 m of the station's delivery point, and not twice in quick succession. If a station's delivery point is far from where the marker appears, set it again in the creator under Placement → Delivery point.
Correct behaviour. The deposit is the price of the contract; the salary is paid per station delivered. Lower Config.TruckPrice and Config.TankPrice if it feels too steep.
Still stuck? Open a ticket and include your framework, your
server.cfgload order, and the server and F8 console output withConfig.Debug = true.