Wheel Theft
Configuration
Configuration
Files you can edit
| File | What is in it |
|---|---|
config.lua |
Every gameplay setting on this page |
server/sv_config.lua |
Discord log settings. Server-only: never sent to players |
locales/*.lua |
Every text players see, in 9 languages |
These files are not encrypted. Restart the resource after editing them.
Framework
Config.Framework = 'auto' -- 'auto' | 'qbx' | 'qb' | 'esx'
auto looks for qbx_core, then qb-core, then es_extended. Qbox is checked first because it also provides qb-core.
Language
Config.Locale = 'es'
Config.LocaleOverrides = {}
| Option | Default | What it changes |
|---|---|---|
Config.Locale |
'es' |
Language of notifications, eye options, progress bars and the minigame: es, en, pt (Brazil), fr, de, it, nl, pl, tr |
Config.LocaleOverrides |
{} |
Replace single texts without editing the locale files, for example { target_jack = 'Poner gato', notify_title_wheel = 'Taller' } |
To add a language: copy locales/en.lua to locales/<code>.lua, change Locales['en'] to Locales['<code>'], translate the texts (keep every %s / %d / %.1f in the same order) and set the code in Config.Locale. Missing keys fall back to English.
Carry keys
Config.Keys = {
place = 'G', -- set it down where you aim
store = 'H', -- put it in your inventory
}
Default keys while carrying a wheel or the jack. Players can rebind them in GTA Settings → Key Bindings → FiveM («Wheel / jack: set down» and «Wheel / jack: put in inventory»).
Cinematic camera
Config.CinematicCam = {
enabled = true,
blendMs = 1200,
shake = 0.12,
dof = true,
}
| Option | Default | What it changes |
|---|---|---|
enabled |
true |
Films each step's animation with a scripted camera |
blendMs |
1200 |
Milliseconds to blend from / back to the normal camera |
shake |
0.12 |
Light handheld float. 0 = perfectly still |
dof |
true |
Depth of field: the player sharp, the background soft |
Loose wheels
A wheel lowered with its lug nuts still loose makes the car drive badly until they are tightened with the impact drill: it pulls to that side, the steering shimmies, the wheel wobbles and the car vibrates, more the faster it goes.
Config.LooseWheel = {
enabled = true,
pull = 0.12,
shimmy = 0.10,
wobble = 0.015,
shake = 0.25,
}
| Option | Default | What it changes |
|---|---|---|
enabled |
true |
Turns the effect on or off |
pull |
0.12 |
Steering pull towards the loose wheel's side (0–1) |
shimmy |
0.10 |
Random steering shimmy at speed (0–1) |
wobble |
0.015 |
How far the wheel rocks on its studs, in metres |
shake |
0.25 |
Vibration at speed. 0 = off |
Wheel minigame (optional)
Off by default: loosening the lug nuts plays the impact-drill animation. On, the minigame replaces that animation when stealing, and the wheel only comes loose if the player wins.
Config.WheelMinigame = {
enabled = false,
boltCount = 5,
boltMs = 2200,
aimTolerance = 16,
drift = 3,
volume = 0.16,
cameraEnterMs = 1200,
cameraExitMs = 700,
uiFadeMs = 250,
maxDistance = 3.0,
timeoutMs = 90000,
models = {},
}
| Option | Default | What it changes |
|---|---|---|
enabled |
false |
Use the minigame instead of the loosening animation |
boltCount |
5 |
Lug nuts per wheel |
boltMs |
2200 |
Drill time per nut (five nuts take at least 11 seconds) |
aimTolerance |
16 |
Aim tolerance in pixels at 1080p (scales with resolution) |
drift |
3 |
Drill vibration in pixels at 1080p |
volume |
0.16 |
Impact sound volume. 0 = silent |
cameraEnterMs / cameraExitMs |
1200 / 700 |
Camera ease in and out, in milliseconds |
uiFadeMs |
250 |
Interface fade on exit. 0 = no fade |
maxDistance |
3.0 |
The minigame closes if the player gets farther than this from the wheel, in metres |
timeoutMs |
90000 |
The minigame closes without loosening the wheel after this many milliseconds |
models |
{} |
Optional exact bolt layouts per vehicle model, then per rim, then per wheel index (0–3). The commented example in config.lua shows the format |
Wheel theft
Config.WheelTheft = {
enabled = true,
item = 'impact_drill',
rewardItem = 'wheel',
breakChanceOnSuccess = 0,
breakChanceOnFail = 0,
cooldownPerWheelSec = 30,
groundDespawnSec = 300,
drillProp = 'imp_prop_impact_driver_01a',
requireEngineOff = true,
requireNoOccupants = true,
targetDistance = 1.6,
}
| Option | Default | What it changes |
|---|---|---|
enabled |
true |
Master switch for the whole theft system |
item |
'impact_drill' |
Item needed to loosen and tighten lug nuts |
rewardItem |
'wheel' |
Item a removed wheel becomes when it goes into a trunk or the inventory |
breakChanceOnSuccess |
0 |
Chance (%) the drill breaks when a wheel is stolen. 0 = never, 100 = always |
breakChanceOnFail |
0 |
Chance (%) the drill breaks when loosening fails |
cooldownPerWheelSec |
30 |
Seconds before the same player can take the same wheel off again |
groundDespawnSec |
300 |
Seconds a wheel or jack left on the ground stays before it disappears (and is lost). 0 = never |
drillProp |
'imp_prop_impact_driver_01a' |
Drill prop held during the optional minigame |
requireEngineOff |
true |
The car's engine must be off for any step |
requireNoOccupants |
true |
Nobody may be inside the car for any step |
targetDistance |
1.6 |
Eye (ox_target) range in metres |
Mechanic
Putting wheels back on a car (and taking its blocks away) is the mechanic's side. Taking wheels off stays open to anyone with the tools.
Config.Mechanic = {
jobs = { 'mechanic' },
mountItem = 'wheel',
}
| Option | Default | What it changes |
|---|---|---|
jobs |
{ 'mechanic' } |
Jobs allowed to put wheels on and remove blocks. Add as many as you need, or set false to allow everyone |
mountItem |
'wheel' |
Item used up when a wheel is put on a car (the same item a stolen wheel becomes) |
The job is checked by name, on QBX, QB-Core and ESX.
Discord logs (server/sv_config.lua)
SvConfig.Discord = {
enabled = false,
webhook = 'YOUR_DISCORD_WEBHOOK_URL',
botName = 'Chop Shop Logs',
botAvatar = '',
}
| Option | Default | What it changes |
|---|---|---|
enabled |
false |
Sends one log for every stolen wheel |
webhook |
'' |
Your Discord webhook URL |
botName |
'Chop Shop Logs' |
Name shown on the log messages |
botAvatar |
'' |
Avatar image URL. Empty = Discord's default |
server/sv_config.lua only runs on the server and is never sent to players. Keep your webhook there, and don't share it when you send the resource to someone.
Quick reference
| Want to… | Set |
|---|---|
| Disable wheel theft temporarily | Config.WheelTheft.enabled = false |
| Let anyone put wheels back | Config.Mechanic.jobs = false |
| Add another mechanic job | Config.Mechanic.jobs = { 'mechanic', 'bennys' } |
| Make drills break sometimes | Config.WheelTheft.breakChanceOnSuccess = 10 |
| Keep dropped wheels forever | Config.WheelTheft.groundDespawnSec = 0 |
| Use the drill minigame | Config.WheelMinigame.enabled = true |
| No cinematic camera | Config.CinematicCam.enabled = false |
| Switch to English | Config.Locale = 'en' |
| Log stolen wheels to Discord | SvConfig.Discord.enabled = true + your webhook |
