Installation

Dependencies

Ensure the following resources are installed and running before sd-bobcat:

Dependency	Options
Library	sd_lib
Interaction	ox_target / qb-target / qtarget (or use TextUI)
Doorlock	ox_doorlock / qb-nui_doorlock / cd_doorlock

Step 1: Add the Resource

1. Download sd-bobcat from Keymaster
2. Extract it into your server's resources directory
3. Add ensure sd-bobcat to your server.cfg after all dependencies

ensure sd_lib
ensure ox_lib
ensure ox_target
ensure ox_doorlock
ensure sd-bobcat

Step 2: Select Your MLO

Open config.lua and set Config.MLOType to match your installed MLO:

Config.MLOType = 'gabz'     -- Options: 'gabz', 'nopixel', 'k4mb1'

All coordinates, doorlocks, and guard spawns will automatically adjust to your selected map.

Step 3: Import Doorlock Data

Choose the doorlock system you use and import the corresponding config:

ox_doorlock

-- Import sd-bobcat/doorlock/ox_doorlock/*.sql into your database
-- This creates 4 door entries: bobcatfirst, bobcatsecond, bobcatthird, bobcatfourth

qb-nui_doorlock

-- Copy the contents of sd-bobcat/doorlock/qb-nui_doorlock/*.lua
-- into your qb-nui_doorlock config file

cd_doorlock

-- Import sd-bobcat/doorlock/cd_doorlock/*.json
-- into your cd_doorlock configuration

Step 4: Add Items

Register the required items in your inventory system:

ox_inventory

-- Add to ox_inventory/data/items.lua

['bobcatkeycard'] = {
    label = 'Bobcat Security Card',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A keycard used at the Bobcat Security Deposit.',
},
['c4_bomb'] = {
    label = 'C4 Brick',
    weight = 1000,
    stack = false,
    close = true,
    description = 'Very Dangerous! High Yield Explosive.',
},
['thermite_h'] = {
    label = 'Thermite',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A low-yield thermite charge.',
    server = {
        export = 'sd-bobcat.useThermite_h',
    },
},

qb-core

-- Add to qb-core/shared/items.lua

['bobcatkeycard']  = { name = 'bobcatkeycard',  label = 'Bobcat Security Card', weight = 1000, type = 'item', image = 'bobcatkeycard.png', unique = false, useable = true,  shouldClose = true, description = 'A keycard used at the Bobcat Security Deposit.' },
['c4_bomb']        = { name = 'c4_bomb',        label = 'C4 Brick',            weight = 1000, type = 'item', image = 'c4_bomb.png',       unique = true,  useable = false, shouldClose = true, description = 'Very Dangerous! High Yield Explosive.' },
['thermite_h']     = { name = 'thermite_h',     label = 'Thermite',            weight = 1000, type = 'item', image = 'thermite_h.png',    unique = true,  useable = true,  shouldClose = true, description = 'A low-yield thermite charge.' },

ESX

-- Import sd-bobcat/[SQL]/ESX/items.sql or run manually:

INSERT INTO `items` (`name`, `label`, `weight`) VALUES
  ('bobcatkeycard', 'Bobcat Security Card', 1),
  ('c4_bomb', 'C4 Brick', 10),
  ('thermite_h', 'Thermite', 10);

Step 5: Copy Item Images

Copy the item images from sd-bobcat/images/ to your inventory's image folder:

Inventory	Image Path
ox_inventory	ox_inventory/web/images/
qb-inventory / ps-inventory	<inventory>/html/images/
qs-inventory	qs-inventory/html/images/
codem-inventory	codem-inventory/html/itemimages/
origen_inventory	origen_inventory/ui/images/

Bobcat Item Images3 images

bobcatkeycard.png

c4_bomb.png

thermite_h.png

TIP

If you are using a custom inventory, place the images wherever your inventory loads item icons from.

Step 6: Start and Verify

1. Start your server
2. Check the server console for any errors
3. Look for the Bobcat Security blip on the map (if enabled)
4. Ensure the minimum police requirement is met before attempting the heist

WARNING

Make sure sd_lib is started before sd-bobcat in your server.cfg, or the resource will fail to load.