gr_jewellery — Free FiveM Jewellery Robbery Script

---

gr_jewellery is a fully featured, performance-focused Jewellery Heist system for FiveM, designed with immersion, configurability, and server stability in mind.

Rob multiple stores, trigger dynamic alarm systems, disable power with thermite, hack security networks, and manage door locks with fully server-side control. Built to feel alive and reactive — without sacrificing performance.

---

Key Features

• ⚡ Highly Optimised

  • 0.00ms idle
  • 0.01–0.02ms during animations or lock state changes
  • Designed for stable long-term server performance

• 🏬 Multiple Store Support

  • 3 stores preconfigured (using GigZ Jewel Store)
  • Easily expandable for additional locations

• 🔐 Advanced Lock & Alarm System

  • Unique cooldowns for:
    • Individual display cases
    • Store alarms
    • Store door locks
  • Fully server-side door control
  • Automatic door locking at configurable times

• 🚨 Dynamic Alarm Behaviour

  • Multiple alarms per store
  • Synced sirens and emergency lighting
  • 🔴 Map blips flash while alarms are active
  • 🕒 Time-of-day based alert trigger chances
  • 🗺️ Blips visually indicate store state (reduced opacity when closed)
  • Configurable alert ranges

• 🔥 Thermite Power Sabotage

  • Disable store power using thermite
  • Unlocks the main locked entrance
  • Disables the active alarm system
  • Fully synced visual and particle effects
  • Adds a high-risk, high-reward escalation option
  • Easily adaptable to custom minigames

• 💻 Security System Hacking

  • Hack the store computer for additional advantages
  • Built-in alarmdisable functionality (default for LEO)
  • Easily adaptable to custom minigames

• 💎 Immersive Glass Effects

  • Destroyed display models
  • Glass particle effects
  • Native GTA sound effects
  • Fully synced between all players at all times

• 🧩 Minigame Flexibility

  • Pre-configured for Glitch Minigames
  • Easily replaceable with any minigames resource via the client config

• 📡 Dispatch & Alert Integration

  • Fully configurable dispatch alerts
  • Customisable via client config and locale files

• 👮‍♂️ Grouse Patrols Integration

  • Includes a preconfigured patrol setup
  • Seamlessly escalates robberies with AI patrol units

Table of Contents

• gr_jewellery — Free FiveM Jewellery Robbery Script
  • Key Features
  • Table of Contents
    • Credits
    • Preview
    • Installation
      • Dependencies
        • Minigames
        • Grouse
        • Server Specific
      • Initial Setup
    • Translations
    • Store MLO's
    • Configuration
      • Creating Stores
      • Adding Cases
      • Server Config
      • Patrols
      • Client Config
      • Doorlock Presets
        • qb-doorlock
        • ox_doorlock
    • Support

Credits

• Holiday95
• QBCore Framework
• MrNewb

Preview

• YouTube Preview

Installation

Dependencies

This script requires the following scripts to be installed:

Minigames

Minigame resources can be configured in client config, by default Glitch Minigames is configured.

• glitch_minigames

Grouse

• gr_lib
• bridge
• gr_blips

Server Specific

Please note, weather resources are optional dependencies.

Framework	Callback	Target	Notify	Doorlock	Weather
qb-core	ox_lib	ox_target	qb-core	ox_doorlock	Renewed-Weathersync
es_extended	gr_lib	qb-target	es_extended	qb-doorlock	qb-weathersync
qbx_core

Resource	Version
qb-core	1.3.0
es_extended	1.13.4
qbx_core	1.23.0
ox_lib	3.30.6
gr_lib	1.1.3
ox_inventory	2.44.8
qb-inventory	2.0.0
ox_target	1.17.2
qb-target	5.5.0
ox_doorlock	1.21.0
qb-doorlock	2.0.0
Renewed-Weathersync	1.1.8
qb-weathersync	2.1.1

Note: TheOrderFiveM's version of ox_doorlock has been tested and is also compatible, regardless of version warnings.

Initial Setup

• Always use the reccomended FiveM artifacts, last tested on 23683.
• Download the latest version from releases.
• Extract the contents of the zip file into your resources folder, into a folder which starts after your framework or;
• Ensure the script in your server.cfg after your framework.

Translations

• Please open an issue for translations, I'll add them in a following update.

Store MLO's

All store locations are for GigZ Jewel Store' except for the base GTA one. It's a free map, but MAKE SURE TO INSTALL THE HEIST VERSION.

Configuration

Creating Stores

• To create a new location, you need to add a table to the table in the store_locations file.

