Wheel Theft
Troubleshooting
Troubleshooting
Console messages
| Message | Fix |
|---|---|
FATAL: resource must be named "suty-wheeltheft" |
You renamed the folder. Rename it back to exactly suty-wheeltheft. |
qbx_core, qb-core or es_extended not found; wheel theft will not work |
No framework is running, or it starts much later. Start your framework before suty-wheeltheft. |
Config.Framework = '…' but … is not started |
You forced a framework that isn't running. Use 'auto' or the one you actually run. |
Config.Framework = '…' is not valid |
Use 'auto', 'qbx', 'qb' or 'esx'. |
No such export when using an item |
Check the folder name, that suty-wheeltheft started without errors, and that you did a full server restart after changing the item entries. |
Common issues
Messages are quoted from the English locale. With the default Config.Locale = 'es', players see the same text in Spanish.
| Symptom | Fix |
|---|---|
| No eye options on the wheels | ox_target must be running (it's required), and Config.WheelTheft.enabled = true. Stand next to the wheel, within Config.WheelTheft.targetDistance. |
Using car_jack / impact_drill / wheel does nothing |
The item entry needs its client.export (suty-wheeltheft.useCarJack, .useImpactDrill, .useWheel) and consume = 0. Restart the whole server after editing items.lua. |
| «The car must be off, stopped and empty.» | The anti-grief gates are on: turn the engine off and get everyone out, or change requireEngineOff / requireNoOccupants. |
| «You need an impact drill.» | The player has no Config.WheelTheft.item (default impact_drill) in the inventory. |
| «Only a mechanic can do this.» | Remove block and Put wheel on are limited to Config.Mechanic.jobs. Add the job, or set it to false for everyone. |
| «Wait a moment before taking this wheel off again.» | The per-wheel cooldown (cooldownPerWheelSec, 30 s by default). |
| «Someone is already working on this car.» | Another player is in the middle of a step on that car. Wait for them to finish. |
| «There is no lifting point at jack height here.» / «There is no suitable ground here for the jack.» | Move the car to flat, open ground. Some vehicles have no lifting point at jack height under every corner. |
| «That wheel is flat; it cannot go back on.» | A flat wheel can't be refitted. Use a good wheel. |
| «The lug nuts are still loose…» and the car drives badly | The wheel was lowered with loose nuts. Jack it up (or stay on the ground) and Tighten lug nuts with the drill. |
| «The trunk is locked.» / «The trunk is full.» | Unlock the car, or free some trunk space. |
| A wheel or jack on the ground disappeared | Items on the ground are removed after groundDespawnSec (300 s by default). Set 0 to keep them. |
| A drill broke | breakChanceOnSuccess / breakChanceOnFail are above 0, or ox_inventory's degrade wore it out. |
| The minigame never shows | It's off by default: Config.WheelMinigame.enabled = true. |
| Item images don't show | Copy the three PNGs from install/ox_inventory/images/ to ox_inventory/web/images/. |
| Discord logs don't arrive | SvConfig.Discord.enabled = true and a valid webhook in server/sv_config.lua. |
| A car is stuck on blocks / half done | An admin can stand next to it and run /wtreset (removes jacks and blocks, puts the wheels back). /wtestado prints its state in F8. |
Old torque_wrench items do nothing |
The drill is now impact_drill. Rename the item and set its export to suty-wheeltheft.useImpactDrill. |
Verifying the install
- Boot banner: the server console shows the SUTY WHEELTHEFT banner with the version and
Loaded, then[suty-wheeltheft] framework: <name>. - Items:
car_jack,impact_drillandwheelshow their images and can be used. - Jack: use
car_jackand Place jack on an empty car with the engine off. The car goes up. - Theft: Loosen lug nuts, Take wheel off, Place block, Lower jack. The car rests on the block.
- Carry: pick up the wheel. G sets it down, H stores it as a
wheelitem. - Mechanic: with a job from
Config.Mechanic.jobs, do the way back and drive off.
Reporting a bug
Open a ticket on Discord with:
- Your framework and its version, plus your ox_inventory and ox_target versions
- The full F8 / server console error
- The vehicle model and the step where it failed
- Your
config.lua(never send your webhook)
