# Installation

## Installation

The installation of the script is extremely easy

{% hint style="danger" %}
Do NOT use **FileZilla** to upload the files, otherwise the script will NOT work

Use [WinSCP](https://winscp.net/eng/download.php) instead
{% endhint %}

{% tabs %}
{% tab title="ESX" %}

1. Download the script and extract it in your resources
2. Add the script in your auto start (example: server.cfg)
3. The script will **automatically** setup the database, in case it doesn't, you can manually run the files in `robberies_creator/sql/` folder
4. Download and start the [cracking safe script](https://github.com/VHall1/pd-safe) *(Credits to* [*VHall1*](https://github.com/VHall1)*)*
5. Download and start the [lockpicking script](https://github.com/baguscodestudio/lockpick) *(Credits to* [*baguscodestudio*](https://github.com/baguscodestudio/lockpick)*)*
6. Optional - Download and start the [datacrack minigame script ](https://github.com/utkuali/datacrack)*(Credits to* [*utkuali*](https://github.com/utkuali)*)*
7. Optional - Download and start the [fingerprint minigame script ](https://github.com/utkuali/Finger-Print-Hacking-Game)*(Credits to* [*utkuali*](https://github.com/utkuali)*)*
8. Optional - Download and start the [memory minigame script](https://github.com/ultrahacx/ultra-keypackhack) *(Credits to* [*ultrahacx*](https://github.com/ultrahacx)*)*

#### Adding the items - Optional <a href="#adding-the-items-optional" id="adding-the-items-optional"></a>

To add the premade items, you only have to run the file `robberies_creator/sql/items_limit.sql` **or** `robberies_creator/sql/items_weight.sql` depending on your server, if it uses the limit or the weight

{% hint style="info" %}
The latest version of ESX uses **weight**
{% endhint %}

{% hint style="danger" %}
If it doesn't work, be sure to use the latest version of the official ESX with the dependencies
{% endhint %}
{% endtab %}

{% tab title="QBCore" %}

1. Download the script and extract it in your resources
2. Add the script in your auto start (example: server.cfg)
3. The script will **automatically** setup the database, in case it doesn't, you can manually run the files in `robberies_creator/sql/` folder
4. Download and start the [cracking safe script](https://github.com/VHall1/pd-safe) *(Credits to* [*VHall1*](https://github.com/VHall1)*)*
5. Download and start the [lockpicking script](https://github.com/baguscodestudio/lockpick) *(Credits to* [*baguscodestudio*](https://github.com/baguscodestudio/lockpick)*)*
6. Optional - Download and start the [datacrack minigame script ](https://github.com/utkuali/datacrack)*(Credits to* [*utkuali*](https://github.com/utkuali)*)*
7. Optional - Download and start the [fingerprint minigame script ](https://github.com/utkuali/Finger-Print-Hacking-Game)*(Credits to* [*utkuali*](https://github.com/utkuali)*)*
8. Optional - Download and start the [memory minigame script](https://github.com/ultrahacx/ultra-keypackhack) *(Credits to* [*ultrahacx*](https://github.com/ultrahacx)*)*

#### Adding the items - Optional <a href="#adding-the-items-optional-1" id="adding-the-items-optional-1"></a>

To add the new items, you have to edit `qb-core/shared/items.lua` file and add at the bottom of the table the following code

```
-- Robberies Creator items
	['hacking_computer'] 			 = {['name'] = 'hacking_computer', 				['label'] = 'Hacking computer',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Computer to hack panels'},
	['thermal_charge'] 			 = {['name'] = 'thermal_charge', 				['label'] = 'Thermal charge',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Use to melt some doors'},
	['gas_mask'] 			 = {['name'] = 'gas_mask', 				['label'] = 'Gas mask',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Protects from lethal gas'},
	['drill'] 			 = {['name'] = 'drill', 				['label'] = 'Drill',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Can be used to open trucks doors'},
	['gold_ingot'] 			 = {['name'] = 'gold_ingot', 				['label'] = 'Gold ingot',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Goooold'},
	['diamonds_box'] 			 = {['name'] = 'diamonds_box', 				['label'] = 'Diamond box',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Diamooonds'},
	['lockpick'] 			 = {['name'] = 'lockpick', 				['label'] = 'Lockpick',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Used to lockpick doors'},
	['painting'] 			 = {['name'] = 'painting', 				['label'] = 'Painting',	['weight'] = 500, 		['type'] = 'item', 		['image'] = 'your_image.png', 		['unique'] = false,		['useable'] = true, 	['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = 'Expensive painting'},
```

**Screenshot example**

<figure><img src="https://documentation.jaksam-scripts.com/~gitbook/image?url=https%3A%2F%2F3735039044-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FFH9TH8An8XLjMiOMvVGb%252Fuploads%252FcH2L891VYB7fs7ifKuHQ%252Fqb_core_robberies_creator_items.png%3Falt%3Dmedia%26token%3Dbf328cbd-a8e2-406c-87f4-daba6c1206f5&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b9c4df58dc60a3caaeebb11757d163c2feb79775bef294314bb213b43e1e5e87" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="OX Inventory" %}
Here's a list for items to use with OX inventory, you can even use it with jaksam's inventory, in 'import from code' setting

```lua
['hacking_computer'] = {
    label = 'Hacking computer',
    weight = 500,
    stack = true,
    close = true,
    description = 'Computer to hack panels'
},

['thermal_charge'] = {
    label = 'Thermal charge',
    weight = 500,
    stack = true,
    close = true,
    description = 'Use to melt some doors'
},

['gas_mask'] = {
    label = 'Gas mask',
    weight = 500,
    stack = true,
    close = true,
    description = 'Protects from lethal gas'
},

['drill'] = {
    label = 'Drill',
    weight = 500,
    stack = true,
    close = true,
    description = 'Can be used to open trucks doors'
},

['gold_ingot'] = {
    label = 'Gold ingot',
    weight = 500,
    stack = true,
    close = true,
    description = 'Goooold'
},

['diamonds_box'] = {
    label = 'Diamond box',
    weight = 500,
    stack = true,
    close = true,
    description = 'Diamooonds'
},

['lockpick'] = {
    label = 'Lockpick',
    weight = 500,
    stack = true,
    close = true,
    description = 'Used to lockpick doors'
},

['painting'] = {
    label = 'Painting',
    weight = 500,
    stack = true,
    close = true,
    description = 'Expensive painting'
},
```

{% endtab %}
{% endtabs %}

You are ready to go! Enjoy the script 😁

## Optional step

After the database is setup correctly, you can delete the files in `robberies_creator/sql/` folder, so the script won't try to setup the database each time you start the script


---

# 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://documentation.jaksam-scripts.com/robberies-creator/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.