VehiclesBased on another project

ox_fuel Expanded

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

Adds original RON pumps, Sentinel EV stations and portable power, dual-handle shared fueling, physical checkout screens, and server-checked payments to CommunityOx ox_fuel.

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.3
Updated: Nov 2, 2026
License: GPL-3.0 + model/audio terms
Code access: Open-source code
Status: Early build — test carefully

Sections9 sections

Resource previewSentinel cabinet charging

1 of 11

screenshotSentinel cabinet charging

The original dual-screen Sentinel station shows a live EV session on its physical cabinet display.

01 / OVERVIEW

What it does

Hardware: Original RON pump, Sentinel charging hardware, and universal nozzle
Shared stations: Two handles; one on the vintage pump
Coverage: Gasoline, EV charging, fuel cans, and portable power

An independent expansion of CommunityOx ox_fuel v1.5.2, now with original DRS hardware: an illuminated RON style-A pump, dual-screen Sentinel EV cabinet, matching connectors and portable pack, and a universal fuel nozzle across gas-pump brands.

Players carry and attach the nozzle or connector, select fuel or charging options, and pay with Cash or Bank. RON and Sentinel use physical cabinet screens by default. Two players can use separate handles on the same station, with shared flow while both are actively transferring; the vintage gas pump keeps one handle.

The remaining replacement pump models are in development and planned for release in future updates.

02 / HOW IT WORKS

How fueling and charging work

01
Take an available handle
Use a gas pump, Sentinel station, fuel can, or portable pack. Most fixed stations have two separately synchronized handles; vintage pumps have one.
02
Choose the product and payment
Choose Regular or Premium, or Standard or Rapid charging, with Cash or Bank. On RON and Sentinel cabinets, use the arrow keys, Enter, and Backspace on the physical screen.
03
Connect and transfer
Carry the nozzle or connector to the vehicle. The cabinet display or relevant HUD reports progress. Both sessions slow to the configured shared rate when two handles are actively transferring.
04
Settle and return the equipment
The server charges for delivered fuel or energy, updates vehicle state, releases the handle, and cleans up the hose, cable, and managed sound.

03 / FEATURES

Core features

Original RON fuel hardware

An illuminated style-A cabinet with docked hoses, a universal nozzle, and physical front/rear checkout registers replaces supported map RON pumps reversibly.

Sentinel charging and portable power

Original dual-screen cabinets, connectors, parked cables, and matching portable packs cover fixed and roadside EV charging.

Shared pumps and chargers

Two independently leased handles let two players use a station. Shared flow applies only while both are transferring; the vintage pump retains one handle.

Transactions checked by the server

The server validates grades, available balances, capacity, reach, transfer speed, delivered amounts, and final payment while retaining the normal vehicle fuel state.

Settings for your fleet and map

Tune capacities, consumption, mount profiles, custom pumps, payments, cabinet screens, sounds, and optional Chaos Mode without replacing existing fuel integrations.

What changed in this edition

Original RON and Sentinel hardware

Replaces the old charging props with original DRS Sentinel models and adds the illuminated RON style-A cabinet, docked hoses and connectors, portable hardware, and a universal fuel nozzle.

Physical cabinet checkout

RON front/rear registers and Sentinel cabinet screens handle checkout and live totals. Arrow keys choose options, Enter confirms, and Backspace cancels. Other gas pumps and portable power keep their HUDs.

Two synchronized handles

Most pumps and chargers support two independently leased handles. Both active transfers use the configured shared-flow multiplier; an idle held handle does not slow the other session. Vintage pumps remain single-handle.

Resource-local sound bank

The compact 13-file bank combines recorded handling cues, original loops, and device tones through San Andreas Sound. Clips are served directly from ox_fuel without a separate sound-file copy.

Maintained update source

The configurable startup version checker now follows the maintained Expanded GitHub package. Pricing, grades, payment adapters, vehicle profiles, and delivered-only settlement remain available.

