🛞 Wheel Clamper FiveM Script – Advanced Clamping System

Multi-Framework & Multi-UI Compatibility

PL Wheel Clamper supports ESX, QBCore, and QBox out of the box with automatic framework detection. No manual configuration is required in most cases. On the UI side, every interactive element — context menus, input dialogs, alert dialogs, and progress bars — can be configured independently, with support for ox_lib and lation_ui. Notifications support seven different backends, meaning the script will fit into virtually any server's existing setup without requiring additional resources.

Target System & Command Fallback

The script integrates with ox_target and qb-target to place interactive zones directly on clamped vehicles. Officers and players can interact with clamps through proximity-based target options without using any commands. For servers that prefer a cleaner setup without target systems, a command-based mode is available — simply toggle DisableTarget in the config and all interactions switch to configurable commands.

Police Clamping System

Only players assigned to configured police jobs can place wheel clamps. When an officer uses the wheel_clamper item, the script verifies proximity to the vehicle's left front tire, checks that the vehicle is registered to a player (not an NPC), confirms it is not already clamped, and ensures it is not on the disallowed vehicles list. The officer is then prompted to enter a custom fine amount (minimum $100). A placement animation plays, the clamp prop attaches to the wheel, the vehicle is frozen in place, and the record is saved to the database — all synced to every player on the server in real time.

Fine Payment & Automatic Release

Vehicle owners can pay their fine directly from inside their vehicle using the target zone on the clamp. The script retrieves the fine amount from the database (never from the client), verifies the player owns the vehicle, and checks their bank balance before presenting a confirmation dialog. On confirmation, the fine is deducted from their bank, the clamp is immediately removed from the vehicle, the vehicle is unfrozen, and the database record is cleared — all without requiring an officer to be present.

Society & Treasury Integration

When enabled, all fine payments are routed to the configured police society or faction fund rather than disappearing from the economy. This integrates with addon_account, qb-management, and qb-banking, keeping server-side economics consistent and ensuring enforcement actions have a meaningful revenue loop.

Civilian Clamp Cutting

Players who own a clamped vehicle and possess the wheel_clamp_cutter item can remove the clamp themselves without paying the fine. This triggers a removal animation, deletes the clamp from the world, unfreezes the vehicle, and consumes the cutter item. When a clamp is cut, a configurable dispatch alert is sent to online officers, supporting ps-dispatch, qb-dispatch, aty_dispatch, rcore_dispatch, cd_dispatch, op-dispatch, and a custom hook option.

Garage & Persistence System

Clamp records are stored in the database with the vehicle's plate, meaning they survive server restarts and garage storage events. When a clamped vehicle is stored in a garage, the visual clamp object is removed from the world but the database record is kept. When the vehicle is spawned again, the clamp is automatically reapplied. This is handled through server exports that garage scripts can hook into on vehicle spawn and storage events.

Clamp Prop & Visual Positioning

The script uses a dedicated custom clamp model (pl_wheelclamper_prop01) loaded from the companion asset resource. Attachment offsets are fully configurable with a layered system — a global default applies to all vehicles, with optional overrides per vehicle model, per vehicle class, and per bone. This allows precise visual placement across any vehicle type in your server's catalogue.

Item System & Inventory Compatibility

Two items drive the clamping system: wheel_clamper for officers and wheel_clamp_cutter for civilians. Both items auto-register with the detected framework on startup. The script supports ox_inventory and both legacy and modern versions of qb-inventory, with install templates provided for each. Items are consumed on use and returned to officers after a successful clamp removal.

Police Clamp Management

Officers have access to a clampedvehicles command that opens a context menu listing every currently clamped vehicle on the server. Each entry displays the vehicle plate, registered owner name, fine amount, and the name of the officer who placed the clamp — giving law enforcement full visibility into active clamps at any time.

Logging & Monitoring

All key actions are sent to a configurable Discord webhook: clamp placed (officer name, plate, owner, fine), clamp removed by officer, and fine paid by player. A debug mode is available for development and troubleshooting, enabling console prints for framework detection, job verification, and database queries, as well as visual overlays showing active target zones.

Server Exports API

External scripts can interact with the clamping system through a set of server-side exports: check if a vehicle is clamped by plate, add a clamp externally with a custom fine and officer name, remove a clamp by plate, and trigger the garage spawn/store hooks. This makes the script fully composable with impound systems, admin tools, or any custom enforcement workflow.