VehiclesBased on another project

ox_fuel Expanded

One fuel resource. Several community projects. Far too many correctly attached hoses.

Expands CommunityOx's fuel script with hoses players can pick up and connect, two fuel grades, EV charging, portable roadside power, shared pumps, and new pump screens.

No framework requiredQboxQBCoreESXAlso works with 6 other systems

Download latest code This is the latest code from GitHub, not a packaged release. Test it before using it on a live server.

Setup guide

Source code Report a problem

Version: 1.5.2-expanded.2
Updated: Aug 30, 2026
License: GPL-3.0
Code access: Open-source code
Status: Early build — test carefully

Sections9 sections

Resource previewLTD live fuel register

1 of 18

screenshotLTD live fuel register

The branded register tracks sale, volume, tank level, grade, and payment while the hose remains attached.

01 / OVERVIEW

What it does

Type: Physical fuel and EV energy system
Coverage: Gasoline, EV charging, fuel cans, and portable power
Base: Independent expansion of CommunityOx ox_fuel v1.5.2

This is a free, independent expansion of CommunityOx ox_fuel v1.5.2 by drs_Dev. Players pick up a nozzle or charging cable, connect it to a vehicle, choose a fuel grade or charging speed, and pay with cash or bank. Pumps stay in sync so two players cannot use the same one at once, and the normal 0–100 vehicle fuel value still works.

The server calculates how fast fuel moves, how much the tank can hold, the price, and the final payment. Server owners can adjust tank sizes, payment systems, pump locations, and hose attachment points, with 669 vehicle profiles included as a starting point.

02 / HOW IT WORKS

How fueling and charging work

01
Choose where the energy comes from
Use a gas pump, EV station, fuel can, or portable charger. A fixed pump can only be used by one player at a time.
02
Choose the product and payment
Pick Regular or Premium fuel, Standard or Rapid charging, and an available Cash or Bank payment method.
03
Connect and fill
Carry the nozzle or connector to the vehicle. The live screen shows the amount delivered, tank level, speed, and running cost.
04
Pay for what was delivered
The server charges only for the fuel or energy received, updates the vehicle, frees the pump, and cleans up the hose, cable, and sound.

03 / FEATURES

Core features

Nozzles and cables you can carry

Fuel nozzles and EV connectors have visible hoses or cables, attach to the vehicle, play sound from their location, and return or clean up when the session ends.

Fuel grades and a live pump screen

Regular and Premium pricing, blending, realistic capacities, Cash/Bank selection, and branded live registers turn each transfer into a readable in-world transaction.

EV charging and portable power

Standard and Rapid stations share the same checkout model, while the unique portable item can be purchased, deployed, connected, damaged, recharged, and recovered.

Transactions checked by the server

The server checks pump use, player and vehicle distance, transfer speed, maximum amounts, and final payment so everyone sees the same session.

Settings for your fleet and map

Adjust tank and battery sizes, fuel use, pump locations, hose reach, EV stations, nozzle positions, payment methods, damage behavior, and optional chaos outcomes.

What changed in this edition

Physical equipment shared by everyone

Adds fuel nozzles, EV connectors, hoses, cables, vehicle attachment, sound from the pump location, and cleanup after restarts.

Fuel sold by volume

Adds Regular and Premium grades, fuel blending, live gallon prices, different tank sizes, and adjustable fuel use.

Full EV charging

Adds Standard and Rapid chargers, different vehicle batteries, damageable stations, and a portable 12 kWh emergency charger players can buy.

Live pump screens

Adds modern and vintage RON, LTD, XERO, Globe Oil, and Sentinel EV screens showing the product, payment, cost, amount delivered, and tank level.

Server-checked payments and optional chaos

The server checks each transaction. Chaos Mode is off by default and includes cooldowns and protections so players pay only for what they receive.

More features6 more items

669 adapted vehicle hose positions plus automatic fuel-cap detection
Live nozzle and EV connector offset editors
Bank-payment support for Qbox, QBCore, ESX, and custom systems
Spawned aircraft, marine, and remote pumps with per-location hose reach
Fuel-can purchase, refill, grade metadata, and server settlement
Seven positional fueling and charging sounds through San Andreas Sound

