ox_fuel Expanded

When the built-in framework bank adapters do not fit the server, register a server provider after ox_fuel starts. getBalance receives the player ID and selected method; pay must return true only after the matching amount is removed.

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 bounds vehicle distance, source-to-vehicle tolerance, accepted tick variance, and the completion grace window. pumpOccupancy now leases two independent handles per source by default, with prop_vintage_pump excluded. Both active transfers use sharedFlowMultiplier (0.65 by default); holding an idle handle does not reduce the other session's rate. The default acquisition range is four meters, with 15-second leases and five-second heartbeats. Test shared-flow transitions and hose/cable reach together.

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

pumpOccupancy = {
    enabled = true,
    dualNozzles = true,
    sharedFlowMultiplier = 0.65,
    singleNozzleModels = {
        [`prop_vintage_pump`] = true,
    },
    maxAcquireDistance = 4.0,
    leaseDurationMs = 15000,
    heartbeatMs = 5000,
}

nozzle.model now defaults to the original drs_fuel_nozzle across all gas-pump brands, vintage units, custom pumps, and RON docks. Its mounting frame preserves the existing hand/vehicle offsets and hose endpoint. nozzle also controls hose reach, attachment, distance rules, fallback mount, local audio, and debug tools. Resolution still checks a model-specific profile first, then safe petrolcap or petroltank bones, then the configurable body fallback; explicit profiles may intentionally use other bones.

ronPump.enabled defaults to true. Nearby map prop_gas_pump_1a objects are hidden and replaced by drs_gas_pump_ron at the inherited base position and heading. Other brands and script-owned custom pumps are untouched. Disabling ronPump and restarting only ox_fuel restores the map pumps while the companion stays mounted. The physical front/rear registers use the player's approach side by default, regardless of the leased handle. Configure displays, docks, placement, visibility, and damageLocations here. Add unlisted MLO coordinates to damageLocations for synchronized destruction. RON uses model-native lighting; ronPump.lighting.enabled is false. The model's Diesel button is cosmetic and does not add a fuel grade.

-- Existing RON options inside config.ronPump:
enabled = true,
originalModel = `prop_gas_pump_1a`,
model = `drs_gas_pump_ron`,
damageLocations = {}, -- Add vec3 entries for unlisted MLO pumps.

-- Existing options inside ronPump.stationDisplay:
enabled = true,
hudFallback = false,
useApproachSide = true,

The original hardware defaults are electric.chargerModel = drs_ev_station, electric.connectorModel = drs_ev_connector, and portable ground/carry models drs_ev_pack and drs_ev_pack_carry. electric controls Standard/Rapid rates and prices, EV profiles, locations, docked connectors, cables, blips, local audio, and damage. Sentinel uses its physical cabinet screens by default; electric.stationDisplay.hudFallback = true optionally restores the distance/readability fallback. electric.portable retains the unique item's 12 kWh capacity, 7.2 kW display rate, purchase, placement, recharge, warnings, and damage behavior. Portable power retains its compact screen HUD.

versionCheck now reads the maintained Expanded manifest and download URL rather than the CommunityOx baseline. It runs once when the server starts and normally prints only if a newer package is available. Set enabled = false to disable it; notifyCurrent and verboseErrors expose additional notices. An update notice does not install files or replace local settings.

versionCheck = {
    enabled = true,
    manifestUrl = 'https://raw.githubusercontent.com/DrSnyder86/ox_fuel-Expanded/main/ox_fuel/fxmanifest.lua',
    downloadUrl = 'https://github.com/DrSnyder86/ox_fuel-Expanded',
    notifyCurrent = false,
    verboseErrors = false,
    delayMs = 1500,
},

customGasPumpLocations accepts a pump prop, vector4 location, and optional ropeLength; every prop must also be listed in pumpModels. Use vehicleProfiles for gasoline capacity and consumption, electric.vehicles for batteries, and nozzle_offsets.lua for model-specific nozzle or connector mounts.

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

chaosMode.enabled defaults to false. Beneath the master gate are running-engine hazards, hose drive-off outcomes, vintage pump flow quirks, Rapid charger faults, and portable thermal shutdowns. Chance rolls happen on the server; major events use player cooldowns and one-event session guards, and interrupted sessions settle only delivered fuel or energy.

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