Common Issues
Checks for fitting, removing, payments, saving, alerts, and installs.
#Resource Does Not Start
zyke_wheelclamp needs oxmysql, zyke_lib and zyke_wheelclamp_assets under those exact names, in the start order. Restarting zyke_wheelclamp_assets while clamps are out can crash clients; restart zyke_wheelclamp instead.
#Clamp Item Does Nothing
"This item is not a usable wheelclamp." means the item name is missing from clamps. Use the item on foot, and on ox_inventory leave consume unset. "This wheelclamp is damaged and can not be fitted." means a ground-off clamp, which is scrap.
#Clamp Will Not Fit a Wheel
Only the four corner wheels within aimDistance are marked, and the vehicle must be at or below maxVehicleSpeedKmh. "This vehicle type can not be clamped." comes from blockedClasses, "This tyre is burst, so a wheelclamp can not grip it." from a flat tyre, "This wheel already has a wheelclamp." from an occupied wheel, and "There is no vehicle close enough." also from client-only vehicles. "You don't have permission to do this." comes from jobRequirements.install or the can-check hooks, "You need more inventory space." means no room for the key, and "You or the vehicle moved, so the wheelclamp action was cancelled." keeps the item.
#Windscreen Clamp Will Not Fit
"This vehicle has no intact windscreen to fit the clamp on." means broken glass, "The clamp does not fit this vehicle's windscreen." a model without one, and "The windscreen is too high to reach from the ground." a tall cab. Motorcycles never take one. "The release code must be digits only and the right length." refers to windscreen.codeLength.
#Remove Wheelclamp Option Is Missing
It only shows to players carrying that clamp's key, and to officers on officer.jobs while officer.override is on, on duty if onDutyOnly is set. Check targetRemoval, jobRequirements.remove and CanDisplayWheelclampRemove in client/unlocked/can_checks.lua. Windscreen clamps have no key; use their keypad.
#Clamp Key Does Nothing
On QBCore, clamp_key isn't usable; use "Remove wheelclamp" while carrying it. "You don't have the matching wheelclamp key." means the key belongs to the clamp named in its description. Each key is used up on removal, and the returned clamp needs room, or "You need more inventory space." shows.
#Lockpicking or Grinding Does Not Start
"There is no clamped vehicle close enough." means stand next to the clamp. Check lockpicking.items, grinding.enabled and jobRequirements; Lockpick also needs its tension wrench and pick, or set lockpicking.minigame = "skillcheck". A missing "Cut Clamp" point with [zyke_wheelclamp] zyke_anglegrinder refused the clamp grinding action, update it to 0.3.2 or newer in the client console needs a newer zyke_anglegrinder; windscreen clamps can't be lockpicked or ground.
#Pay Button Is Missing
Wheel clamps need notice.enabled and notice.allowPayment, and windscreen clamps windscreen.allowPayment. While sd-phone, lb-phone, yseries, yphone or yflip-phone runs with phone.allowPayment on, fees are paid only in the app; refused the clamp phone app in the client console means the phone rejected it, so fix the phone or set phone.allowPayment = false.
#Payment Fails
"Your hands are full. Put down the clamp you are carrying first." means press X or Shift + X first. "You can't afford the release fee." means the account, bank by default, is short.
#Release Fees Do Not Reach the Society
[zyke_wheelclamp] Could not pay 500 into the society account 'police'. Check the society setting in config.lua means notice.society or windscreen.society doesn't match your banking resource; ESX retries a plain job name as society_<job>. Route fees elsewhere in PayClampSociety in server/unlocked/notice.lua. The clamp still comes off.
#Clamps Disappear After a Garage or Restart
Only owned vehicles keep their clamps once deleted. Garages other than zyke_garages and qbx_garages need the Vehicle Properties changes, which restore clamps only when the owner takes the vehicle out. Can not persist owned clamps: ... was not found means no plate column in owned_vehicles (ESX) or player_vehicles (QBCore).
#Target Options Do Not Appear
With interaction = "target", start ox_target or qb-target first. Otherwise the client console prints [zyke_wheelclamp] interaction is set to "target" but neither ox_target nor qb-target is started, using interaction points.
#Clamped Vehicle Still Drives
"wheel" lets the vehicle bump along until the tyre bursts after wheelBurstDistance metres and drops the clamp, and "none" only shows the prop. Use immobilization = "freeze". A windscreen clamp alone never holds the vehicle, and its beep needs zyke_sounds 0.7.0 or newer.
#Police Do Not Get Alerts
Check policeAlert.enabled, the alert's chance, and that police are on duty while onDutyOnly is on. Lockpick alerts need an NPC witness unless witnesses.enabled = false, and each vehicle raises the same alert once per cooldownSeconds. For your own dispatch, check OnWheelclampAlert in server/unlocked/police_alert.lua.
#Nobody Is Available to Help Right Now
An assistance request needs a player on phone.assistance.jobs, on duty with onDutyOnly, or the clamp's fitter online with notifyFitter. Check CanRespondToClampAssistance in server/unlocked/can_checks.lua.
#Website or Supply Ped Is Missing
The LS Parking Authority site needs zyke_laptop and laptop.site.enabled. "You need to be on duty to use the supplier." comes from the ped's onDutyOnly, and Failed to load vendor model means its model is invalid.