04 / SETUP OPTIONS

What you can change

These are the main parts you can adjust for your server. The setup guide lists every option and example.

Fuel grades, prices, flow rates, and checkout precision
Cash, bank, and custom payment methods
How long a player can hold a pump and how the server checks each session
Branded meter variants, currency, and units
Nozzles, hoses, vehicle attachment, backup positions, and sound
EV stations, modes, batteries, cables, blips, and damage effects
Portable-unit capacity, pricing, placement, recharge, and warnings
Tank sizes and fuel use by vehicle class or model
Custom pumps, locations, hose lengths, and optional Chaos Mode

See every setup option

05 / REQUIREMENTS

What it works with

Server framework: No framework requiredQboxQBCoreESX
Required: ox_lib 3.22.0+ and ox_inventory 2.30.0+
Interaction: ox_target for the complete gasoline, EV, and portable workflow
Audio: San Andreas Sound with seven bundled OGG files installed
Companion: Included ox_fuel_assets 1.0.0, started before ox_fuel
Resource names: Keep ox_fuel and ox_fuel_assets
Also works with: FiveM state bags

See all requirements and setup options

Technical details3 details

Runtime: FiveM Lua with an HTML/CSS/JavaScript NUI
Vehicle state: Replicated fuel percentage and premium blend ratio
Package: ox_fuel plus the required ox_fuel_assets companion resource

06 / LIMITATIONS

Known limitations

There is no packaged GitHub release yet. Test prices, payments, and your full vehicle list before using the latest code on a live server.
The complete fueling and charging experience requires ox_target, even though the main fxmanifest does not list it as a dependency.
Keep ox_fuel_assets running while restarting ox_fuel. Stopping its custom vehicle parts while players are connected can crash their game.
Add-on vehicles and unusual map-added pumps may need a custom hose position or pump location.

More limitations1 more item

Chaos Mode is intentionally disabled by default and every enabled outcome needs server-specific testing.

07 / ORIGINAL PROJECT

Changes from the original

Original projectCommunityOx ox_fuel

Base version1.5.2

The drs_Dev edition keeps the ox_fuel name and its normal 0–100 fuel value while adding physical hoses, new checkout screens, and EV charging.

Differences between CommunityOx ox_fuel and this drs_Dev edition
Area	Original	drs_Dev edition
Fueling	Standard station and fuel-can behavior	Physical nozzle and hose, vehicle attachment, one-player pump use, new checkout screens, and sound from the pump
Energy coverage	Gasoline fueling	Gasoline plus fixed and portable EV charging
Payment	Fuel purchase through inventory	Server-calculated volume, grades, blending, Cash or Bank choice, and framework payment support
Vehicle data	0–100 fuel state	Retained state plus class/model capacities, EV batteries, and 669 attachment profiles
Server tools	Standard resource startup and shutdown	Required EV asset companion, shared charger damage, hose-position tools, and optional Chaos Mode

08 / INSTALLATION

Ready to install?

Open the setup guide

The guide covers requirements, installation, server setup, connections to other resources, and troubleshooting.

Read the installation guide

09 / VERSION & SOURCE CODE

Version and source code

Latest version

v1.5.2-expanded.2Community preview · Aug 2026

Added the 12 kWh portable EV unit, required ox_fuel_assets companion, vehicle attachment, expanded interfaces, position tools, and EV details for newer vehicle builds.
Added the disabled-by-default Chaos Mode with server-side rolls, cooldowns, session guards, and delivered-only settlement.

View change history

Credits and license

Project type: Based on another project
Maintainer: DrSnyder
License: GPL-3.0
Code access: Open-source code
Original project: CommunityOx ox_fuel CDN-Fuel LC Fuel

Independent GPL-3.0 community expansion of CommunityOx ox_fuel v1.5.2. Selected electric assets and sounds come from CDN-Fuel; adapted vehicle offsets and station data come from LC Fuel. This is not an official CommunityOx release.

View source code on GitHub