More features7 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
Rechargeable 12 kWh portable packs with independent inventory metadata
Reversible RON map-pump replacement and synchronized damage at validated locations

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
Dual handles, vintage-pump exclusions, shared-flow rate, and handle leases
RON replacement, physical registers, approach-side selection, and map damage locations
Sentinel cabinet screens, optional HUD fallback, docked connectors, and station lighting
Original nozzles, hoses, vehicle attachment, backup positions, and positional audio
EV modes, batteries, locations, cables, blips, and damage effects
Portable-unit capacity, pricing, placement, recharge, and warnings
Tank sizes, fuel use, custom pumps, and disabled-by-default 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; the 13-file sound bank is served directly from ox_fuel
Companion: Matching ox_fuel_assets 1.2.6, started before ox_fuel
Resource names: Keep ox_fuel and ox_fuel_assets; migrate hardware with a full server/client restart
Also works with: FiveM state bags

See all requirements and setup options

Technical details3 details

Runtime: FiveM Lua with HTML/CSS/JavaScript NUI and physical cabinet displays
Vehicle state: Replicated fuel percentage and premium blend ratio
Package: ox_fuel 1.5.2-expanded.3 + ox_fuel_assets 1.2.6

06 / LIMITATIONS

Known limitations

This is a community preview distributed from main, without a packaged GitHub release. Pin and test the exact code revision before live use.
The complete gasoline, EV, and portable workflows require ox_target, even though the main manifest does not declare it.
This hardware migration requires a full server/client restart with matching ox_fuel_assets 1.2.6. Never hot-restart or unmount the asset companion with players connected.
RON replacement targets map prop_gas_pump_1a pumps. Other brands and script-owned custom pumps are untouched; unlisted MLO pump coordinates need ronPump.damageLocations for synchronized destruction.

More limitations2 more items

The Diesel button on the RON model is cosmetic. The configured gasoline grades remain Regular and Premium.
Add-on vehicles may need a custom mount profile. Test every enabled Chaos Mode outcome for the server.

07 / ORIGINAL PROJECT

Changes from the original

Original projectCommunityOx ox_fuel

Base version1.5.2

The Expanded edition keeps the ox_fuel name and normal 0–100 vehicle fuel state while adding original physical hardware, shared stations, cabinet checkout, EV charging, and portable power.

Differences between CommunityOx ox_fuel and this drs_Dev edition
Area	Original	drs_Dev edition
Hardware	Standard station and fuel-can behavior	Original RON cabinet, Sentinel station and pack, docked equipment, and universal nozzle
Shared stations	Standard pump interaction	Two leased handles, active shared-flow reduction, and single-handle vintage pumps
Energy coverage	Gasoline fueling	Gasoline, fixed EV charging, fuel cans, and portable EV power
Checkout	Fuel purchase through inventory	Physical RON/Sentinel registers, branded HUDs elsewhere, grades, and Cash or Bank payment
Vehicle data	0–100 fuel state	Retained state plus capacities, batteries, blending, and 669 adapted mount profiles

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.3Original hardware and shared stations

Added original DRS Sentinel station and portable hardware, illuminated RON replacement pumps, docked equipment, and the universal drs_fuel_nozzle with ox_fuel_assets 1.2.6.
Added dual-handle occupancy, active shared-flow reduction, cabinet checkout, approach-side RON register selection, and synchronized pickup and damage behavior.
Replaced legacy models and interaction sounds with the original hardware and compact resource-local 13-file audio bank; fixed the invalid entity-only physics call on rope handles.

View change history

Credits and license

Project type: Based on another project
Maintainer: DrSnyder
License: GPL-3.0 + model/audio terms
Code access: Open-source code
Original project: CommunityOx ox_fuel LC Fuel data CDN-Fuel (historical credits)

Independent community expansion of CommunityOx ox_fuel v1.5.2. Software remains GPL-3.0. Original DRS RON, Sentinel, and universal-nozzle contributions use the separate DRS Model Asset License 1.0: unchanged FiveM use and free package redistribution are permitted; asset sales, paid bundles, and model/texture edits require prior written permission from DrSnyder. Valid GPL rights granted for earlier asset copies remain intact. Recorded foley retains its CC BY 4.0 or CC0 terms; preserve both resources' license and third-party notices. Third-party artwork and trademarks retain their holders' rights. Former CDN-Fuel models and sound files have been removed, with historical credits retained. Vehicle offsets and station data remain adapted from LC Fuel. This is not an official CommunityOx release.

View source code on GitHub