# Shock's Scripts DOC

## Shock's Scripts docs

* **Store:** [shockscripts.tebex.io](https://shockscripts.tebex.io/)
* **Discord:** [discord.gg/FXZw6UKnXg](https://discord.gg/FXZw6UKnXg)
* **Frameworks:** QBCore, QBX

### Quick links

* [Installation and setup](/shocks-development-docs/shocks-scripts-doc/script-catalog.md)
* [Script catalog](/shocks-development-docs/shocks-scripts-doc/installation-and-setup.md)
* [Compatibility matrix](/shocks-development-docs/shocks-scripts-doc/faq-and-troubleshooting.md)
* [FAQ and troubleshooting](/shocks-development-docs/shocks-scripts-doc/compatibility-matrix.md)
* [Support and policies](/shocks-development-docs/shocks-scripts-doc/support-and-policies.md)

### Quick overview

| Script                         | Category  | Framework   | Notes                                           |
| ------------------------------ | --------- | ----------- | ----------------------------------------------- |
| **QB PED ROBBERY**             | Crime     | QBCore, QBX | Supports multiple inventories                   |
| **QB ScriptClub**              | Roleplay  | QBCore, QBX | Supports job restrictions                       |
| **QB Treasure Hunting Script** | Adventure | QBCore, QBX | Requires `ox_inventory`, `ox_target`, `qb-menu` |
| **QB Store Robberies**         | Crime     | QBCore, QBX | Real-time robbery flow                          |
| **QB Pawnshop System V3.0**    | Economy   | QBCore, QBX | Supports Discord logging                        |
| **QB Dumpster Diving**         | Looting   | QBCore, QBX | Random search rewards                           |
| **QB ATM ROBBERY**             | Crime     | QBCore, QBX | Available in cheap scripts                      |

***

### Before You Buy

* All scripts are built for **QBCore / QBX** frameworks. Make sure your server is running a compatible version before purchasing.
* Check each product page for its specific **dependency requirements** (e.g. ox\_inventory, ox\_target, qb-menu, qs-inventory).
* If you have questions about compatibility before purchasing, ask in our **Discord** before completing your order.

***

### Store Policies

> ⚠️ **Please read carefully before purchasing.**

* **All payments are final.** We do not offer refunds under any circumstances.
* **Chargebacks or PayPal disputes will result in a permanent ban** from our store and loss of access to all purchased scripts.
* By completing a purchase, you agree to these terms in full.
* Scripts are for **personal server use only** and must not be redistributed, leaked, or resold.

***

### Getting Started After Purchase

1. **Log into Tebex** and navigate to your purchases to download your script files.
2. **Extract the folder** and place it inside your server's `resources` directory.
3. **Add the resource** to your `server.cfg`:

   ```
   ensure [script-name]
   ```
4. **Configure the script** by editing `config.lua` to match your server's setup (inventory system, job names, item names, etc.).
5. **Restart your server** or use `refresh` then `start [script-name]` in your server console.
6. **Check your server console** for any errors and refer to the FAQ or Discord if needed.

***

### Script Index

#### 🔫 \[SHOCKS] QB PED ROBBERY

Rob NPCs on the street with a fully configurable system.

**Key Features:**

* Randomised loot table with rarity levels (common → ultra-rare)
* Configurable items: cash, marked bills, jewelry, phones, and more
* NPC armament system — set the chance for NPCs to be armed and what weapons they carry
* Configurable robbery cooldown, duration, and NPC fight-back/flee chance
* Custom robbery animation and NPC model list

**Dependencies:** QBCore / QBX, compatible inventory (qb, ox, or qs)

***

#### 💃 \[SHOCKS] QB ScriptClub

An interactive strip club script with dancer NPCs and cash reward mechanics.

**Key Features:**

* Players can tip dancers and trigger dance emotes
* Random cash reward system
* Configurable NPC dancer models and animations
* Job restriction support (lock to a specific job)
* Inventory support: qb, ox, or qs

**Dependencies:** QBCore / QBX, compatible inventory

***

#### 🗺️ \[SHOCK'S] QB Treasure Hunting Script

An immersive treasure hunting experience using maps, shovels, and hidden loot.

**Key Features:**

* Players use a `treasure_map` item to mark a random location on their map
* Automatic waypoint guidance to the treasure location
* Visible treasure prop spawns at the dig site
* Shovel required to dig — uses a progress bar animation
* Randomised loot rewards on success

**Dependencies:** QBCore / QBX, ox\_inventory, ox\_target, qb-menu

***

#### 🏪 \[SHOCK'S] QB Store Robberies

Rob convenience stores by intimidating NPC clerks in real time.

**Key Features:**

* Dynamic intimidation bar system — fill it to earn your reward
* Clerks have a configurable chance to fight back
* Police alert system notifies law enforcement in real time
* Fully customisable store locations, clerk models, weapons, and reward tables
* Configurable police alert message and difficulty settings

**Dependencies:** QBCore / QBX

***

#### 💍 \[SHOCK'S] QB Pawnshop System V3.0

A fully featured pawnshop where players can sell items for cash.

**Key Features:**

* Discord webhook integration for logging all pawnshop activity
* Supports qb, qs, and ox inventory systems
* Configurable item lists and sell prices

**Dependencies:** QBCore / QBX, compatible inventory (qb, ox, or qs)

***

#### 🗑️ \[SHOCK'S] QB Dumpster Diving

Search dumpsters across the map for random loot.

**Key Features:**

* Interact with dumpsters by pressing **E** when nearby
* Progress bar and diving animation during the search
* Configurable loot table in `config.lua` (item, chance, quantity)
* Built-in cooldown system to prevent spam looting
* In-game notifications on interaction and result

**Dependencies:** QBCore / QBX

***

#### 🏧 \[SHOCKS] QB ATM ROBBERY

Rob ATMs for cash rewards. Available in the **Cheap Scripts** category.

**Dependencies:** QBCore / QBX

***

### Common Installation Steps

#### Adding Items to Your Inventory

Some scripts require custom items (e.g. `treasure_map`, `shovel`). Add these to your inventory resource:

**For qb-core (`items.lua`):**

```lua
['treasure_map'] = {
    ['name'] = 'treasure_map',
    ['label'] = 'Treasure Map',
    ['weight'] = 100,
    ['type'] = 'item',
    ['image'] = 'treasure_map.png',
    ['unique'] = false,
    ['useable'] = true,
    ['shouldClose'] = true,
    ['combinable'] = nil,
    ['description'] = 'A mysterious map leading to hidden treasure.'
},
```

**For ox\_inventory (`data/items.lua`):**

```lua
['treasure_map'] = {
    label = 'Treasure Map',
    weight = 100,
    stack = true,
    close = true,
    description = 'A mysterious map leading to hidden treasure.'
},
```

#### Setting Your Inventory Type

In `config.lua`, set the inventory variable to match your server:

```lua
Config.Inventory = 'qb'   -- Options: 'qb', 'ox', 'qs'
```

#### Discord Webhooks (Pawnshop)

In `config.lua`, paste your Discord webhook URL:

```lua
Config.Webhook = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE'
```

***

### Frequently Asked Questions

**Q: Which framework do your scripts support?** All scripts are built for **QBCore and QBX**. ESX is not supported unless stated on the product page.

**Q: Which inventory systems are supported?** Most scripts support **qb-inventory**, **ox\_inventory**, and **qs-inventory**. Check the individual script's `config.lua` or product page for exact options.

**Q: My script isn't starting — what do I do?** Check your server console for errors. The most common causes are:

* Missing `ensure` line in `server.cfg`
* A required dependency not being started first
* A misconfigured item name in `config.lua`

**Q: Can I customise the scripts?** Yes. All scripts include a `config.lua` file for full customisation — loot tables, cooldowns, locations, models, job restrictions, and more — without editing core code.

**Q: I purchased the wrong script / I want a refund.** All sales are final. Please review the product page and ask questions in Discord **before** purchasing.

**Q: My purchase isn't showing in my Tebex account.** Allow a few minutes for delivery. If it still hasn't arrived, open a support ticket in our Discord with proof of payment.

**Q: Can I use these scripts on multiple servers?** Each purchase covers a single server. Using a script across multiple servers without additional licences is a violation of our terms.

***

### Getting Support

Join our Discord for the fastest response: [**discord.gg/FXZw6UKnXg**](https://discord.gg/FXZw6UKnXg)

When opening a support ticket, please include:

* The **script name** you need help with
* Your **QBCore/QBX version**
* Your **inventory resource** (qb, ox, or qs)
* A **screenshot or copy** of any console errors
* Confirmation that all **dependencies are installed and ensured**


---

# 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://shocks-development.gitbook.io/shocks-development-docs/shocks-scripts-doc.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.