⚙️Configuration

Key	Description	Example
Config.Framework	"auto", "esx", "qb"	"auto"
Config.Language	Locale key from locales/*.lua	"en"
Config.JobName	Mechanic job name	"taxi" or "mechanic"
Config.PaintPrice	Base price for paint ops	50
Config.SocietyName	Society account name	"society_mechanic"
Config.UseSocity	If mechanic, charge society instead of player	true
Config.GoInSoicity	If self-tuning, income goes to society	true

Spelling in keys is intentional: use exactly UseSocity and GoInSoicity.

HUD & Notifications

Provide your own functions or set UseCustomNotify/UseCustomHelpNotify to false for fallbacks.

Config.HideHud = function() exports["risk-hud"]:show(false) end
Config.showHud = function() exports["risk-hud"]:show(true) end

Config.UseCustomNotify = true
Config.UseCustomHelpNotify = true

Config.Functions = {
  notify = function(ntype, title, text, time)
    exports["risk-notify"]:Notify({ type = ntype or "info", title = "LS CUSTOMS", message = text, duration = 10000 })
  end,
  helpnotify = function(key, text)
    exports["risk-notify"]:HelpNotify(key, text)
  end,
}

Modes

Config.TunerSettings = {
  type = "both", -- "self", "both", "mechanic"
  both = { enableMechanicRequirement = true, minMechanic = 1 }
}

• mechanic: only mechanics can open and do full upgrades.

• self: everyone can tune fully.

• both: non-mechanics are limited to cosmetics when mechanics ≥ minMechanic. If fewer mechanics, self-tuning opens for players. Mechanics always have full access.

Blips & Markers

Config.Blips.normal = { visible=true, name="Los Santos Custom", sprite=72, color=5, scale=0.7 }
Config.Blips.tuner  = { visible=true, name="Tuner", sprite=72, color=83, scale=0.8 }

Config.Marker = { type=0, scale={x=.6,y=.6,z=.6}, color={r=255,g=255,b=0}, rotate=false }

• Zones[i].selftuner = true marks a public tuner location.

• Zones[i].hideblip = true hides that blip by default.

Zones

Config.Zones = {
  { coord = vector3(-318.86, -131.44, 39.75), selftuner=false, hideblip=true },
  { coord = vector3(-316.73, -125.25, 39.75), selftuner=false, hideblip=false },
  { coord = vector3(731.81, -1088.82, 21.73), selftuner=true,  hideblip=false },
  -- more...
}

Menus & Pricing

• Upgrade categories use price = {level1, level2, ...}. If vehicle has fewer levels, last price entry is reused.

• Cosmetics use flat price per selection.

• Paint/Xenon/Neon/Wheel color have dedicated prices (Config.PaintPrice, Menus.xenonColor.price, etc.).

Config = {}

Config.Framework = "auto" -- Determines which framework to use: auto, esx, or qb
Config.Locales = {}
Config.Language = "en" -- Script language
Config.JobName = {"mechanic", "tuner", "lscustom"} -- Jobs with tuner access. Single job: Config.JobName = "mechanic" | Multiple jobs: Config.JobName = {"mechanic", "tuner"}
Config.PaintPrice = 50 -- Price for paint changes

Config.UseSocity = false -- Use society money for mechanics
Config.GoInSoicity = false -- Payments from non-mechanics go to society
Config.PaymentType = "cash" -- "cash", "bank", or "item"
Config.PaymentItem = "cash" -- Item name when PaymentType is "item"

Config.JobSocieties = {
    ["mechanic"] = "society_mechanic",
    ["tuner"] = "society_tuner",
    ["lscustom"] = "society_lscustom"
}

Config.HideHud = function()
--    exports["risk-hud"]:show(false) -- Hides HUD while tuning UI is open
end

Config.showHud = function()
--    exports["risk-hud"]:show(true) -- Shows HUD after closing tuning UI
end

Config.UseCustomNotify = false -- Enables custom notify event
Config.UseCustomHelpNotify = false -- Enables custom help notify event

Config.Functions = {
    ["notify"] = function(ntype, title, text, time)
        exports["risk-notify"]:Notify({
            type = ntype or "info",
            message = text,
            title = "LS CUSTOMS",
            duration = 10000
        }) -- Sends notification using risk-notify
    end,

    ["helpnotify"] = function(key, text)
        exports["risk-notify"]:HelpNotify(key, text) -- Displays help notification
    end
}

Config.TunerSettings = {
    type = "self", -- Available: "self", "both", or "mechanic"
    both = {
        enableMechanicRequirement = true, -- Requires minimum mechanics online
        minMechanic = 3 -- Minimum mechanics needed to restrict self-tuning
    }
}

Config.Blips = {
    normal = {
        visible = true, -- Show mechanic shop blip
        name = "Los Santos Custom", -- Blip name
        sprite = 72, -- Blip icon
        color = 5, -- Blip color
        scale = 0.7 -- Blip size
    },

    tuner = {
        visible = true, -- Show tuner shop blip
        name = "Tuner", -- Blip name
        sprite = 72, -- Blip icon
        color = 46, -- Blip color
        scale = 0.8 -- Blip size
    }
}

Config.Marker = {
    type = 0, -- Marker type
    scale = {
        x = 0.6,
        y = 0.6,
        z = 0.6
    }, -- Marker size
    color = {
        r = 255,
        g = 255,
        b = 0
    }, -- Marker color
    rotate = false -- Enable or disable rotation
}

Config.Zones = {{
    coord = vector3(-332.3175, -1367.7806, 32.1219),
    selftuner = false,
    hideblip = true
}, {
    coord = vector3(-340.0015, -1367.8744, 32.1128),
    selftuner = false,
    hideblip = true
}, {
    coord = vector3(-347.6284, -1367.7495, 32.1212),
    selftuner = false,
    hideblip = false
}, -- Color marker
{
    coord = vector3(-336.1121, -1343.4081, 32.0569),
    selftuner = false,
    hideblip = true
}, -- Color marker
{
    coord = vector3(-330.4880, -1343.7115, 32.0579),
    selftuner = false,
    hideblip = true
}}

Citizen.CreateThread(function()
    Config.Menus = {
        main = {
            label = 'LS CUSTOMS',
            parent = nil,
            upgrades = TranslateCap('upgrades'),
            cosmetics = TranslateCap('cosmetics')
        },
        upgrades = {
            label = TranslateCap('upgrades'),
            parent = 'main',
            modEngine = TranslateCap('engine'),
            modBrakes = TranslateCap('brakes'),
            modTransmission = TranslateCap('transmission'),
            modSuspension = TranslateCap('suspension'),
            modArmor = TranslateCap('armor'),
            modTurbo = TranslateCap('turbo')
        },
        modEngine = {
            label = TranslateCap('engine'),
            parent = 'upgrades',
            modType = 11,
            price = {50, 100, 200, 400}
        },
        modBrakes = {
            label = TranslateCap('brakes'),
            parent = 'upgrades',
            modType = 12,
            price = {20, 40, 60, 80}
        },
        modTransmission = {
            label = TranslateCap('transmission'),
            parent = 'upgrades',
            modType = 13,
            price = {50, 75, 150, 200}
        },
        modSuspension = {
            label = TranslateCap('suspension'),
            parent = 'upgrades',
            modType = 15,
            price = {20, 40, 60, 100, 150}
        },
        modArmor = {
            label = TranslateCap('armor'),
            parent = 'upgrades',
            modType = 16,
            price = {200, 300, 400, 500, 600, 700}
        },
        modTurbo = {
            label = TranslateCap('turbo'),
            parent = 'upgrades',
            modType = 17,
            price = {200}
        },
        cosmetics = {
            modAerials = TranslateCap('aerials'),
            modAirFilter = TranslateCap('air_filter'),
            modAPlate = TranslateCap('quarter_deck'),
            modArchCover = TranslateCap('arch_cover'),
            bodyparts = TranslateCap('bodyparts'),
            modDashboard = TranslateCap('dashboard'),
            modDial = TranslateCap('speedometer'),
            modDoorSpeaker = TranslateCap('door_speakers'),
            modEngineBlock = TranslateCap('engine_block'),
            modShifterLeavers = TranslateCap('gear_level'),
            xenonColor = TranslateCap('headlights'),
            modHorns = TranslateCap('horns'),
            modHydrolic = TranslateCap('hydraulic'),
            modTrimA = TranslateCap('interior'),
            plateIndex = TranslateCap('licenseplates'),
            neonColor = TranslateCap('neons'),
            modOrnaments = TranslateCap('trim'),
            pearlescentColor = 'Pearlescent',
            modPlateHolder = TranslateCap('modplateholder'),
            modSeats = TranslateCap('seats'),
            modSpeakers = TranslateCap('speakers'),
            modSteeringWheel = TranslateCap('steering_wheel'),
            modLivery = TranslateCap('stickers'),
            modStruts = TranslateCap('struts'),
            modTank = TranslateCap('fuel_tank'),
            modTrimB = TranslateCap('wings'),
            modTrunk = TranslateCap('trunk'),
            modVanityPlate = TranslateCap('modvanityplate'),
            wheels = TranslateCap('wheels'),
            modWindows = TranslateCap('windows'),
            windowTint = TranslateCap('windowtint'),
            extras = 'Extras'
        },

        extras = {
            label = 'Extras',
            parent = 'cosmetics'
        },

        modPlateHolder = {
            label = TranslateCap('modplateholder'),
            parent = 'cosmetics',
            modType = 25,
            price = 20
        },
        modVanityPlate = {
            label = TranslateCap('modvanityplate'),
            parent = 'cosmetics',
            modType = 26,
            price = 20
        },
        modTrimA = {
            label = TranslateCap('interior'),
            parent = 'cosmetics',
            modType = 27,
            price = 50
        },
        modOrnaments = {
            label = TranslateCap('trim'),
            parent = 'cosmetics',
            modType = 28,
            price = 20
        },
        modDashboard = {
            label = TranslateCap('dashboard'),
            parent = 'cosmetics',
            modType = 29,
            price = 30
        },
        modDial = {
            label = TranslateCap('speedometer'),
            parent = 'cosmetics',
            modType = 30,
            price = 30
        },
        modDoorSpeaker = {
            label = TranslateCap('door_speakers'),
            parent = 'cosmetics',
            modType = 31,
            price = 40
        },
and so on.....