Page cover

Installation guide

Welcome to the Brutal Vehicle Heist installation guide, here you can learn how to completely install our asset.


Asset download

  • Put the script folder to your server.

  • Start the script in the server.cfg. (ensure brutal_vehicle_heist)

  • Restart your server! (And you get permission to use the script)


Upload the items

This asset depends on certain items for its operation, so don't forget to integrate all items correctly into your database or inventory system, depending on how you use your server.

If your inventory is not among the following, you can create the file yourself using the examples of each item by displaying any of the following tabs.

Items for esx_inventory
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('bag', 'Bag', 1, 0, 1),
('container_cutter', 'Cutter', 1, 0, 1),
('plateflipper', 'Plate Flipper', 1, 0, 1),
('coke_brick', 'Coke Brick', 1, 0, 1),
('vehicle_hood', 'Vehicle Hood', 1, 0, 1),
('vehicle_door_part', 'Vehicle Door', 1, 0, 1),
('vehicle_trunk', 'Vehicle Trunk', 1, 0, 1),
('vehicle_wheel', 'Vehicle Wheel', 1, 0, 1),
('glass_pieces', 'Glass pieces', 1, 0, 1),
Items for qb-inventory
["bag"] = {
    ["name"] = "bag",
    ["label"] = "Bag",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "bag.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["container_cutter"] = {
    ["name"] = "container_cutter",
    ["label"] = "Cutter",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "container_cutter.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["plateflipper"] = {
    ["name"] = "plateflipper",
    ["label"] = "Plate Flipper",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "plateflipper.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["coke_brick"] = {
    ["name"] = "coke_brick",
    ["label"] = "Coke Brick",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "coke_brick.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_hood"] = {
    ["name"] = "vehicle_hood",
    ["label"] = "Vehicle Hood",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_hood.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_door_part"] = {
    ["name"] = "vehicle_door_part",
    ["label"] = "Vehicle Door",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_door_part.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_trunk"] = {
    ["name"] = "vehicle_trunk",
    ["label"] = "Vehicle Trunk",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_trunk.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_wheel"] = {
    ["name"] = "vehicle_wheel",
    ["label"] = "Vehicle Wheel",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_wheel.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["glass_pieces"] = {
    ["name"] = "glass_pieces",
    ["label"] = "Glass pieces",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "glass_pieces.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},
Items for qs-inventory
["bag"] = {
    ["name"] = "bag",
    ["label"] = "Bag",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "bag.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["container_cutter"] = {
    ["name"] = "container_cutter",
    ["label"] = "Cutter",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "container_cutter.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["plateflipper"] = {
    ["name"] = "plateflipper",
    ["label"] = "Plate Flipper",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "plateflipper.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["coke_brick"] = {
    ["name"] = "coke_brick",
    ["label"] = "Coke Brick",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "coke_brick.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_hood"] = {
    ["name"] = "vehicle_hood",
    ["label"] = "Vehicle Hood",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_hood.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_door_part"] = {
    ["name"] = "vehicle_door_part",
    ["label"] = "Vehicle Door",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_door_part.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_trunk"] = {
    ["name"] = "vehicle_trunk",
    ["label"] = "Vehicle Trunk",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_trunk.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["vehicle_wheel"] = {
    ["name"] = "vehicle_wheel",
    ["label"] = "Vehicle Wheel",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "vehicle_wheel.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},

["glass_pieces"] = {
    ["name"] = "glass_pieces",
    ["label"] = "Glass pieces",
    ["weight"] = 1,
    ["type"] = "item",
    ["ammotype"] = nil,
    ["image"] = "glass_pieces.png",
    ["unique"] = false,
    ["useable"] = true,
    ["combinable"] = nil,
    ["description"] = "It does not contain a description."
},
Items for ox-inventory
["bag"] = {
	label = "Bag",
	weight = 1,
	stack = true,
	close = true,
},

["container_cutter"] = {
	label = "Cutter",
	weight = 1,
	stack = true,
	close = true,
},

["plateflipper"] = {
	label = "Plate Flipper",
	weight = 1,
	stack = true,
	close = true,
},

["coke_brick"] = {
	label = "Coke Brick",
	weight = 1,
	stack = true,
	close = true,
},

["vehicle_hood"] = {
	label = "Vehicle Hood",
	weight = 1,
	stack = true,
	close = true,
},

["vehicle_door_part"] = {
	label = "Vehicle Door",
	weight = 1,
	stack = true,
	close = true,
},

["vehicle_trunk"] = {
	label = "Vehicle Trunk",
	weight = 1,
	stack = true,
	close = true,
},

["vehicle_wheel"] = {
	label = "Vehicle Wheel",
	weight = 1,
	stack = true,
	close = true,
},

["glass_pieces"] = {
	label = "Glass pieces",
	weight = 1,
	stack = true,
	close = true,
},

Here you can find the images which we used for the items.

Item images

Asset positioning

-- First we will start the cores, never below
ensure es_extended or qb-core

-- The Notify / TextUI or target system / Progressbar / Inventory / Billing have to be above our asset
ensure [notify]
ensure [inventory]
ensure [billing]
ensure [textui] -- or target system 

-- Start the Brutal Vehicle Heist at the end
ensure brutal_vehicle_heist

Setting the loaded event

In the client-core.lua file go to the LoadedEvent variable and if you are using a different event then paste there your event which is used on your server.

client-core.lua

Checking the Config file

Please make sure that you go through the whole file during the installation and check everything. It is one of the most important things as if you miss this step the script might won't work propetly.

Most important steps

The most important things always at the top of the config so pay the most attencion to these elements.

Setting the Notify

If you are using the Brutal Notify then it is good news, you don't have to do anything. If you aren't then set the BrutalNotify value to false in the config and set up your own notify in the cl-utils.lua

Setting the TextUI or Target

Set the TextUI from the options which are commented out. If your server using an other TextUI it is not a problem, you can set it up in the cl-utils.lua. If you want to use a target system then set the TextUI to false and set your target.


Optional Minigame

Download this script only if you're not using the default minigame system.


If you got any error

If you followed the installational guide and the script still don't work or you get any errors the please check the common errors, here in the docs and in our discord server, for more informations.

Last updated

Was this helpful?