Carwipe
Troubleshooting
Troubleshooting
Common issues
| Symptom | Fix |
|---|---|
| The resource doesn't run and no banner shows | The folder was renamed. Rename it back to exactly suty-carwipe. |
Errors about ox_lib or MySQL on start |
oxmysql and ox_lib must be started before suty-carwipe in server.cfg. |
/carwipe doesn't exist |
ox_lib isn't running, or you renamed the command with Config.Command. |
| Admins get No tienes permisos para esto. | They don't pass any permission check. Grant the ACE (add_ace group.admin group.admin allow, see Installation) or add their QBCore / ESX group to Config.AdminGroups. |
| Admins pass on QB-Core but not on QBX | qbx_core's QBCore layer is turned off on your server. Grant the ACE instead. |
| The commands don't show in chat suggestions for admins | Config.PermissionMode = 'ace' hides them from anyone without the ACE. Grant it, or use 'auto'. |
You changed config.lua but the design, colours, position, interval or automatic mode didn't change |
An admin changed it in the panel before, and the saved value wins. Change it in /carwipepanel, or run DELETE FROM suty_carwipe; and restart. |
| Automatic carwipes never happen | The automatic mode is off in the panel or in Config.AutoCarwipe. The server console says which one is active on start. |
| Automatic carwipe runs at odd times | The timer restarts when the resource starts and when the interval is changed in the panel. |
| A trailer (or another model) keeps disappearing | Add its spawn name to Config.WhitelistedVehicles. |
| Dealership showroom cars get removed | Add their plate to Config.WhitelistedPlates ('DEALER' for jg-dealerships). |
| A player's car disappeared while they stood next to it | Only the vehicle a player is sitting in is kept. Get in before the countdown ends. |
| The countdown card shows in the wrong place | A position was dragged in the panel. Open REPOSITION and press RESET to go back to Config.UI.position. |
| The footer text doesn't change with the design | You changed Config.UI.texts.footer. A custom footer shows on every design; put the default text back to get the per-design footers. |
| Panel saves don't survive a restart | oxmysql isn't connected, or the database user can't create tables. Check the server console on start. |
"Vehicles removed" shows 0 after a wipe |
No empty vehicle was near any player when the timer ended. |
Verifying the install
Run these checks in order on a clean restart:
- Boot banner — the SUTY CARWIPE banner with
Version: 1.2.5appears in the server console. - Database — the console prints
[Carwipe] Automatic carwipe enabled…(or…is disabled) and the design in use. - Command — as an admin,
/carwipe 15shows the countdown to every player. - Cleanup — spawn an empty car next to you and let the countdown end. The car disappears; the one you sit in stays.
- Panel —
/carwipepanelopens with the live status;Esccloses it.
Reporting a bug
If something is still broken after the checks above, open a ticket in our Discord with:
- Your framework (QBX, QB-Core, ESX or standalone) and server artifact
- Your
config.lua - The lines suty-carwipe prints in the server console on start
- What you did, what you expected and what happened
