# 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]


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tzmc.dev/docs/qb-core/parcel-theft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.