drs_Devby DrSnyder
Menu
View resources
Fuel-system derivative

ox_fuel

Physical pump interactions on the established OX fuel foundation.

A CommunityOx 1.5.2-based fuel-system derivative with a carried nozzle, optional hose, OX Target workflow, fuel-can economy, and configurable pump audio.

Framework-agnosticOX LibOX InventoryOX TargetFiveM state bagsInteractSound-compatible audio
View on GitHub Read documentation
Version
1.5.2-based
Updated
Aug 15, 2026
License
GPL-3.0
Pixel artworkOpen source · Review before production
ox_fuelv1.5.2-based
previewCapture pending · Pump nozzle workflow

Planned in-game capture of the player carrying the nozzle and optional hose from a supported pump to a nearby vehicle.

previewCapture pending · Target interactions

Planned capture of Take nozzle, Return nozzle, Insert nozzle, and fuel-can options in the default OX Target path.

previewCapture pending · Station and progress UI

Planned capture of the nearest-station blip, pump TextUI, and fueling progress bar. The public repository currently includes no screenshots or video.

01 / OVERVIEW

What it does

DrSnyder's ox_fuel build extends the CommunityOx 1.5.2 fuel resource with a nozzle carried from pump to vehicle, an optional rope hose, distance-aware cleanup, expanded ox_target actions, configurable pump sounds, progress bars, tuned refueling values, nearest-station blips, and custom station coordinates. Vehicle fuel is synchronized through FiveM's native level and an entity state bag, while ox_inventory supplies the default money and petrol-can flow.

02 / FEATURES

Core features

01

Physical pump flow

Take a nozzle from a supported pump, carry it to a nearby vehicle, fuel while it remains within hose range, and return it when finished.

02

Hose-aware cleanup

An optional rope links pump and nozzle, with a graceful nozzle-only fallback plus cleanup on excess distance, death, vehicle entry, or resource stop.

03

Target and direct modes

The default OX Target path covers pump, vehicle, and fuel-can actions; disabling it restores the inherited E-key fueling flow without the physical nozzle.

04

Configurable fuel economy

Tune refill rate, tick cost, fuel-can pricing and durability, vehicle consumption, pump models, blips, stations, sounds, and payment callbacks.

03 / REQUIREMENTS

Compatibility at a glance

Requiredox_lib 3.22.0+ and ox_inventory 2.30.0+
Default interactionox_target while config.ox_target is true
Economyox_inventory money item by default; custom economies must override both payment exports
Optional audioInteractSound-compatible provider plus manual OGG installation
Production reviewHarden the inherited client-trusting server events before public use
Resource nameKeep ox_fuel
04 / INSTALLATION

Setup path

  1. 01

    Place the repository in the FiveM resources folder as ox_fuel.

  2. 02

    Install and configure ox_lib 3.22.0+, ox_inventory 2.30.0+, and ox_target for the default nozzle workflow.

  3. 03

    Review refill, pricing, blip, station, nozzle, hose, fuel-can, and consumption settings in config.lua and data/stations.lua.

  4. 04

    For pump audio, copy the four bundled OGG files into the selected InteractSound-compatible provider and start it before testing.

  5. 05

    Start the dependency stack before ox_fuel, then test pump fueling, fuel cans, cancellation, range cleanup, insufficient funds, and full tanks.

05 / CHANGELOG

Current release

v1.5.2-basedRepository snapshot · Aug 2026
  • Added the carried physical nozzle, optional rope hose, distance cleanup, and four configurable pump sound cues.
  • Enabled and expanded OX Target interactions, switched fueling to progress bars, tuned refill and pricing values, and added custom stations.
Keep browsing

More resources

Full catalog