Installation

Installation Steps

Install required dependencies

Verify all dependencies below are started before this script in your server.cfg.

ox_lib

Download ox_lib

projectx-bridge

Required Project X Bridge

This variant uses the vanilla GTA Vangelico jewelry store. No third-party map is required.

Install minigames

Minigames

Download and place in your standalone or minigames folder

Minigames must not live in the same folder as the heist script.

Extract and place the resource

Extract the script from the zip and place it in your resources folder.

Add items to your inventory

Add items and images from the script images folder. See Items Required.

Item images by Artwork Inventory — code ProjectX for 10% off.

Configure the resource

Edit config/config.lua for rewards, dispatch timing, and approach toggles. Framework, inventory, and dispatch are handled by the bridge when set to 'auto'.

Add to server.cfg

ensure ox_lib
ensure projectx-bridge

ensure utk_fingerprint
ensure SN-Hacking
ensure lightsout
ensure simonsays

ensure projectx-vangelicoheist-default

Items Required

External progression

glass_cutter

Shop / black market

x_device
x_phone
pliers
bag

Loot items (add with images from the resource)

Rings, necklaces, earrings (diamond_*, ruby_*, sapphire_*, emerald_*), plus giant_gem as configured in Config.DisplayRewards, Config.VitrineRewards, and Config.GemReward.

ox_inventory
qb-inventory

["glass_cutter"] = { label = "Glass Cutter", weight = 1000, stack = false, close = false, description = "" },
["x_device"] = { label = "X Device", weight = 125, stack = false, close = false, description = "?????????" },
["x_phone"] = { label = "x Phone", weight = 300, stack = false, close = false, description = "?????????" },
["pliers"] = { label = "Pliers", weight = 125, stack = false, close = false, description = "A pair of pliers" },
["bag"] = { label = "Duffel Bag", weight = 250, stack = false, close = false, description = "Duffel bag" },
["giant_gem"] = { label = "Giant Gem", weight = 2500, stack = false, close = false, description = "" },

Add remaining jewelry items from the resource PLEASE-README.md or your sell shop config.

See the full qb-inventory block in the resource PLEASE-README.md for all jewelry loot definitions.

Getting Started

Project X Bridge

Paid Resources

Free Resources

Installation Steps

ox_lib

projectx-bridge

Minigames

Items Required

External progression

Shop / black market

Loot items (add with images from the resource)

​Installation Steps

ox_lib

projectx-bridge

Minigames

​Items Required

​External progression

​Shop / black market

​Loot items (add with images from the resource)

Installation Steps

Items Required

External progression

Shop / black market

Loot items (add with images from the resource)