# Installation

{% stepper %}
{% step %}

### Drop the \`oct\_shopheist\` folder into \`resources/\`

{% endstep %}

{% step %}

### Execute the SQL file from \`install/oct\_shopheist.sql\`

{% endstep %}

{% step %}

### Add items to \`ox\_inventory\`

{% endstep %}

{% step %}

### Add \`ensure oct\_shopheist\` to \`server.cfg\`

{% endstep %}

{% step %}

### Configure \`shared/config.lua\` and \`shared/shops.lua\`

{% endstep %}
{% endstepper %}

### SQL - FILE

```sql
CREATE TABLE IF NOT EXISTS `oct_shopheist_cooldowns` (
    `shop_index` INT NOT NULL,
    `shop_name` VARCHAR(64) NOT NULL DEFAULT '',
    `expires_at` INT NOT NULL DEFAULT 0,
    PRIMARY KEY (`shop_index`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

### OX\_INVENTORY ITEMS

```lua
['elec_box_keys'] = {
    label = 'Electrical Box Keys',
    weight = 50,
    stack = true,
    close = true,
    description = 'Special keys to unlock electrical boxes. Used by electricians and technicians.',
    client = {
        image = 'key2.png', -- use existing image or add your own
    }
},

['safe_code'] = {
    label = 'Safe Code',
    weight = 10,
    stack = false,
    close = true,
    description = 'A crumpled piece of paper with a safe access code. The code is visible below.',
    client = {
        image = 'reciept.png', -- use existing image or add your own
    }
},

['bomba'] = {
    label = 'C4 Bomb',
    weight = 1500,
    stack = true,
    close = true,
    description = 'C4 explosive charge. Extreme danger! Use only in controlled conditions.',
    client = {
        image = 'c4_bomb.png', -- use existing image or add your own
    }
},
```

## DEPENDENCIES

* ox\_lib - <https://github.com/overextended/ox_lib/releases>
* ox\_target - <https://github.com/overextended/ox_target/releases>
* ox\_invenory - [https://github.com/overextended/ox\_inventory/releases](https://github.com/overextended/ox_target/releases)
* oct\_minigames - \[tebex]


---

# 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://octavista-development.gitbook.io/octavista-development/scripts/shop-heist-soon/installation.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.
