Installation Guide

This guide will walk you through the process of installing and configuring the Heists Creator system on your server.

System Requirements

Before installation, ensure your server meets these minimum requirements:

• Server Artifact: Version 13930 or higher

• Game Build: 2699 or higher (we recommend using the latest available)

  # Example code for your server.cfg:
  set sv_enforceGameBuild 3407

Core Installation

The Heists Creator detects your server's framework, inventory, target, dispatch, and doorlock systems automatically. Follow these steps to install:

1. Install Dependencies

   • ox_lib (required)

   • mka-lasers

2. Resource Installation

   • Place the sh-heists folder in your server's resources directory

   • The exact location doesn't matter as long as it's within the resources folder

3. Resource Load Order (make sure the script starts after these resources, if you're using them):

   • Your framework (qb-core, qbx_core, es_extended, ND_Core)

   • Inventory system (qb, lj, ps, qs, ox)

   • Target system (qb, ox)

   • Doorlocks (qb, ox, jaksam, rcore)

   • ox_lib

4. Configuration

   • Customize sh-heists/config/config.lua file according to your preferences

5. Framework-Specific Setup

   • If using qbx_core framework, open sh-heists/fxmanifest.lua and uncomment lines with QBX

6. Server Restart

   • Save all changes and restart your server

Premade Heists Installation

The resource comes with several pre-configured heists. Here's how to set them up:

General Information

• Using Premade Heists is Optional

  • You can remove any or all premade heists by deleting the corresponding folders in sh-heists/config/data/shared

• Required Items

  • The premade heists use items from the QBCore item list:

    • trojan_usb, electronickit, thermite, gatecrack, markedbills

    • goldbar, drill, gold_ring, diamond_ring, goldchain

    • diamond_necklace, coke_small_brick, screwdriverset

  • You can either add these items to your inventory system or edit the config files to use your existing items

• IPL Requirements

  • Some heists use IPLs from the game, so an IPL loader like bob74_ipl is recommended

Humane Labs Heist Setup

1. Install Required Resources

   • Install the humanelabsdoor resource to keep the main garage open (prevents NPC bugs)
2. Door Configuration

   • Different doorlock systems require different setups:

   For qb-doorlocks:

   • Create a new file in the qb-doorlock/configs directory

   • Copy the provided door configuration code into this file (see Door Configurations section)

   For ox_doorlock or jaksam doors creator:

   • Create the necessary doors manually

   • Insert the door IDs into sh-heists/config/data/shared/humanelabs_sh.lua

Vangelico Jewelry Heist Setup

1. Door Configuration

   • Different doorlock systems require different setups:

   For qb-doorlocks:

   • Create a new file in the qb-doorlock/configs directory

   • Copy the provided jewelery-main-door configuration (see Door Configurations section)

   For ox_doorlock or jaksam doors creator:

   • Create the necessary doors manually

   • Insert the door IDs into the corresponding configuration files

Fleeca Banks Setup

1. Door Configuration

   • For qb-doorlocks: If you're using default Fleeca interiors, your doorlock script should already have the necessary configurations

   • For ox_doorlock or jaksam doors creator: Create the doors manually and insert the IDs into the configuration files

Door Configurations

Humane Labs Doors (for qb-doorlocks)

Doorlocks

-- first
Config.DoorList['humanelabs-first'] = {
 doorType = 'double',
 distance = 1,
 doors = {
   {objName = -421709054, objYaw = 324.99993896484, objCoords = vec3(3599.868896, 3719.375488, 29.839624)},
   {objName = 1282049587, objYaw = 324.99993896484, objCoords = vec3(3601.999756, 3717.883545, 29.839624)}
 },
 doorRate = 1.0,
 locked = true,
 authorizedJobs = { ['police'] = 0 },
}

-- second
Config.DoorList['humanelabs-second'] = {
 locked = true,
 distance = 2,
 doors = {
   {objName = 1282049587, objYaw = 324.99993896484, objCoords = vec3(3586.289795, 3699.454590, 28.971439)},
   {objName = -421709054, objYaw = 324.99993896484, objCoords = vec3(3584.158936, 3700.946533, 28.971439)}
 },
 authorizedJobs = { ['police'] = 0 },
 doorRate = 1.0,
 doorType = 'double',
}

-- third
Config.DoorList['humanelabs-third'] = {
 locked = true,
 distance = 2,
 doors = {
   {objName = -421709054, objYaw = 324.99993896484, objCoords = vec3(3596.380615, 3690.468506, 28.971624)},
   {objName = 1282049587, objYaw = 324.99993896484, objCoords = vec3(3598.511475, 3688.976562, 28.971624)}
 },
 authorizedJobs = { ['police'] = 0 },
 doorRate = 1.0,
 doorType = 'double',
}

-- fourth
Config.DoorList['humanelabs-fourth'] = {
 locked = true,
 distance = 2,
 doors = {
   {objName = 1282049587, objYaw = 260.0, objCoords = vec3(3568.709473, 3693.308838, 28.271549)},
   {objName = -421709054, objYaw = 260.0, objCoords = vec3(3569.161133, 3695.870361, 28.271549)}
 },
 authorizedJobs = { ['police'] = 0 },
 doorRate = 1.0,
 doorType = 'double',
}

-- fifth
Config.DoorList['humanelabs-fifth'] = {
 locked = true,
 distance = 1,
 doors = {
   {objName = 1282049587, objYaw = 260.0, objCoords = vec3(3544.806885, 3643.996338, 28.271835)},
   {objName = -421709054, objYaw = 260.0, objCoords = vec3(3545.258545, 3646.557861, 28.271835)}
 },
 doorRate = 1.0,
 doorType = 'double',
}

-- sixth
Config.DoorList['humanelabs-sixth'] = {
 objName = 161378502,
 fixText = false,
 objYaw = 260.15814208984,
 doorRate = 1.0,
 distance = 1,
 locked = false,
 objCoords = vec3(3557.553223, 3669.194092, 27.121582),
 doorType = 'sliding',
}

Vangelico Jewelry Store Door (for qb-doorlocks)

Doorlocks

Config.DoorList['jewelery-main-door'] = {
 doors = {
   {objName = 1425919976, objYaw = 306.00003051758, objCoords = vec3(-631.955383, -236.333267, 38.206532)},
   {objName = 9467943, objYaw = 306.00003051758, objCoords = vec3(-630.426514, -238.437546, 38.206532)}
 },
 doorRate = 1.0,
 distance = 1,
 locked = true,
 doorType = 'double',
}

Troubleshooting

If you encounter issues during installation:

• Script Not Working: Verify load order - ensure all dependencies load before Heists Creator

• Door Problems: Double-check your doorlock configurations match the IDs referenced in heist configs

• Missing Items: Ensure all required items exist in your inventory system or edit configs to use available items

Post-Installation

After successful installation:

1. Test each heist to ensure it functions correctly

2. Review and customize the configuration files to match your server's economy and gameplay balance

3. Consider creating custom heists based on the provided examples

For advanced configuration options, refer to the main documentation.