Skip to main content

Installation

Follow these steps to install the Shop Robbery script on your FiveM server:

Step 1: Download the Script​

After purchasing the script from our Tebex Store, you can download from Granted Assets page.

Step 2: Extract the Files​

Extract the contents of the zip file to your server's resources folder.

Step 3: Install Dependencies​

Make sure you have the following dependencies installed on your server:

  • ox_lib
  • Optional: One of the supported dispatch asset for police dispatchs.

Step 4: Add the Drill Item​

ESX (ox_inventory)​

If you're using ox_inventory, add this to your shared/items.lua:

['gig_drill'] = {
  label = 'Drill',
  weight = 500,
  stack = false,
  close = true,
  description = 'A powerful drill used in shop robberies.'
}

If you're using the legacy ESX items SQL table:

INSERT INTO `items` (`name`, `label`, `weight`) VALUES
('gig_drill', 'Drill', 1);

QBCore​

Add this to your shared/items.lua:

['gig_drill'] = {
  name = 'gig_drill',
  label = 'Drill',
  weight = 500,
  type = 'item',
  image = 'gig_drill.png',
  unique = true,
  useable = false,
  shouldClose = true,
  combinable = nil,
  description = 'A powerful drill used for breaking into locked areas.'
}

Make sure the gig_drill.png image is placed in your inventory UI's images folder.

QBox​

QBox item definitions are similar to ox_inventory. Add this to shared/items.lua:

['gig_drill'] = {
  label = 'Drill',
  weight = 500,
  stack = false,
  close = true,
  description = 'A drill used during robberies.'
}

Step 5: Add to server.cfg​

Add the following line to your server.cfg file:

ensure gigShopRobbery

Make sure to start this resource after your framework (ESX, QBCore or QBOX) and any dependencies.

Step 6: Configure the Script​

Edit the cfg.lua file to customize the script according to your server's needs. Check the Configuration page for more details.

Step 7: Restart Your Server​

Restart your server to apply the changes.

Troubleshooting​

If you encounter any issues during the installation, please check:

  1. Make sure all dependencies are properly installed
  2. Verify that the resource is started after all dependencies
  3. Check server console for any error messages

If you still have issues, please contact us on our Discord Guild for support.