⚙️Configuration

Check the standard Config!

config.lua
Config = {
    Main = {
        language = "de", -- Language key used for the language file (e.g. "de", "en")
        framework = "esx", -- Framework in use: "esx" or "qbcore"
        frameworkevent = "es_extended", -- ESX: usually "es_extended" | QBCore: often "QBCore:GetObject" (depends on core version)
        oldesxevent = false, -- true = use old ESX getSharedObject event | false = use newer export-based system
        notify = "sservice" -- Notification system to use (e.g. "sservice", "esx", "qbcore")
    },
    GamePlay = {
        ActiveNozzle = true, -- true = enable nozzle system (fuel hose handling) | false = simple refueling
        TimeToWaitPerLiter = 100, -- Refuel time per liter in milliseconds (higher = slower fueling)
        pricefluctation = {
            -- Random price fluctuation settings
            max = 10, -- Maximum price increase
            min = -10 -- Maximum price decrease
        },
        Fuelcanprice = 100, -- Price of a fuel can
        DecorFuel = "_FUEL_LEVEL", -- Decorator key used to store vehicle fuel level
        defaultfuel = "petrol", -- Default fuel type if none is selected
        freezeonanimation = true, -- Freeze player during fueling animation (prevents movement/exploits)
        explodewhennoozletofaraway = true, -- Trigger explosion if nozzle is too far away from vehicle
        explosion = {
            explosiontype = 2, -- GTA explosion type ID (used in CreateExplosion native)
            explosiondamage = 2.0, -- Explosion damage multiplier
            explosionaudible = true, -- Whether explosion produces sound
            explosioninvisible = false,
            -- Whether explosion is invisible
            explosioncamerashake = 1.0 -- Camera shake intensity
        }
    },
    FuelClasses = {
        [0] = 1.0, -- Compacts: fuel consumption multiplier
        [1] = 1.0, -- Sedans
        [2] = 1.0, -- SUVs
        [3] = 1.0, -- Coupes
        [4] = 1.0, -- Muscle
        [5] = 1.0, -- Sports Classics
        [6] = 1.0, -- Sports
        [7] = 1.0, -- Super
        [8] = 1.0, -- Motorcycles
        [9] = 1.0, -- Off-road
        [10] = 1.0, -- Industrial
        [11] = 1.0, -- Utility
        [12] = 1.0, -- Vans
        [13] = 0.0, -- Cycles (bicycles): no fuel usage
        [14] = 1.0, -- Boats
        [15] = 1.0, -- Helicopters
        [16] = 1.0, -- Planes
        [17] = 1.0, -- Service
        [18] = 1.0, -- Emergency
        [19] = 1.0, -- Military
        [20] = 1.0, -- Commercial
        [21] = 1.0 -- Trains
    },
    FuelUsage = {
        -- RPM/Throttle level -> fuel usage multiplier
        [1.0] = 1.7, -- Full throttle / maximum load
        [0.9] = 1.3,
        [0.8] = 1.0,
        [0.7] = 0.9,
        [0.6] = 0.8,
        [0.5] = 0.7,
        [0.4] = 0.6,
        [0.3] = 0.5,
        [0.2] = 0.4,
        [0.1] = 0.3,
        [0.0] = 0.1 -- Idle / minimal load
    },
    Locations = {
        -- Fuel station coordinates (X, Y, Z)
        {x = 49.4187, y = 2778.793, z = 58.043},
        {x = 263.894, y = 2606.463, z = 44.983},
        {x = 1039.958, y = 2671.134, z = 39.550},
        {x = 1207.260, y = 2660.175, z = 37.899},
        {x = 2539.685, y = 2594.192, z = 37.944},
        {x = 2679.858, y = 3263.946, z = 55.043},
        {x = 2005.055, y = 3773.887, z = 32.043},
        {x = 1687.156, y = 4929.392, z = 42.043},
        {x = 1701.314, y = 6416.028, z = 32.043},
        {x = 179.857, y = 6602.839, z = 31.043},
        {x = -94.4619, y = 6419.594, z = 31.041},
        {x = -2554.996, y = 2334.40, z = 33.043},
        {x = -1800.375, y = 803.661, z = 138.043},
        {x = -1437.622, y = -276.747, z = 46.043},
        {x = -2096.243, y = -320.286, z = 13.043},
        {x = -724.619, y = -935.1631, z = 19.043},
        {x = -526.019, y = -1211.003, z = 19.043},
        {x = -70.2148, y = -1761.792, z = 18.043},
        {x = 265.648, y = -1261.309, z = 29.043},
        {x = 819.653, y = -1028.846, z = 29.043},
        {x = 1208.951, y = -1402.567, z = 26.043},
        {x = 1181.381, y = -330.847, z = 69.316},
        {x = 620.843, y = 269.100, z = 103.316},
        {x = 2581.321, y = 362.039, z = 108.316},
        {x = 176.631, y = -1562.025, z = 29.316},
        {x = -319.292, y = -1471.715, z = 30.316},
        {x = 1784.324, y = 3330.55, z = 41.316}
    },
    fueltypes = {
        {
            name = "petrol", -- Internal fuel identifier (must be unique)
            priceperliter = 50, -- Price per liter (or per unit)
            color = "yellow", -- UI display color
            boost = 110.0, -- Performance boost value (depends on implementation logic)
            damage = 0.05, -- Engine wear/damage multiplier
            value = "l", -- Unit displayed in UI (e.g. liters, kWh)
            vehicles = {
                ["zentorno"] = true -- Whitelisted vehicles for this fuel type
            }
        },
        {
            name = "petrolplus", -- Premium petrol
            priceperliter = 50,
            color = "yellow",
            boost = 0.05, -- Slight performance increase
            damage = 0.02, -- Lower engine wear
            value = "l",
            vehicles = {
                ["zentorno"] = true
            }
        },
        {
            name = "electric", -- Electric charging
            priceperliter = 10, -- Price per kWh
            color = "red",
            boost = 0.0, -- No performance boost
            damage = 10.08, -- Very high engine damage (verify logic if intentional)
            value = "kwh",
            vehicles = {
                ["adder"] = true
            }
        },
        {
            name = "ecofuel", -- Eco/Bio fuel
            priceperliter = 45,
            color = "green",
            boost = 0.02,
            damage = 0.04,
            value = "l",
            vehicles = {
                ["adder"] = true
            }
        },
        {
            name = "diesel", -- Diesel fuel
            priceperliter = 45,
            color = "yellow",
            boost = 0.0,
            damage = 0.06,
            value = "l",
            vehicles = {
                ["Mixer"] = true -- Note: vehicle names are usually lowercase ("mixer")
            }
        }
    }
}

Config.Blips = {
    sprite = 361,
    scale = 0.7,
    colour = 4,
    display = 4
}

Config.PumpModels = {
    [-2007231801] = true, -- Valid fuel pump model hash
    [1339433404] = true,
    [1694452750] = true,
    [1933174915] = true,
    [-462817101] = true,
    [-469694731] = true,
    [-164877493] = true
}

Config.NozzleProp = "prop_cs_fuel_nozle" -- Fuel nozzle prop attached to player during fueling

Config.Petrolcan = GetHashKey("WEAPON_PETROLCAN") -- GTA weapon hash for fuel can

circle-info

If you find any errors in the configuration and you can't fix them yourself, open a ticket!

Last updated