> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_crime.md).

# ak47\_crime

The ultimate crime and restraint experience for FiveM servers.

{% embed url="<https://youtu.be/-v1-0nHFK_Q>" %}

Elevate your server's criminal and law enforcement roleplay with advanced restraint mechanics including soft and hard cuffing, rope tying, blindfolding, and suspect dragging. Featuring an immersive full-screen blindfold NUI overlay, a tension-based robbery minigame, dynamic vehicle trunk mechanics, and persistent handcuffs that remain intact across player reconnects. Powered by `ak47_lib` for seamless plug-and-play compatibility with ESX, QBCore, and QBX frameworks.

***

### 🔥 Key Features

Designed to improve roleplay immersion and economy balancing:

#### 🔗 Restraint & Handcuffing Mechanics

* **Dual Cuffing Modes (Soft & Hard Cuff):** Choose between Soft Cuff (hands positioned in front, allowing movement) and Hard Cuff (hands restrained behind back) featuring synchronized paired arrest animations (`mp_arrest_paired`) and physical cuff props.
* **Uncuffing & Key Mechanics:** Free cuffed individuals using handcuff keys with an animated uncuffing sequence. Law enforcement officers bypass item requirements, while civilians must possess physical keys.
* **Vehicle Cuff Synchronization:** Handcuffs automatically detach when a player enters any vehicle and dynamically reattach to the wrist bone upon exiting.
* **Relog & Combat-Log Persistence:** Handcuff states and cuff types (`ishandcuffed`, `cufftype`) are saved to player metadata, preventing combat logging by restoring restraints when reconnecting.

#### 🪢 Hostage & Kidnapping Actions

* **Rope Binding System:** Restrain victims using rope props attached to player ped bones with custom animations (`random@burial`). Law enforcement officers are restricted from using ropes to maintain proper roleplay standards.
* **Blade-Assisted Unbinding:** Bound hostages can only be freed by cutting ropes with sharp melee weapons (dagger, knife, switchblade) or through police intervention.
* **Blindfold System with Custom NUI:** Blindfold subdued victims with physical head variations and trigger an immersive full-screen dark blindfold UI overlay that hides the minimap. Victims can remove it via keybind only when unattended and hands are free.

#### 🚗 Vehicle Interactions & Trunk System

* **Hide In Trunk & Force Restrained Players:** Climb inside car boots to hide, or force cuffed, tied, or downed victims into the trunk. The script calculates model dimensions (`GetModelDimensions`) to position any player model accurately across vehicle classes.
* **Dedicated Scripted Trunk Camera:** Players inside vehicle trunks experience an exclusive interior camera perspective (`trunkCam`) with smooth rotation and lighting.
* **Vehicle Seating & Extraction:** Place restrained or unconscious players directly into available vehicle passenger seats or pull them out through target interactions.

#### 🥷 Robbery & Dragging System

* **Tension-Based Robbery Minigame:** Rob victims with their hands raised, cuffed, or subdued via an interactive skill tension minigame (`Lib47.StartTensionMinigame`) linked directly to your server inventory's robbery command.
* **Realistic Player Dragging & Escort:** Drag restrained suspects with speed-matched gait simulation (`SimulatePlayerInputGait`) or carry injured players in a fireman's carry with single-key release controls.

#### 🛠️ Technical Excellence

* **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget).
* **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating.
* **Durability & Statebag Synchronization:** Features configurable item wear and break chances for keys, cuffs, and blindfolds upon use, state bag replication (`LocalPlayer.state`), and an optimized 0.00ms idle tick rate.

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>

***

### ⚙️ How To Install:

* Download ak47\_crime from your cfx portal.
* Add the script in your resources folder.
* Add items based on your framework instruction.
* Add item images into inventory.
* Start the script in your server.cfg below framework files.
* Make sure you have all dependencies.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47_crime>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/5089774>
* **💬 Discord Support:** <https://discord.gg/menanak47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading
