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

***


---

# 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://offload-scripts.gitbook.io/offload-scripts/scripts-and-guides/free-scripts/smash-and-grab-vehicles.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.