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

  1. Boot banner: the server console shows the SUTY WHEELTHEFT banner with the version and Loaded, then [suty-wheeltheft] framework: <name>.
  2. Items: car_jack, impact_drill and wheel show their images and can be used.
  3. Jack: use car_jack and Place jack on an empty car with the engine off. The car goes up.
  4. Theft: Loosen lug nuts, Take wheel off, Place block, Lower jack. The car rests on the block.
  5. Carry: pick up the wheel. G sets it down, H stores it as a wheel item.
  6. 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)

Merry Christmas.

From Suty.