main = {
  coords = vector3(-630.5, -237.13, 38.08),
  doors = {'jewellery-citymain', 'jewellery-citysec'},
  police = 0,
  interior_id = 82690,
  alarms = {
    coords = {vector3(-625.25, -237.57, 41.17), vector3(-629.52, -231.68, 41.17), vector3(-620.44, -225.08, 41.18), vector3(-616.16, -230.97, 41.18)},
    sound = {
      bank = 'ALARM_BELL_02',
      name = 'Bell_02',
      ref = 'ALARMS_SOUNDSET'
    },
    range = 100.0
  },
  thermite = {
    coords = vector3(-596.02, -283.7, 50.4),
    heading = 300.0,
    size = vector3(0.4, 0.8, 1.2)
  },
  hack = {
    coords = vector3(-631.04, -230.63, 38.06),
    heading = 37.0,
    size = vector3(0.4, 0.6, 1.0)
  }
}

Note: Each location table is declared as a named table, and there must be a corresonding table in the jewellery_cases file.

• coords: vector3 - The coords for the store blip.
• doors: string[] - The doors to the store, where index 1 is the main and index 2 is the secondary.
• police: integer - How much police much be present to trigger the heist.
• interior_id: integer - The interior id of the store, used for the store closing warning.
• alarms: {coords: vector3|vector3[], sound: {bank: string, name: string, ref: string}} - Config for the sounds, locations and range.
• thermite: {coords: vector3, heading: number, size: vector3}- Config for the targets and animations.
• hack: {coords: vector3, heading: number, size: vector3}- Config for the targets and animations.

Adding Cases

main = {
  {
    coords = vector3(-627.21, -234.89, 37.65),
    heading = 36.0,
    start_prop = hash_case_start_3,
    end_prop = hash_case_end_3,
    cams = {44, 45}
  }
}

• coords: vector3 - The coords of the cabinet.
• heading: number
• start_prop: integer
• end_prop: integer
• cams: integer|integer[] - Camera IDs (if used) for dispatch alerts.

Server Config

{
  cooldowns = {
    locks = 5,
    cases = 10,
    alarm = 5
  },
  autolock = true,
  patrols = {
    enable = false,
    name = 'gr_patrols'
  },
  hours = {
    open = 9,
    close = 17
  },
  rewards = {
    {item = 'rolex', amount = 1},
    {item = 'diamond_ring', amount = {min = 1, max = 4}},
    {item = 'goldchain', amount = {min = 1, max = 4}}
  }
}

• cooldowns: {locks: integer, cases: integer, alarm: integer} - Cooldown in minutes before reset.
• autolock: boolean - Disable/enable the serverside time locked functionality.
• patrols: {enable: boolean, name: string} - Enable patrols created from Grouse Patrols.
• hours: {open: integer, close: integer}- In 24 hour time.
• rewards: {item: string, amount: integer|{min: integer, max: integer}}- Possible rewards and amounts for a successful case smashed.

Patrols

Please Refer to Grouse Patrols README

Client Config

{
  minigames = {
    thermite = {
      resource = 'glitch-minigames',
      export = 'StartMemoryGame',
      settings = {5, 4, 3, 3000, 10}
    },
    hack = {
      resource = 'glitch-minigames',
      export = 'StartPipePressureGame',
      settings = {6, 30000}
    }
  },
  dispatch = {
    event = true,
    name = 'police:server:policeAlert', -- if event is false, it's uses the exports defined below from this resource. ie 'ps-dispatch'
    suss = {
      export = false -- 'SuspiciousActivity' for exports['ps-dispatch']:SuspiciousActivity()
    },
    case = {
      export = false
    },
    thermite = {
      export = false
    }
  },
  weapons = {
    'weapon_assaultrifle',
    'weapon_carbinerifle',
    'weapon_pumpshotgun',
    'weapon_sawnoffshotgun',
    'weapon_compactrifle',
    'weapon_autoshotgun',
    'weapon_crowbar',
    'weapon_pistol',
    'weapon_pistol_mk2',
    'weapon_combatpistol',
    'weapon_appistol',
    'weapon_pistol50',
    'weapon_microsmg',
  }
}

