---
description: >-
  Follow these simple steps to install and set up the script seamlessly. Ensure
  each step is completed to avoid issues during usage.
---

# Installation Guide

***

## Step 1: Add Items to qb-core

Update your **`qb-core/shared/items.lua`** file by adding the following:

```lua
['red_usb'] = {['name'] = 'red_usb', ['label'] = 'Red USB', ['weight'] = 100, ['type'] = 'item', ['image'] = 'red_usb.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = ''},
['green_usb'] = {['name'] = 'green_usb', ['label'] = 'Green USB', ['weight'] = 100, ['type'] = 'item', ['image'] = 'green_usb.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = ''},
['blue_usb'] = {['name'] = 'blue_usb', ['label'] = 'Blue USB', ['weight'] = 100, ['type'] = 'item', ['image'] = 'blue_usb.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = ''},
```

***

## Step 2: Import Item Images

Copy all item images from the `[install]/images` folder to:

* 📁 `qb-inventory/html/images`

***

## Step 3: Update Metadata Table

Add the following line in your `qb-core/server/player.lua` file under the metadata table:

```lua
   PlayerData.metadata['gunheistrep'] = PlayerData.metadata['gunheistrep'] or 0
```

***

## **Step 4:** Configure Log Settings

In your `qb-smallresource/server/logs.lua` file, insert the line below:

```lua
['gunheist'] = '',
```

***

## **Step 5: Import Minigames**

Move all minigame files from the `[install]/minigames` folder to your:\
📁 `[standalone]` directory.

***

## **Step 6: Configure the Script**

Adjust the "_**Config.file"**_ to match your server's specific needs. Tailor it to optimize your gameplay experience.

***

## 💡 **Pro Tip**

✔️ Double-check each step to ensure no files or configurations are missed.\
✔️ For troubleshooting or advanced setups, refer to the documentation or reach out to support.

With these steps complete, your script is ready to power up your server! 🎉
