> For the complete documentation index, see [llms.txt](https://docs.tzmc.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tzmc.dev/docs/qb-core/parcel-theft.md).

# Parcel Theft

Add a new layer of excitement and risk to your FiveM server with the **Parcel Theft Script**. This script allows players to steal parcels scattered across the map, with customizable locations, cooldowns, and reward probabilities, making every theft a unique experience.

⚡ **Key Features**:

* **Customizable Locations**: Easily set up multiple parcel theft locations across the map through the config file, giving players various spots to target.
* **Cooldown Management**: Control the respawn delay for parcels, ensuring that stolen parcels reappear after a set period, keeping the gameplay dynamic and engaging.
* **Reward Probability**: Configure the probability and quantity of various rewards that players can find within the stolen parcels, ranging from common items to rare valuables.
* **Seamless Parcel Animation**: Players automatically adopt the parcel box animation when they have a stolen parcel in their inventory, enhancing immersion without requiring additional event triggers.
* **Police Response**: Optionally enable a police response with configurable probability to increase the risk factor for players attempting to steal parcels.
* **Immersive Progress Bar**: A customizable progress bar adds tension as players wait to open a stolen parcel, with adjustable duration settings.
* **QBCore Integration**: Fully compatible with QBCore, ensuring smooth item management and interaction.

📋 **Requirements**:

* **QBCore Framework**

🔧 **Setup & Configuration**:

1. **Installation**: Download and place the script in your server’s resources folder. Add the start command to your server.cfg.
2. **Configure Locations & Cooldowns**: Use the `config.lua` file to set the parcel theft locations, adjust cooldowns, and customize reward probabilities to fit your server's unique gameplay style.
3. **Police Response & Progress Bar**: Toggle police response and fine-tune the progress bar settings to control the difficulty and pacing of parcel thefts on your server.

Whether you're looking to add new criminal activities or just want to introduce a fun and risky gameplay mechanic, the Parcel Theft Script is a great addition to any FiveM roleplay server.

🔗 **Download Now**: \[Link to Script]\
🔗 **Config Documentation**: \[Link to Config Documentation]