⚙️Configuration
Detailed explanation of the config file to adapt the resource to your player needs.
The config.lua
Config = {}
-- ====================================
-- BASIC SETTINGS
-- ====================================
Config.Debug = true -- Enable debug mode (prints detailed logs to console)
Config.Language = 'en' -- UI language
-- Available: 'en', 'fr', 'es', 'de', 'it', 'pt', 'pl', 'tr', 'ru', 'ar', 'bg'
-- ====================================
-- UI & INTERACTION
-- ====================================
Config.UI = {
item = 'boostingtablet', -- Item required to open UI
img = 'ox_inventory/web/images/',
}
-- ====================================
-- CONSUMABLES
-- ====================================
Config.Items = {
Lockpick = 'boos_lockpick',
Hack = 'boos_hacktool',
Scanner = 'boos_scanner',
Tablet = 'boos_tablet',
}
-- ====================================
-- Rewards
-- ====================================
Config.ExtraRewards = {
chopshop = {
doors = {
{ name = 'glass', min = 1, max = 3, chance = 100, info = {}},
{ name = 'rubber', min = 1, max = 3, chance = 100, info = {}},
{ name = 'steel', min = 1, max = 3, chance = 100, info = {}},
{ name = 'aluminum', min = 1, max = 3, chance = 30, info = {}},
{ name = 'plastic', min = 1, max = 3, chance = 30, info = {}},
{ name = 'copper', min = 1, max = 3, chance = 30, info = {}},
},
wheels = {
{ name = 'glass', min = 1, max = 3, chance = 100, info = {}},
{ name = 'rubber', min = 1, max = 3, chance = 100, info = {}},
{ name = 'steel', min = 1, max = 3, chance = 100, info = {}},
{ name = 'aluminum', min = 1, max = 3, chance = 30, info = {}},
{ name = 'plastic', min = 1, max = 3, chance = 30, info = {}},
{ name = 'copper', min = 1, max = 3, chance = 30, info = {}},
},
cash = { -- devided on all members !
min = 4000,
max = 5000
}
},
dropoff = {
cash = { -- devided on all members !
min = 4000,
max = 5000
}
}
}
-- ====================================
-- REPUTATION & LEVEL SYSTEM
-- ====================================
Config.Reputation = {
StartCoins = 150, -- Starting coins for new players
StartRep = 15, -- Starting reputation for new players
MinRep = 0, -- Minimum reputation
MaxRep = 500, -- Maximum reputation (5 levels * 100)
-- Level progression (100 rep per level)
LevelThresholds = {
{ level = 1, minRep = 0, maxRep = 100, name = "Rookie" },
{ level = 2, minRep = 101, maxRep = 200, name = "Amateur" },
{ level = 3, minRep = 201, maxRep = 300, name = "Professional" },
{ level = 4, minRep = 301, maxRep = 400, name = "Expert" },
{ level = 5, minRep = 401, maxRep = 500, name = "Legend" }
},
-- Reputation changes
Penalties = {
FailedContract = -15, -- Reputation loss for failed contract
},
}
-- ====================================
-- VEHICLE TIER SYSTEM (TIER = DIFFICULTY)
-- ====================================
Config.VehicleClasses = {
['D'] = {
name = "D Off-Road",
color = "#A78BFA",
gradient = "linear-gradient(135deg, #A78BFA 0%, #8B5CF6 100%)",
repRequired = 0, -- Minimum reputation required
levelRequired = 1, -- Minimum level required
difficulty = "Beginner", -- Maps to difficulty settings
baseCost = 50, -- Base boosting coins cost
vinScratchcost = 500, -- Cost to scratch vehicle VIN
rewardMultiplier = 0.3 -- Reward multiplier for this tier
},
['C'] = {
name = "C Muscle",
color = "#FF9F43",
gradient = "linear-gradient(135deg, #FF9F43 0%, #FF6B6B 100%)",
repRequired = 10,
levelRequired = 1,
difficulty = "Beginner",
baseCost = 80,
vinScratchcost = 800, -- Cost to scratch vehicle VIN
rewardMultiplier = 0.6
},
['B'] = {
name = "B Sports",
color = "#57FFC7",
gradient = "linear-gradient(135deg, #57FFC7 0%, #00D4FF 100%)",
repRequired = 25,
levelRequired = 2,
difficulty = "Intermediate",
baseCost = 120,
vinScratchcost = 1200, -- Cost to scratch vehicle VIN
rewardMultiplier = 0.8
},
['A'] = {
name = "A Premium",
color = "#4ECDC4",
gradient = "linear-gradient(135deg, #4ECDC4 0%, #44A08D 100%)",
repRequired = 50,
levelRequired = 3,
difficulty = "Advanced",
baseCost = 200,
vinScratchcost = 1600, -- Cost to scratch vehicle VIN
rewardMultiplier = 1.0
},
['S'] = {
name = "S Super",
color = "#FF6B6B",
gradient = "linear-gradient(135deg, #FF6B6B 0%, #FF8E53 100%)",
repRequired = 75,
levelRequired = 4,
difficulty = "Expert",
baseCost = 350,
vinScratchcost = 1800, -- Cost to scratch vehicle VIN
rewardMultiplier = 1.2
},
['S_PLUS'] = {
name = "S+ Elite",
color = "#FFD700",
gradient = "linear-gradient(135deg, #FFD700 0%, #FFA500 100%)",
repRequired = 90,
levelRequired = 5,
difficulty = "Expert",
baseCost = 500,
vinScratchcost = 3200, -- Cost to scratch vehicle VIN
rewardMultiplier = 1.5
}
}
-- ====================================
-- CONTRACT SETTINGS
-- ====================================
Config.Contracts = {
MaxTeamSize = 4, -- Maximum team members (including leader)
OffreDuration = 120, -- minutes until contract expires
ContractDuration = 30, -- the player has 30 mins to finish the contract from the Start time
RefreshInterval = 0.1, -- minutes between contract refreshes
-- Contract Generation Settings
Generation = {
MaxContracts = 10,
TierDistribution = {
D = 0.30, -- 30%
C = 0.25, -- 25%
B = 0.20, -- 20%
A = 0.15, -- 15%
S = 0.08, -- 8%
S_PLUS = 0.02 -- 2%
}
},
-- Completion Types
CompletionTypes = {
dropoff = {
name = "Dropoff",
},
chopshop = {
name = "Chop Shop",
}
},
-- Difficulty Settings (linked to tiers)
Difficulties = {
Beginner = {
npcCount = 1, -- for drop off only
weapons = {'weapon_bat', 'weapon_golfclub'} -- for drop off only
},
Intermediate = {
npcCount = 3, -- for drop off only
weapons = {'weapon_pistol', 'weapon_marksmanpistol'} -- for drop off only
},
Advanced = {
npcCount = 4, -- for drop off only
weapons = {'weapon_smg', 'weapon_microsmg'} -- for drop off only
},
Expert = {
npcCount = 5, -- for drop off only
weapons = {'weapon_gusenberg', 'weapon_assaultrifle'} -- for drop off only
}
}
}
-- ====================================
-- VEHICLE SPAWN SETTINGS
-- ====================================
Config.VehicleSpawn = {
DespawnDistance = 100.0, -- Distance to despawn vehicles
SpawnDistance = 50.0, -- Distance to spawn vehicles
MaxSpawnAttempts = 3,
SpawnCooldown = 30, -- seconds between spawn attempts
-- Vehicle spawn locations - MORE VARIED LOCATIONS
SpawnLocations = {
-- Los Santos Area
{
vehcoords = vector4(88.38, 487.53, 147.39, 206.63),
keycoords = vector3(64.73, 481.52, 149.75),
name = "Mirror Park",
npcs = {
{ model = "a_m_m_ktown_01", coords = vector4(57.96, 470.98, 146.93, 226.34)},
{ model = "a_m_m_ktown_01", coords = vector4(66.72, 457.23, 146.89, 327.76)},
{ model = "a_m_m_ktown_01", coords = vector4(103.16, 473.63, 147.4, 7.94)},
{ model = "a_m_m_ktown_01", coords = vector4(105.91, 493.32, 147.15, 287.54)},
{ model = "a_m_m_ktown_01", coords = vector4(80.25, 485.97, 148.2, 205.24)}
}
},
{
vehcoords = vector4(-248.76, 493.12, 125.08, 19.1),
keycoords = vector3(-214.33, 469.2, 127.03),
name = "Vinewood Hills",
npcs = {
{ model = "a_m_m_ktown_01", coords = vector4(-230.39, 487.9, 128.77, 17.85)},
{ model = "a_m_m_ktown_01", coords = vector4(-203.62, 495.77, 128.43, 42.95)},
{ model = "a_m_m_ktown_01", coords = vector4(-226.66, 489.17, 132.48, 69.77)},
{ model = "a_m_m_ktown_01", coords = vector4(-250.15, 484.58, 130.06, 6.66)},
{ model = "a_m_m_ktown_01", coords = vector4(-248.2, 476.7, 126.57, 31.76)}
}
},
{
vehcoords = vector4(1256.93, -491.54, 68.99, 256.45),
keycoords = vector3(1251.06, -504.19, 69.61),
name = "El Burro Heights",
npcs = {
{ model = "a_m_m_ktown_01", coords = vector4(1255.36, -505.31, 69.72, 261.83)},
{ model = "a_m_m_ktown_01", coords = vector4(1251.49, -494.0, 69.91, 255.56)},
{ model = "a_m_m_ktown_01", coords = vector4(1247.21, -485.46, 69.83, 254.36)},
{ model = "a_m_m_ktown_01", coords = vector4(1265.84, -487.28, 69.41, 120.65)},
{ model = "a_m_m_ktown_01", coords = vector4(1247.03, -489.18, 72.79, 249.38)}
}
},
{
vehcoords = vector4(1389.68, -577.26, 73.91, 109.26),
keycoords = vector3(1393.0, -561.32, 74.39),
name = "El Burro Heights Industrial",
npcs = {
{ model = "a_m_m_ktown_01", coords = vector4(1385.32, -556.7, 74.39, 154.58)},
{ model = "a_m_m_ktown_01", coords = vector4(1389.13, -569.68, 74.5, 110.77)},
{ model = "a_m_m_ktown_01", coords = vector4(1391.55, -581.91, 74.45, 132.84)},
{ model = "a_m_m_ktown_01", coords = vector4(1404.44, -570.65, 74.34, 95.66)},
{ model = "a_m_m_ktown_01", coords = vector4(1406.41, -567.53, 77.32, 113.26)}
}
},
{
vehcoords = vector4(176.88, 480.66, 142.01, 343.54),
keycoords = vector3(174.27, 466.35, 141.91),
name = "Mirror Park Tunnel",
npcs = {
{ model = "a_m_m_ktown_01", coords = vector4(167.26, 473.8, 142.51, 75.07)},
{ model = "a_m_m_ktown_01", coords = vector4(186.43, 492.65, 141.61, 109.86)},
{ model = "a_m_m_ktown_01", coords = vector4(166.72, 498.8, 143.2, 182.29)},
{ model = "a_m_m_ktown_01", coords = vector4(154.51, 497.15, 144.24, 251.41)},
{ model = "a_m_m_ktown_01", coords = vector4(171.59, 472.33, 147.31, 347.91)}
}
},
},
-- Vehicle modifications for spawned vehicles
VehicleMods = {
PlateText = "BSTD", -- Custom plate text
}
}
-- ====================================
-- POLICE SETTINGS
-- ====================================
Config.Police = {
job = {"police", "sheriff"},
RequiredCops = 0, -- Minimum cops online to start contracts (0 to disable)
BlipRefreshInterval = 30, -- seconds between police dispatches
-- Police blip settings when alerted
BlipSettings = {
Sprite = 225, -- Police blip sprite
Color = 1, -- Police blip color
Scale = 1.0, -- Blip scale
Display = 4, -- Blip display
ShortRange = false -- Long range blip
},
TrackingRefreshRates = {
1.0, -- Level 0: 1 second
3.0, -- Level 1: 3 seconds
6.0, -- Level 2: 6 seconds
9.0, -- Level 3: 9 seconds
0 -- Level 4: Disabled
},
HackSettings = {
[0] = {time = 60, refresh = 3000}, -- First hack: 60 seconds, refresh 3000ms
[1] = {time = 50, refresh = 2500}, -- Second hack: 50 seconds, refresh 2500ms
[2] = {time = 40, refresh = 2000}, -- Third hack: 40 seconds, refresh 2000ms
[3] = {time = 30, refresh = 1000}, -- Fourth hack: 30 seconds, refresh 1000ms
}
}
-- ====================================
-- DROPOFF LOCATIONS
-- ====================================
Config.DropoffLocations = {
[1] = {
name = "Little Bighorn Avenue",
coords = vector4(112.83, 6619.22, 31.84, 218.13),
radius = 10.0,
type = "warehouse",
security = "low",
vinscratch = {
table = {
model = 'prop_offroad_barrel01', -- Z - 0.43
coords = vector4(109.024200, 6625.815918, 30.802140, 0.000000), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(108.977417, 6625.762695, 31.676558, 125.917908), -- position where the laptop will be spawned
}
}
},
[2] = {
name = "Little Bighorn Avenue",
coords = vector4(493.86, -1307.93, 29.29, 303.39),
radius = 10.0,
type = "warehouse",
security = "low",
vinscratch = {
table = {
model = 'prop_offroad_barrel01', -- Z - 0.43
coords = vector4(481.991669, -1320.114014, 28.217533, 0.000000), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(481.989258, -1320.155762, 29.091951, 179.905853), -- position where the laptop will be spawned
}
}
},
[3] = {
name = "Little Bighorn Avenue",
coords = vector4(720.16, -1054.62, 21.95, 87.11),
radius = 10.0,
type = "warehouse",
security = "low",
vinscratch = {
table = {
model = 'prop_offroad_barrel01', -- Z - 0.43
coords = vector4(732.047302, -1084.606079, 21.183907, 0.000000), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(732.031250, -1084.559082, 22.058325, 342.426270), -- position where the laptop will be spawned
}
}
},
-- you can add as much locations as you want
}
-- ====================================
-- CHOP SHOP SETTINGS
-- ====================================
Config.ChopShopsLocations = {
[1] = {
name = "LS Customs Chop Shop",
vehcoords = vector4(-550.73, -1705.93, 18.97, 25.41), -- position where the vehicle shall be left by the player
vehradius = 5.0, -- radius of the area where the vehicle will be left,
vinscratch = {
table = {
model = 'prop_offroad_barrel01',
coords = vector4(-223.369370, -1332.942871, 29.434663, 0.00000), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(-223.396698, -1332.997314, 30.753469, 150.361984), -- position where the laptop will be spawned
}
}
},
[2] = {
name = "Sandy Shores Airfield",
vehcoords = vector4(1732.98, 3304.22, 41.22, 10.15), -- position where the vehicle shall be left by the player
vehradius = 5.0, -- radius of the area where the vehicle will be left,
vinscratch = {
table = {
model = 'prop_offroad_barrel01',
coords = vector4(1727.050049, 3304.714355, 40.238388, 0.000000), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(1726.989258, 3304.731689, 41.112808, 68.556763), -- position where the laptop will be spawned
}
}
},
[3] = {
name = "Supply Station",
vehcoords = vector4(825.05, -786.55, 26.19, 90.78), -- position where the vehicle shall be left by the player
vehradius = 5.0, -- radius of the area where the vehicle will be left,
vinscratch = {
table = {
model = 'prop_offroad_barrel01',
coords = vector4(821.799194, -788.678223, 25.210924, 359.946045), -- position where the vehicle VIN will be scratched
},
laptop = {
model = 'bkr_prop_clubhouse_laptop_01a',
coords = vector4(821.738953, -788.685486, 26.082520, 136.698181), -- position where the laptop will be spawned
}
}
},
-- you can add as much locations as you want
}
-- ====================================
-- MARKET ITEMS
-- ====================================
Config.Market = {
{
name = 'boos_lockpick',
label = 'Auto Jiggler',
image = 'nui://'..Config.UI.img..'boos_lockpick.png',
price = 1000,
amount = 50,
rarity = 1,
info = {},
},
{
name = 'boos_hacktool',
label = 'EMF Disruptor',
image = 'nui://'..Config.UI.img..'boos_hacktool.png',
price = 1000,
amount = 50,
rarity = 2,
info = {},
},
{
name = 'boos_scanner',
label = 'KFB Scanner',
image = 'nui://'..Config.UI.img..'boos_scanner.png',
price = 1000,
amount = 50,
rarity = 3,
info = {},
},
}
-- ====================================
-- ORDERS
-- ====================================
Config.Orders = {
box = true, -- give items in a box
item = 'boos_box', -- box item name, in case box is enabled
duration = {
min = 5, -- minutes
max = 10 -- minutes
},
pickup = {
{
coords = vector(-44.904587, -1744.754517, 29.247716, 140.211685),
address = 'LS Customs Chop Shop',
prop = 'prop_packstation',
},
}
}
-- ====================================
-- VEHICLES WITH CLASS
-- ====================================
Config.Vehicles = {
["D"] = {
{
label = 'Blista',
model = 'blista',
image = 'https://docs.fivem.net/vehicles/blista.webp',
},
{
label = 'Issi Classic',
model = 'issi2',
image = 'https://docs.fivem.net/vehicles/issi2.webp',
},
{
label = 'Panto',
model = 'panto',
image = 'https://docs.fivem.net/vehicles/panto.webp',
},
{
label = 'Rhapsody',
model = 'rhapsody',
image = 'https://docs.fivem.net/vehicles/rhapsody.webp',
},
{
label = 'BF Injection',
model = 'bfinjection',
image = 'https://docs.fivem.net/vehicles/bfinjection.webp',
},
},
["C"] = {
{
label = 'Dominator',
model = 'dominator',
image = 'https://docs.fivem.net/vehicles/dominator.webp',
},
{
label = 'Phoenix',
model = 'phoenix',
image = 'https://docs.fivem.net/vehicles/phoenix.webp',
},
{
label = 'Sabre Turbo',
model = 'sabregt',
image = 'https://docs.fivem.net/vehicles/sabregt.webp',
},
{
label = 'Gauntlet',
model = 'gauntlet',
image = 'https://docs.fivem.net/vehicles/gauntlet.webp',
},
{
label = 'Buffalo',
model = 'buffalo',
image = 'https://docs.fivem.net/vehicles/buffalo.webp',
},
{
label = 'Fugitive',
model = 'fugitive',
image = 'https://docs.fivem.net/vehicles/fugitive.webp',
},
{
label = 'Schafter',
model = 'schafter2',
image = 'https://docs.fivem.net/vehicles/schafter2.webp',
}
},
["B"] = {
{
label= 'Elegy Retro Custom',
model= 'elegy',
image= 'https://docs.fivem.net/vehicles/elegy.webp',
},
{
label= 'Sultan RS',
model= 'sultanrs',
image= 'https://docs.fivem.net/vehicles/sultanrs.webp',
},
{
label= 'Futo',
model= 'futo',
image= 'https://docs.fivem.net/vehicles/futo.webp',
},
{
label= 'Blista Kanjo',
model= 'kanjo',
image= 'https://docs.fivem.net/vehicles/kanjo.webp',
},
{
label= 'Penumbra FF',
model= 'penumbra2',
image= 'https://docs.fivem.net/vehicles/penumbra2.webp',
},
{
label= 'Cypher',
model= 'cypher',
image= 'https://docs.fivem.net/vehicles/cypher.webp',
},
{
label= 'Remus',
model= 'remus',
image= 'https://docs.fivem.net/vehicles/remus.webp',
}
},
["A"] = {
{
label= 'Elegy RH8',
model= 'elegy2',
image= 'https://docs.fivem.net/vehicles/elegy2.webp',
},
{
label= 'Jester',
model= 'jester',
image= 'https://docs.fivem.net/vehicles/jester.webp',
},
{
label= 'Massacro',
model= 'massacro',
image= 'https://docs.fivem.net/vehicles/massacro.webp',
},
{
label= 'Comet SR',
model= 'comet5',
image= 'https://docs.fivem.net/vehicles/comet5.webp',
},
{
label= 'Specter',
model= 'specter',
image= 'https://docs.fivem.net/vehicles/specter.webp',
},
{
label= 'Feltzer',
model= 'feltzer2',
image= 'https://docs.fivem.net/vehicles/feltzer2.webp',
},
{
label= 'Carbonizzare',
model= 'carbonizzare',
image= 'https://docs.fivem.net/vehicles/carbonizzare.webp',
}
},
["S"] = {
{
label= 'Entity XF',
model= 'entityxf',
image= 'https://docs.fivem.net/vehicles/entityxf.webp',
},
{
label= 'Turismo R',
model= 'turismor',
image= 'https://docs.fivem.net/vehicles/turismor.webp',
},
{
label= 'Osiris',
model= 'osiris',
image= 'https://docs.fivem.net/vehicles/osiris.webp',
},
{
label= 'RE-7B',
model= 'le7b',
image= 'https://docs.fivem.net/vehicles/le7b.webp',
},
{
label= 'Autarch',
model= 'autarch',
image= 'https://docs.fivem.net/vehicles/autarch.webp',
},
{
label= 'GP1',
model= 'gp1',
image= 'https://docs.fivem.net/vehicles/gp1.webp',
},
{
label= 'Tempesta',
model= 'tempesta',
image= 'https://docs.fivem.net/vehicles/tempesta.webp',
}
},
["S_PLUS"] = {
{
label= 'Krieger',
model= 'krieger',
image= 'https://docs.fivem.net/vehicles/krieger.webp',
},
{
label= 'Emerus',
model= 'emerus',
image= 'https://docs.fivem.net/vehicles/emerus.webp',
},
{
label= 'Zentorno',
model= 'zentorno',
image= 'https://docs.fivem.net/vehicles/zentorno.webp',
},
{
label= 'X80 Proto',
model= 'prototipo',
image= 'https://docs.fivem.net/vehicles/prototipo.webp',
},
{
label= 'T20',
model= 't20',
image= 'https://docs.fivem.net/vehicles/t20.webp',
},
{
label= 'Vagner',
model= 'vagner',
image= 'https://docs.fivem.net/vehicles/vagner.webp',
},
{
label= 'Adder',
model= 'adder',
image= 'https://docs.fivem.net/vehicles/adder.webp',
}
}
}
-- ====================================
-- DEFAULT THEME
-- ====================================
Config.Theme = {
['theme'] = {
primaryColor = '#57ffc7',
secondaryColor = '#00d4ff',
accentColor = '#5cf6ee',
buttonPrimary = '#57ffc7',
buttonSecondary = '#00d4ff',
buttonAccent = '#5cf6ee',
buttonView = '#57ffc7',
buttonAccept = '#57ffc7',
buttonAddToCart = '#57ffc7',
buttonPurchase = '#57ffc7',
avatarGradientStart = '#57ffc7',
avatarGradientEnd = '#00d4ff',
backgroundColor = '#0c0f11',
glassOpacity = 0.1,
blurIntensity = 0,
animations = true
}
}Last updated