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

Merry Christmas.

From Suty.