Installation Guide

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


Step 1: Add Items to qb-core

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

['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:

   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:

['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! 🎉

Last updated