Physical pump interactions on the established OX fuel foundation.
This CommunityOx 1.5.2-based derivative keeps ox_fuel's native and state-bag fuel synchronization plus its ox_inventory economy while adding a default OX Target nozzle workflow. Configure the complete inventory and target stack first, and audit the inherited client-trusting server events before exposing it on a public server.
Place the repository in the FiveM resources folder as ox_fuel.
Install and configure ox_lib 3.22.0+, ox_inventory 2.30.0+, and ox_target for the default nozzle workflow.
Review refill, pricing, blip, station, nozzle, hose, fuel-can, and consumption settings in config.lua and data/stations.lua.
For pump audio, copy the four bundled OGG files into the selected InteractSound-compatible provider and start it before testing.
Start the dependency stack before ox_fuel, then test pump fueling, fuel cans, cancellation, range cleanup, insufficient funds, and full tanks.
ensure oxmysql # when required by your ox_inventory setup
ensure ox_lib
ensure your_framework # when ox_inventory uses one
ensure ox_target # default interaction and nozzle mode
ensure ox_inventory
ensure interact-sound # optional, after installing the bundled OGG files
ensure ox_fuel
ensure your_fuel_bridge # optional custom economy adapterKeep the folder named ox_fuel. The resource enforces ox_lib 3.22.0 or newer and ox_inventory 2.30.0 or newer before loading; install the database and framework stack required by your chosen ox_inventory configuration as well.
config.ox_target and config.nozzle.enabled both default to true. The physical carried-nozzle module only loads when both are enabled, so ox_target is required for that workflow even though it is not declared in fxmanifest.lua. Setting config.ox_target to false restores the E-key /startfueling path without the physical nozzle.
Pump duration is derived from the missing fuel, refillValue, and refillTick, while priceTick is charged once per tick. The snapshot defaults to 1 percent every 250 milliseconds and one money item per tick, so test economy changes as a complete formula rather than adjusting one value alone.
refillValue = 1.00
refillTick = 250
priceTick = 1showBlips accepts 0 for hidden, 1 for nearest, or 2 for all. In the default target plus nearest mode, the station loop also shows Fuel Pump or GAS STATION TextUI near a pump. Pump models live in config.lua and station coordinates live in data/stations.lua.
Copy fuelstop.ogg, pickupnozzle.ogg, putbacknozzle.ogg, and refuel.ogg from assets/sounds into the sound provider's expected directory. The provider must expose the InteractSound_SV:PlayOnSource event; merely detecting san_andreas_sound, san_sound, or interact-sound by resource name does not make an incompatible API work.
The default client affordability check and server charge both use ox_inventory's money item. A bank or framework adapter must replace both setMoneyCheck on the client and setPaymentMethod on the server so the displayed balance, interaction checks, and final charge agree.
Before public use, validate and calculate price, fuel delta, petrol-can state, vehicle network ID, pump or vehicle proximity, and request frequency on the server. The inherited events accept client-supplied transaction and fuel values and should not be presented as server-authoritative in this snapshot.
Exit the vehicle, target a supported pump to take the nozzle, carry it within the configured maximum distance, target the nearby vehicle to begin fueling while still holding the nozzle, then target the original pump to return it. The prop remains in the player's hand rather than persistently attaching to the vehicle.
With target mode disabled, stand near a pump or equipped petrol can and use the mapped E key. In target mode, buy or refill a petrol can at a pump, equip it through ox_inventory, then target a supported vehicle.
/startfuelingRead the native fuel level or the synchronized entity state bag. Set the state bag when another resource needs to update fuel; ox_fuel itself does not persist that value to a vehicle database.
local fuel = GetVehicleFuelLevel(vehicle)
local syncedFuel = Entity(vehicle).state.fuel
Entity(vehicle).state.fuel = fuelAmountVerify a partial fill, cancellation, full tank, insufficient funds, fuel-can purchase and refill, hose-range abort, death cleanup, vehicle entry cleanup, and resource restart before opening the resource to players.
Confirm ox_lib 3.22.0+ and ox_inventory 2.30.0+ start successfully before ox_fuel. Then check the dependencies required by the configured inventory and framework bridge.
Start ox_target before ox_fuel and leave both config.ox_target and config.nozzle.enabled true. The nozzle module is intentionally unavailable in the direct E-key mode.
The OGG files are bundled as source copies but are not played directly from ox_fuel. Install them in a running provider and confirm it implements InteractSound_SV:PlayOnSource with the configured names and volumes.
The current station script runs its nearby TextUI loop with showBlips set to 1. With target mode enabled and showBlips set to 0 or 2, it returns before that loop, so use target options alone or adjust the station logic deliberately.
This snapshot's target option checks the 100 buy price before deciding whether the selected can should use the configured 80 refill price. Carry at least the buy price or correct that comparison before relying on the lower refill value.
The new nozzle keys are present only in en.json and the progress labels are hard-coded in English. Add equivalent keys and labels before advertising full localization of the modified workflow.
The inherited manifest and version checker still reference CommunityOx, whose repository is archived. This fork has no tag or release, and active Overextended v1.5.3 changes must be reviewed manually against the custom 1.5.2-based files.