> For the complete documentation index, see [llms.txt](https://offload-scripts.gitbook.io/offload-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://offload-scripts.gitbook.io/offload-scripts/scripts-and-guides/free-scripts/smash-and-grab-vehicles.md).

# Smash & Grab Vehicles

Smash & Grab is a fully customizable FiveM resource designed to enhance criminal roleplay and add more immersive street-level interactions. Players can search vehicles for valuable or forgotten items, smash the car window, and grab what’s inside.

{% embed url="<https://www.youtube.com/watch?v=ku-tJTMlmnk>" %}

## 🛠️ Installation Guide: Offload Smash & Grab

Welcome to the **Offload Smash & Grab** installation guide. Follow these steps to set up the script on your FiveM server.

***

### **Prerequisites**

Before installing, ensure you have the following dependencies installed and running:

* [**ox\_lib**](https://github.com/overextended/ox_lib) - Required for UI elements, progress bars, and utility functions.
* [**community\_bridge**](https://github.com/TheOrderFivem/community_bridge/releases/tag/0.13.2) - Required for framework compatibility (ESX, QB-Core, etc.).

***

### **Installation Steps**

1. **Download & Extract**
   * Download the latest version of [`offload_smash_grab`](https://offload-studio-scripts.tebex.io/package/7282109).
   * Extract the folder into your server's `resources` directory.
   * Ensure the folder is named exactly `offload_smash_grab`.
2. **Add to Server Config**
   * Open your `server.cfg` file.
   * Add the following line:

     ```cfg
     ensure offload_smash_grab
     ```
3. **Configure the Script**
   * Navigate to `offload_smash_grab/config/shared.lua`.
   * Customize the settings to fit your server's economy:
     * **SpawnChance**: Adjust how often vehicles spawn with loot (e.g., `0.5` for 50%).
     * **Loot Tables**: Add or remove items from the `rewards` lists for Duffel Bags, Paper Bags, and Purses.

***

### **Configuration Details**

#### **Loot Rewards**

The rewards are handled in `config/shared.lua`. Each reward entry follows this format:

```lua
{ item = 'item_name', chance = 80, min = 1, max = 5 }
```

* `item`: The internal name of the item in your inventory system.
* `chance`: The percentage chance (1-100) that this item will drop.
* `min` / `max`: The range of the amount given to the player.

#### **Framework Integration**

This script uses **community\_bridge** to automatically detect your framework (ESX/QB/etc.). Ensure your `community_bridge` is correctly configured for your server's framework to allow items to be added to player inventories correctly.

***