• minigames: table
  • {thermite: {resource: string, export: string, settings: any[]} - Please refer to your preferred minigames resource documentation.
    • resource: string - Resource name.
    • export: string - Export name.
    • settings: any[] - Parameters to pass to the above export, in the order they are defined in the exports documenation.
  • {hack: {resource: string, export: string, settings: any[]} - Please refer to your preferred minigames resource documentation.
    • resource: string - Resource name.
    • export: string - Export name.
    • settings: any[] - Parameters to pass to the above export, in the order they are defined in the exports documenation.
• dispatch: table
  • event: boolean - Whether your preferred dispatch script uses an event or exports.
  • name: string - Either the event name or export resource name.
  • {suss: {export: boolean}}
  • {case: {export: boolean}}
  • {thermite: {export: boolean}}
• weapons: string[] - Weapons allowed to smash a case.

Doorlock Presets

qb-doorlock

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

Config.DoorList['jewellery-citysec'] = {
  objYaw = 36.000022888184,
  doorRate = 1.0,
  locked = true,
  fixText = false,
  pickable = true,
  authorizedJobs = { ['police'] = 0 },
  needsAllItems = false,
  objCoords = vec3(-629.133850, -230.151703, 38.206585),
  distance = 2.5,
  doorType = 'door',
  objName = 1335309163,
}

Config.DoorList['jewellery-grapemain'] = {
  doorType = 'double',
  locked = true,
  cantUnlock = true,
  doorLabel = 'main',
  distance = 2,
  doors = {
    {objName = 9467943, objYaw = 98.17839050293, objCoords = vec3(1653.285522, 4884.148438, 42.309845)},
    {objName = 1425919976, objYaw = 98.17839050293, objCoords = vec3(1653.655518, 4881.573730, 42.309845)}
  },
  doorRate = 1.0,
}

Config.DoorList['jewellery-grapesec'] = {
  pickable = true,
  objCoords = vec3(1648.274902, 4877.423340, 42.309898),
  objName = 1335309163,
  doorRate = 1.0,
  distance = 2.5,
  authorizedJobs = { ['police'] = 0 },
  doorType = 'door',
  objYaw = 188.17839050293,
  fixText = false,
  doorLabel = 'sec',
  locked = true,
}

Config.DoorList['jewellery-palmain'] = {
  doorType = 'double',
  locked = true,
  cantUnlock = true,
  doorLabel = 'main',
  distance = 2,
  doors = {
    {objName = 1425919976, objYaw = 314.90930175781, objCoords = vec3(-383.837921, 6044.059082, 31.658920)},
    {objName = 9467943, objYaw = 314.90930175781, objCoords = vec3(-382.001617, 6042.216797, 31.658920)}
  },
  doorRate = 1.0,
}

Config.DoorList['jewellery-palsec'] = {
  doorType = 'door',
  locked = true,
  doorRate = 1.0,
  pickable = true,
  distance = 2.5,
  objYaw = 44.909275054932,
  fixText = false,
  authorizedJobs = { ['police'] = 0 },
  objCoords = vec3(-382.007721, 6050.603027, 31.658974),
  objName = 1335309163,
}

ox_doorlock

If using a default Qbox server, the main Vangelico store door will already be configured as vangelico_jewellery, so you only need to add the other 5 doors. You can change the door names as you like, just make sure to update the store_locations file accordingly.

Create a file in ox_doorlock/convert/ with the following code:

Config.DoorList['jewellery-citysec'] = {
  objYaw = 36.000022888184,
  doorRate = 1.0,
  locked = true,
  fixText = false,
  pickable = true,
  authorizedJobs = { ['police'] = 0 },
  needsAllItems = false,
  objCoords = vec3(-629.133850, -230.151703, 38.206585),
  distance = 2.5,
  doorType = 'door',
  objName = 1335309163,
}

Config.DoorList['jewellery-grapemain'] = {
  doorType = 'double',
  locked = true,
  cantUnlock = true,
  doorLabel = 'main',
  distance = 2,
  doors = {
    {objName = 9467943, objYaw = 98.17839050293, objCoords = vec3(1653.285522, 4884.148438, 42.309845)},
    {objName = 1425919976, objYaw = 98.17839050293, objCoords = vec3(1653.655518, 4881.573730, 42.309845)}
  },
  doorRate = 1.0,
}

Config.DoorList['jewellery-grapesec'] = {
  pickable = true,
  objCoords = vec3(1648.274902, 4877.423340, 42.309898),
  objName = 1335309163,
  doorRate = 1.0,
  distance = 2.5,
  authorizedJobs = { ['police'] = 0 },
  doorType = 'door',
  objYaw = 188.17839050293,
  fixText = false,
  doorLabel = 'sec',
  locked = true,
}

Config.DoorList['jewellery-palmain'] = {
  doorType = 'double',
  locked = true,
  cantUnlock = true,
  doorLabel = 'main',
  distance = 2,
  doors = {
    {objName = 1425919976, objYaw = 314.90930175781, objCoords = vec3(-383.837921, 6044.059082, 31.658920)},
    {objName = 9467943, objYaw = 314.90930175781, objCoords = vec3(-382.001617, 6042.216797, 31.658920)}
  },
  doorRate = 1.0,
}

Config.DoorList['jewellery-palsec'] = {
  doorType = 'door',
  locked = true,
  doorRate = 1.0,
  pickable = true,
  distance = 2.5,
  objYaw = 44.909275054932,
  fixText = false,
  authorizedJobs = { ['police'] = 0 },
  objCoords = vec3(-382.007721, 6050.603027, 31.658974),
  objName = 1335309163,
}

Support

• Join the Grouse Labs 🐀 discord.
• Use the appropriate support forum!