API Reference GE Extensions career modules Career Fuel System M.dependencies = {'career_career'}
M. dependencies = { 'career_career' }
Manages vehicle refueling at gas stations - handles fuel types, flow rates, pricing with insurance discounts, sound effects, and payment transactions.
Field Value Path extensions/career/modules/fuel.luaGlobal career_modules_fuelDependencies career_career
Function Signature Description startTransaction(gasStation)Begins refueling at a gas station. Opens UI, turns off ignition getFuelData()Returns current fuel tank data array isCurrentlyFueling()Returns true if any tank is actively being filled getFuelingData()Returns fueling session data (price, energy added per tank) payPrice()Stops fueling, deducts money, saves, ends transaction onChangeFlowRate(factor)Sets fuel flow rate (0–1). Auto-starts/stops fueling uiButtonStartFueling(energyType)Starts fueling all tanks of a given energy type uiButtonStopFueling(energyType)Stops fueling for an energy type requestRefuelingTransactionData()Requests energy storage data from vehicle bridge uiCancelTransaction()Cancels and pays for any fuel dispensed sendUpdateDataToUI()Sends current fuel data to UI minimumRefuelingCheck(vehId)Emergency refuel: fully charges electric, adds 5% if nearly empty
Hook Description onUpdateFills tanks per frame, updates UI, plays sounds, auto-cancels if driving onCareerModulesActivatedSets up audio sources onClientStartMissionSets up audio sources onClientEndMissionClears audio source IDs
Type Factor (MJ→unit) Unit Description gasoline31.125 L Standard gasoline diesel36.112 L Diesel fuel kerosine34.4 L Kerosene/jet fuel n2o8.3 kg Nitrous oxide electricEnergy3.6 kWh Electric charge
startTransaction(gasStation)
├─ Set ignition to 0
├─ Push "Refueling" action map
├─ Request energy storage data from vehicle
├─ Open refueling UI
└─ Check for insurance fuel discount
onChangeFlowRate(factor) - per-frame
├─ Start/stop fueling based on factor
└─ Scale flow rate (0 = stop, 1 = max)
payPrice()
├─ Stop all fueling
├─ Deduct money (unless work loaner)
├─ Pop action map
├─ Save career
└─ Return to play state
-- Start refueling (called from facility interaction)
career_modules_fuel. startTransaction (gasStationData)
-- Check if currently fueling
if career_modules_fuel. isCurrentlyFueling () then
print ( "Fueling in progress" )
end
-- Emergency refuel check
career_modules_fuel. minimumRefuelingCheck ()
career_modules_playerAttributes - Money deduction
career_modules_inventory - Current vehicle lookup
career_modules_insurance_insurance - Fuel discount data
freeroam_facilities_fuelPrice - Base fuel prices
Export Description M.getFuelDataValue: getFuelData M.getFuelingDataValue: getFuelingData M.isCurrentlyFuelingValue: isCurrentlyFueling M.minimumRefuelingCheckValue: minimumRefuelingCheck M.onCareerModulesActivatedValue: onCareerModulesActivated M.onChangeFlowRateValue: onChangeFlowRate M.onClientEndMissionValue: onClientEndMission M.onClientStartMissionValue: onClientStartMission M.onUpdateValue: onUpdate M.payPriceValue: payPrice M.requestRefuelingTransactionDataValue: requestRefuelingTransactionData M.sendUpdateDataToUIValue: sendUpdateDataToUI M.startTransactionValue: startTransaction M.uiButtonStartFuelingCalled by UI M.uiButtonStopFuelingValue: uiButtonStopFueling M.uiCancelTransactionValue: uiCancelTransaction