FreeScriptQBCoreESXStandalone
cuff
by Bert5580 · version 2025.10.16 · updated 2 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 17 KB
- Code check
- Clean
- Licence
- GPL-3.0
- Released
- Nov 2026
A lightweight, FX-standalone self-cuff script for FiveM that lets a player cuff and uncuff themselves via commands. No ESX / QBCore / MySQL required.
cuff (Standalone)
A lightweight, FX-standalone self-cuff script for FiveM that lets a player cuff and uncuff themselves via commands.
No ESX / QBCore / MySQL required.
Features
Key options:
Events
MIT (see
A lightweight, FX-standalone self-cuff script for FiveM that lets a player cuff and uncuff themselves via commands.
No ESX / QBCore / MySQL required.
Features
/cuffmeto cuff yourself (toggling allowed via config)/uncuffmeto remove cuffs (or toggle via/cuffmeagain)- Smooth animation loop with automatic dictionary loading & safe timeouts
- Disables combat, aiming, weapon usage, enter vehicles, sprint/jump while cuffed
- Applies Rockstar handcuff flag so other players see the correct stance
- Network sync broadcast so nearby clients see your cuffed state reliably
- Robust cleanup on resource stop and player drop
- Export for other resources:
exports.cuff:IsSelfCuffed(playerId)
- Drop the
cufffolder into your server'sresources/directory. - Add
ensure cuffto your server.cfg after your dependencies. - (Optional) Edit
config.luato adjust commands, behaviour, and animation.
- /cuffme — Cuff yourself (or toggle on/off if
Config.ToggleOnSingleCommand = true). - /uncuffme — Uncuff yourself (always available, even if toggle is enabled).
Both commands can be renamed in config.lua.
**Configuration (config.lua)**Key options:
ToggleOnSingleCommand— enable/cuffmeto toggle on/off.AnimDict,AnimName— animation dictionary & clip used while cuffed.AnimFlags— task flags (use 49 to loop upper body, 16 for normal repeat, etc.).AnimLoadTimeoutMs— how long to wait for the dict to load before aborting.DisableControls— list of control actions disabled while cuffed.CooldownMs— anti-spam delay between command uses.AutoUncuffOnDeath— automatically uncuff on death/respawn.
-- Returns boolean: whether the local player is cuffed (client-side)
exports('IsSelfCuffed', function() return LocalPlayer.state.isCuffed or false end)Events
cuff:server:syncState (playerId, isCuffed)— server broadcast for cuff state.cuff:client:setState (serverId, isCuffed)— client receives & applies visuals.
- This resource intentionally removes all ESX/QBCore and MySQL usage.
- If you are migrating from older ESX-based versions, remove any DB tables related to this script; they are no longer used.
MIT (see
LICENSE.md if provided).