Installation

Installation Steps

Download the latest release from the FiveM Portal
Extract wlabs_handcuff into your resources folder
Add items to your inventory system:

Inventory Items

Add to ox_inventory/data/items.lua:

['handcuffs'] = {
    label = 'Handcuffs',
    weight = 250,
    stack = true,
    close = true,
},
['handcuff_key'] = {
    label = 'Handcuff Key',
    weight = 50,
    stack = true,
    close = true,
},
['cable_ties'] = {
    label = 'Cable Ties',
    weight = 100,
    stack = true,
    close = true,
},
['lockpick'] = {
    label = 'Lockpick',
    weight = 50,
    stack = true,
    close = true,
},

Configure the script by editing shared/config.lua
Add to your server.cfg (adjust to your setup):

ensure ox_lib
ensure qb-core         # or es_extended
ensure ox_inventory    # or qb-inventory
ensure ox_target       # optional
ensure wlabs_handcuff

Configuration

Auto-Detection

By default, the script automatically detects:

Framework (qbx_core, qb-core, es_extended)
Inventory (ox_inventory, qb-inventory)
Target System (ox_target, qb-target)

Force a Specific System

To force a specific system, edit shared/config.lua:

Config.Framework = 'qb'     -- 'auto', 'esx', 'qb', 'qbox', 'none', 'custom'
Config.Inventory = 'ox'     -- 'auto', 'ox', 'qb', 'none', 'custom'
Config.Target = 'ox'        -- 'auto', 'ox', 'qb', 'none', 'custom'

Disable Integrations

You can disable specific integrations if you do not use them:

Config.Framework = 'none'   -- disables framework job checks
Config.Inventory = 'none'   -- disables inventory checks (items always pass)
Config.Target = 'none'      -- disables target registration

Allowed Jobs

Configure which jobs can use the handcuff system:

Config.AllowedJobs = {
    ['police'] = 0,     -- police job, grade 0+
    ['sheriff'] = 0,    -- sheriff job, grade 0+
    ['ambulance'] = 2,  -- ambulance job, grade 2+
}

Locale

The script supports multiple languages via locales/*.json. To change the language:

setr ox:locale en   # English (default)
setr ox:locale de   # German

Support

For support, join our Discord: discord.gg/ykEhStZjau

Credits

Credits to FloatStreak for the Cable Ties prop:

https://www.gta5-mods.com/misc/new-handcuffs-cable-Ties

On this page