> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectx.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Step by step instructions to install the Default Vangelico Jewelry Heist resource

## Installation Steps

**1. Install required dependencies**

> [!WARNING]
>
> Verify all dependencies below are started **before** this script in your `server.cfg`.

> **[ox\_lib](https://github.com/CommunityOx/ox_lib/releases/latest)**
>
> Download ox\_lib

> **[projectx-bridge](/resources/bridge/installation)**
>
> Required Project X Bridge

> [!NOTE]
>
> This variant uses the **vanilla GTA** Vangelico jewelry store. No third-party map is required.

**2. Install minigames**

> **[Minigames](https://drive.google.com/file/d/1iKCqatUQzbNU8Eu6Oag5P_3RE6gzK6UY/view?usp=sharing)**
>
> Download and place in your standalone or minigames folder

> [!WARNING]
>
> Minigames must **not** live in the same folder as the heist script.

**3. Extract and place the resource**

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

**4. Add items to your inventory**

Add items and images from the script `images` folder. See [Items Required](#items-required).

> [!NOTE]
>
> Item images by [Artwork Inventory](https://discord.gg/Z2awpnXKdw) — code **ProjectX** for 10% off.

**5. 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'`.

**6. Add to server.cfg**

```cfg theme={null}
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**

```lua theme={null}
["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.

**qb-inventory**

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.