ox_fuel Expanded

Overview

ox_fuel Expanded builds on CommunityOx ox_fuel 1.5.2. It adds hands-on gasoline fueling, electric vehicle (EV) charging, portable emergency charging, a themed checkout, and payments checked by the server. Install both included resource folders and the required sound, inventory, and interaction resources before changing vehicle settings.

Requirements

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

Installation

1. 01

   Install both included folders, keeping them named ox_fuel and ox_fuel_assets, and disable every competing fuel resource.

2. 02

   Install ox_lib 3.22.0+, ox_inventory 2.30.0+, ox_target, and San Andreas Sound.

3. 03

   Add the supplied portable_ev_charger item to ox_inventory and copy its compact image into ox_inventory/web/images.

4. 04

   Copy all seven bundled OGG files into san_andreas_sound/web/sounds.

5. 05

   Review fuel, payment, pump, nozzle, EV, portable, vehicle-profile, location, and Chaos Mode settings in config.lua and the data modules.

6. 06

   Start the resources in the documented order and perform a full server restart for the first ox_fuel_assets installation.

Configuration

['portable_ev_charger'] = {
    label = 'Portable EV Charger',
    weight = 12000,
    stack = false,
    close = true,
    consume = 0,
    client = {
        export = 'ox_fuel.portableEvCharger',
        image = 'portable_ev_charger_compact.png',
    },
}

chargestop.ogg
charging.ogg
fuelstop.ogg
pickupnozzle.ogg
putbackcharger.ogg
putbacknozzle.ogg
refuel.ogg

fueling = {
    pumpGallonsPerSecond = 0.20,
    canGallonsPerSecond = 0.10,
    defaultGrade = 'regular',
    premiumGrade = 'premium',
    gradeOrder = { 'regular', 'premium' },
    grades = {
        regular = { octane = 87, pricePerGallon = 5.82, premiumRatio = 0.0, consumptionMultiplier = 1.00 },
        premium = { octane = 93, pricePerGallon = 7.99, premiumRatio = 1.0, consumptionMultiplier = 0.90 },
    },
}

payments = {
    defaultMethod = 'cash',
    methodOrder = { 'cash', 'bank' },
}

exports.ox_fuel:setPaymentProvider({
    getBalance = function(playerId, methodId)
        -- Return the available balance for this payment method.
    end,
    pay = function(playerId, amount, methodId)
        -- Remove the amount and return true only on success.
    end,
})

serverValidation = {
    maxVehicleDistance = 6.0,
    sourceVehicleTolerance = 4.0,
    tickTolerance = 2,
    sessionGraceMs = 10000,
}

pumpOccupancy = {
    enabled = true,
    maxAcquireDistance = 4.0,
    leaseDurationMs = 15000,
    heartbeatMs = 5000,
}

customGasPumpLocations = {
    {
        prop = 'prop_gas_pump_old3',
        location = vector4(442.2, -977.17, 42.69, 270.3),
        ropeLength = 14.0,
    },
}

chaosMode = {
    enabled = false,
    adminLogging = true,
    protections = {
        playerCooldownSeconds = 900,
        oneMajorEventPerSession = true,
    },
}

How to use and test it

/ox_fuel_nozzleoffset
/ox_fuel_chargeroffset
/ox_fuel_debugcaps

/startfueling

Troubleshooting

Reference

local state = Entity(vehicle).state
local fuel = state.fuel or GetVehicleFuelLevel(vehicle)

state:set('fuel', math.clamp(newFuel, 0, 100), true)

exports.ox_fuel:setPaymentProvider(provider)
exports.ox_fuel:setPaymentProvider(getBalance, pay)

exports.ox_fuel:setPaymentMethod(function(playerId, amount, methodId)
    -- Charge the account and return true on success.
end)

local ratio = exports.ox_fuel:getFuelPremiumRatio(vehicle)
local updated = exports.ox_fuel:setFuelPremiumRatio(vehicle, 0.5)

local mount = exports.ox_fuel:getVehicleFuelNozzleMount(vehicle)

client = {
    export = 'ox_fuel.portableEvCharger',
}

• Version 1.5.2-expanded.2 is the manifest and changelog version on the public main branch. The repository currently has no tag or GitHub release, so pin the tested commit rather than treating an automatically generated branch archive as a release artifact.
• Keep the main resource named ox_fuel and the companion named ox_fuel_assets. A full restart is required for the first companion installation and whenever its streamed archetypes change.
• The version checker still queries communityox/ox_fuel. Follow the ox_fuel-Expanded repository and changelog for Expanded updates until that runtime target changes.
• Both packaged resources are GPL-3.0. Preserve LICENSE and THIRD_PARTY_NOTICES.md, CommunityOx attribution, CDN-Fuel asset and sound provenance, LC Fuel data provenance, and modification notices when redistributing the package.
• San Andreas Sound is the supported shipped audio path. Although legacy InteractSound-compatible code remains internally, do not substitute another provider without reviewing and adapting the current runtime.
• Do not document setMoneyCheck as a working integration hook in this snapshot: the export assigns a client function, but the active checkout path does not consume it.