> For the complete documentation index, see [llms.txt](https://izzyshop-1.gitbook.io/izzyshop-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://izzyshop-1.gitbook.io/izzyshop-docs/izzyshop-resources/izzy-illegaljob/configuration.md).

# Configuration

Illegal jobs progression: heists, drug activity, robberies, and a black-market shop — configured in shared/cfg.lua.

{% hint style="info" %}
ESX, QBCore, and QBox with auto framework detection. Requires ox\_lib, oxmysql; ox\_target or qb-target optional for interactions.
{% endhint %}

### General settings <a href="#izzy-illegaljob-general-settings" id="izzy-illegaljob-general-settings"></a>

| Parameter                | Type    | Description                                     |
| ------------------------ | ------- | ----------------------------------------------- |
| `cfg.debug`              | boolean | Debug logging when `true`                       |
| `cfg.lang`               | string  | Locale: `"en"`, `"tr"`                          |
| `cfg.expPerLevel`        | number  | XP required per level (default example: `1000`) |
| `cfg.inventoryImagePath` | string  | Base path for inventory item images             |

### NPC menu (`cfg.illegalMenu`) <a href="#izzy-illegaljob-npc-menu" id="izzy-illegaljob-npc-menu"></a>

| Parameter   | Type    | Description                                                |
| ----------- | ------- | ---------------------------------------------------------- |
| `pedCoords` | vector4 | NPC position (example: `-1321.58, -1264.33, 3.59, 296.25`) |
| `pedModel`  | string  | Ped model (example: `"s_m_m_doctor_01"`)                   |

### Jobs (`cfg.illegalMenu.jobs`) <a href="#izzy-illegaljob-jobs" id="izzy-illegaljob-jobs"></a>

| #  | Job              | Required level | Price   | XP    |
| -- | ---------------- | -------------- | ------- | ----- |
| 1  | Stealing vehicle | 0              | $10,000 | 500   |
| 2  | Weed creation    | 2              | $10,000 | 500   |
| 3  | Meth creation    | 3              | $10,000 | 500   |
| 4  | Drug selling     | 4              | $10,000 | 500   |
| 5  | ATM robbery      | 5              | $10,000 | 500   |
| 6  | Market robbery   | 6              | $10,000 | 500   |
| 7  | Wash money       | 7              | $10,000 | 500   |
| 8  | Laptop hacking   | 8              | $10,000 | 500   |
| 9  | Safe robbery     | 9              | $10,000 | 500   |
| 10 | Jewelry robbery  | 10             | $10,000 | 500   |
| 11 | Bank robbery     | 11             | $10,000 | 500   |
| 12 | Bobcat heist     | 12             | $25,000 | 800   |
| 13 | Humane Labs      | 13             | $30,000 | 1,000 |
| 14 | Submarine heist  | 14             | $35,000 | 1,200 |
| 15 | Substance X      | 15             | $40,000 | 1,500 |

### Shop (`cfg.illegalMenu.shop`) <a href="#izzy-illegaljob-shop" id="izzy-illegaljob-shop"></a>

| Item              | Spawn name             | Price   | Level | Notes                   |
| ----------------- | ---------------------- | ------- | ----- | ----------------------- |
| Lockpick          | `izzy_lockpick`        | $500    | 1     | Vehicle lockpicking     |
| Stethoscope       | `izzy_stethoscope`     | $1,500  | 5     | Safe cracking           |
| Hacker laptop     | `izzy_laptop`          | $5,000  | 8     | Card data theft         |
| Wash tablet       | `izzy_tablet`          | $3,000  | 7     | Money washing           |
| ATM screwdriver   | `izzy_atm_screwdriver` | $300    | 5     | Open ATM panel          |
| ATM drill         | `izzy_atm_drill`       | $800    | 5     | Drill ATM               |
| Weed seed         | `izzy_weed_seed`       | $200    | 2     | Planting                |
| Empty bag         | `izzy_empty_bag`       | $100    | 2     | Weed bagging            |
| Thermite          | `izzy_thermite`        | $8,000  | 12    | Reinforced door breach  |
| Advanced thermite | `izzy_thermitec`       | $12,000 | 12    | Military-grade thermite |
| Security card     | `izzy_security_card`   | $15,000 | 12    | Bobcat access card      |
| Hack laptop       | `izzy_hack_laptop`     | $20,000 | 13    | Humane Labs hack        |
| Personnel card    | `izzy_personnel_card`  | $10,000 | 13    | Humane Labs staff card  |
| Diving gear       | `izzy_diving_gear`     | $5,000  | 13    | Underwater entry        |
| Pseudoephedrine   | `izzy_pseudo`          | $1,500  | 3     | Meth ingredient         |
| Muriatic acid     | `izzy_acid`            | $2,000  | 3     | Meth ingredient         |
| Catalyst          | `izzy_catalyst`        | $2,500  | 3     | Meth ingredient         |
| Solvent           | `izzy_solvent`         | $1,800  | 3     | Meth ingredient         |

### Sell (`cfg.illegalMenu.sell`) <a href="#izzy-illegaljob-sell" id="izzy-illegaljob-sell"></a>

| Item            | Spawn name        | Min price | Max price | Level |
| --------------- | ----------------- | --------- | --------- | ----- |
| ATM case        | `izzy_atm_case`   | $5        | $50,000   | 5     |
| Jewelry         | `izzy_jewelry`    | $500      | $3,000    | 10    |
| Stolen painting | `izzy_painting`   | $5,000    | $15,000   | 10    |
| Virus tube      | `izzy_virus_tube` | $10,000   | $25,000   | 13    |

### Vehicle lockpick (`lockpickVehicle`) <a href="#izzy-illegaljob-lockpick-vehicle" id="izzy-illegaljob-lockpick-vehicle"></a>

| Parameter     | Type    | Default | Description              |
| ------------- | ------- | ------- | ------------------------ |
| `enabled`     | boolean | `true`  | Feature on/off           |
| `maxFails`    | number  | `3`     | Max failed attempts      |
| `maxDistance` | number  | `3.0`   | Max interaction distance |
| `expMin`      | number  | `50`    | Min XP reward            |
| `expMax`      | number  | `150`   | Max XP reward            |

### Market safe (`marketSafe`) <a href="#izzy-illegaljob-market-safe" id="izzy-illegaljob-market-safe"></a>

| Parameter       | Type    | Default               | Description                     |
| --------------- | ------- | --------------------- | ------------------------------- |
| `enabled`       | boolean | `true`                | Feature on/off                  |
| `requiredLevel` | number  | `5`                   | Required player level           |
| `maxDistance`   | number  | `1.5`                 | Interaction distance            |
| `moneyMin`      | number  | `500`                 | Min cash reward                 |
| `moneyMax`      | number  | `2,000`               | Max cash reward                 |
| `cooldown`      | number  | `300000`              | Per-player cooldown (ms, 5 min) |
| `safeRespawn`   | number  | `600000`              | Safe respawn (ms, 10 min)       |
| `policeChance`  | number  | `50`                  | Dispatch chance (%)             |
| `models`        | table   | `prop_ld_int_safe_01` | Safe prop models                |

**Locations:** 19 convenience stores around Los Santos with safes.

### Cash register robbery (`registerRobbery`) <a href="#izzy-illegaljob-register-robbery" id="izzy-illegaljob-register-robbery"></a>

| Parameter         | Type    | Default                        | Description                |
| ----------------- | ------- | ------------------------------ | -------------------------- |
| `enabled`         | boolean | `true`                         | Feature on/off             |
| `requiredLevel`   | number  | `6`                            | Required level             |
| `moneyMin`        | number  | `100`                          | Min payout                 |
| `moneyMax`        | number  | `750`                          | Max payout                 |
| `cooldown`        | number  | `180000`                       | Cooldown (ms, 3 min)       |
| `registerRespawn` | number  | `300000`                       | Register reset (ms, 5 min) |
| `policeChance`    | number  | `60`                           | Dispatch chance (%)        |
| `models`          | table   | `prop_till_01`, `prop_till_02` | Till props                 |

### ATM robbery (`atmRobbery`) <a href="#izzy-illegaljob-atm-robbery" id="izzy-illegaljob-atm-robbery"></a>

| Parameter       | Type    | Default        | Description            |
| --------------- | ------- | -------------- | ---------------------- |
| `enabled`       | boolean | `true`         | Feature on/off         |
| `requiredLevel` | number  | `5`            | Required level         |
| `caseCount`     | number  | `1`            | Cases per robbery      |
| `cooldown`      | number  | `300000`       | Cooldown (ms, 5 min)   |
| `atmRespawn`    | number  | `900000`       | ATM reset (ms, 15 min) |
| `policeChance`  | number  | `70`           | Dispatch chance (%)    |
| `drillDuration` | number  | `15000`        | Drill duration (ms)    |
| `models`        | table   | (5 ATM models) | Supported ATM props    |

### Laptop hack (`laptop`) <a href="#izzy-illegaljob-laptop" id="izzy-illegaljob-laptop"></a>

| Parameter        | Type    | Default  | Description                     |
| ---------------- | ------- | -------- | ------------------------------- |
| `enabled`        | boolean | `true`   | Feature on/off                  |
| `requiredLevel`  | number  | `8`      | Required level                  |
| `cooldown`       | number  | `300000` | Cooldown (ms, 5 min)            |
| `moneyMin`       | number  | `2,000`  | Min payout (dirty/clean choice) |
| `moneyMax`       | number  | `8,000`  | Max payout                      |
| `commission`     | number  | `0.15`   | Fee rate (15%)                  |
| `policeChance`   | number  | `30`     | Dispatch chance (%)             |
| `cardBalanceMin` | number  | `50`     | Card min balance                |
| `cardBalanceMax` | number  | `1,000`  | Card max balance                |

### Tablet — money wash (`tablet`) <a href="#izzy-illegaljob-tablet" id="izzy-illegaljob-tablet"></a>

| Parameter       | Type    | Default  | Description          |
| --------------- | ------- | -------- | -------------------- |
| `enabled`       | boolean | `true`   | Feature on/off       |
| `requiredLevel` | number  | `7`      | Required level       |
| `cooldown`      | number  | `300000` | Cooldown (ms, 5 min) |
| `commission`    | number  | `0.15`   | Fee (15%)            |
| `policeChance`  | number  | `25`     | Dispatch chance (%)  |
| `minWash`       | number  | `50`     | Minimum wash amount  |
| `maxWash`       | number  | `50,000` | Maximum wash amount  |

### Weed growing (`weedGrowing`) <a href="#izzy-illegaljob-weed-growing" id="izzy-illegaljob-weed-growing"></a>

| Parameter       | Type    | Default | Description          |
| --------------- | ------- | ------- | -------------------- |
| `enabled`       | boolean | `true`  | Feature on/off       |
| `requiredLevel` | number  | `2`     | Required level       |
| `growDuration`  | number  | `15000` | Growth time (ms)     |
| `seedYieldMin`  | number  | `1`     | Min harvest          |
| `seedYieldMax`  | number  | `5`     | Max harvest          |
| `bagCapacity`   | number  | `7`     | Bag capacity         |
| `cooldown`      | number  | `60000` | Cooldown (ms, 1 min) |

### Meth cooking (`methCooking`) <a href="#izzy-illegaljob-meth-cooking" id="izzy-illegaljob-meth-cooking"></a>

| Parameter       | Type    | Default         | Description          |
| --------------- | ------- | --------------- | -------------------- |
| `enabled`       | boolean | `true`          | Feature on/off       |
| `requiredLevel` | number  | `3`             | Required level       |
| `vehicleModel`  | hash    | `toljourney`    | Caravan model        |
| `holdTime`      | number  | `2000`          | Hold H duration (ms) |
| `cookDuration`  | number  | `8000`          | Cook time (ms)       |
| `cooldown`      | number  | `300000`        | Cooldown (ms, 5 min) |
| `policeChance`  | number  | `40`            | Dispatch chance (%)  |
| `rewardItem`    | string  | `izzy_meth_bag` | Reward item          |
| `rewardMin`     | number  | `1`             | Min bags             |
| `rewardMax`     | number  | `3`             | Max bags             |

**Ingredients (order):**

| Order | ID       | Item            | Prop                            |
| ----- | -------- | --------------- | ------------------------------- |
| 1     | pseudo   | `izzy_pseudo`   | `prop_cs_pills`                 |
| 2     | acid     | `izzy_acid`     | `tr_prop_meth_hcacid`           |
| 3     | catalyst | `izzy_catalyst` | `prop_cs_spray_can`             |
| 4     | solvent  | `izzy_solvent`  | `xm3_prop_xm3_bottle_pills_01a` |

**Stages:** (1) Mixing — add ingredients in order with **E**. (2) Cooking — timer + flame FX. (3) Plating — tray on counter with **E** (empty → full). (4) Smashing — crush with **E**. (5) Packaging — NUI minigame (`grabmeth`). (6) Complete — meth bag to inventory.

### Jewelry robbery (`jewelryRobbery`) <a href="#izzy-illegaljob-jewelry-robbery" id="izzy-illegaljob-jewelry-robbery"></a>

| Parameter       | Type    | Default  | Description           |
| --------------- | ------- | -------- | --------------------- |
| `enabled`       | boolean | `true`   | Feature on/off        |
| `requiredLevel` | number  | `10`     | Required level        |
| `maxPlayers`    | number  | `4`      | Max participants      |
| `cooldown`      | number  | `900000` | Cooldown (ms, 15 min) |
| `policeChance`  | number  | `95`     | Dispatch chance (%)   |

**Display case drops:**

| Chance | Min qty | Max qty | Item           |
| ------ | ------- | ------- | -------------- |
| 40%    | 1       | 4       | `izzy_jewelry` |
| 30%    | 2       | 5       | `izzy_jewelry` |
| 20%    | 3       | 6       | `izzy_jewelry` |
| 10%    | 4       | 8       | `izzy_jewelry` |

**Paintings:** `izzy_painting` ×1 per painting (25 XP each); 4 paintings.

**Flow:** Cut power at the transformer (electrical minigame) → enter store → shoot display cases → cut paintings from walls.

### Bank robbery (`bankRobbery`) <a href="#izzy-illegaljob-bank-robbery" id="izzy-illegaljob-bank-robbery"></a>

| Parameter        | Type    | Default              | Description            |
| ---------------- | ------- | -------------------- | ---------------------- |
| `enabled`        | boolean | `true`               | Feature on/off         |
| `requiredLevel`  | number  | `11`                 | Required level         |
| `hackItem`       | string  | `izzy_laptop`        | Required hack item     |
| `moneyPerStack`  | number  | `150`                | Cash per trolley stack |
| `cooldown`       | number  | `3600000`            | Cooldown (ms, 60 min)  |
| `policeRequired` | number  | `0`                  | Minimum police online  |
| `policeChance`   | number  | `80`                 | Dispatch chance (%)    |
| `hackMinigames`  | table   | electrical, wiregame | Hack sequence types    |

**Branches (6):** Pillbox `147.25, -1046.26`, Vinewood `311.59, -284.63`, Hardwick `-353.48, -55.48`, Del Perro `-1210.42, -336.43`, Pacific/Ocean `-2956.5, 482.06`, Route 66 `1175.62, 2712.91`.

### Bobcat heist (`bobcatHeist`) <a href="#izzy-illegaljob-bobcat-heist" id="izzy-illegaljob-bobcat-heist"></a>

| Parameter       | Type    | Default              | Description         |
| --------------- | ------- | -------------------- | ------------------- |
| `enabled`       | boolean | `true`               | Feature on/off      |
| `requiredLevel` | number  | `12`                 | Required level      |
| `cooldown`      | number  | `7200000`            | Cooldown (ms, 2 h)  |
| `policeChance`  | number  | `90`                 | Dispatch chance (%) |
| `thermiteItem`  | string  | `izzy_thermite`      | Standard thermite   |
| `thermitecItem` | string  | `izzy_thermitec`     | Advanced thermite   |
| `securityCard`  | string  | `izzy_security_card` | Interior card       |

**Weapon loot:** `weapon_combatpistol`, `weapon_assaultrifle`, `weapon_smg`, `weapon_heavypistol`, `weapon_carbinerifle`, `weapon_machinepistol`, `weapon_pistol` — 1–3 per crate.

**Flow:** Thermite first door → thermite second door → swipe third door → deal with guards → rescue hostage → loot weapon crates.

### Humane Labs (`humanLabs`) <a href="#izzy-illegaljob-human-labs" id="izzy-illegaljob-human-labs"></a>

| Parameter       | Type    | Default               | Description              |
| --------------- | ------- | --------------------- | ------------------------ |
| `enabled`       | boolean | `true`                | Feature on/off           |
| `requiredLevel` | number  | `13`                  | Required level           |
| `cooldown`      | number  | `1800000`             | Cooldown (ms, 30 min)    |
| `doorTimer`     | number  | `120000`              | Door open duration (ms)  |
| `guideNotify`   | boolean | `false`               | Step-by-step hints       |
| `policeChance`  | number  | `90`                  | Dispatch chance (%)      |
| `hackLaptop`    | string  | `izzy_hack_laptop`    | Hack item                |
| `personnelCard` | string  | `izzy_personnel_card` | Staff card               |
| `divingGear`    | string  | `izzy_diving_gear`    | Tunnel entry gear        |
| `rewardItem`    | string  | `izzy_virus_tube`     | Loot item                |
| `rewardCount`   | number  | `4`                   | Reward amount            |
| `hackMinigames` | table   | electrical, wiregame  | <p></p><p>Hack types</p> |

**Flow:** Enter via underwater tunnel (diving gear) → hack terminal → elevator to lab → collect virus tube → elevator out.

### Submarine heist (`submarineHeist`) <a href="#izzy-illegaljob-submarine-heist" id="izzy-illegaljob-submarine-heist"></a>

| Parameter         | Type    | Default   | Description           |
| ----------------- | ------- | --------- | --------------------- |
| `enabled`         | boolean | `true`    | Feature on/off        |
| `cooldown`        | number  | `3600000` | Cooldown (ms, 60 min) |
| `hackMaxAttempts` | number  | `2`       | Max hack tries        |
| `cashMin`         | number  | `15,000`  | Min cash              |
| `cashMax`         | number  | `25,000`  | Max cash              |
| `enableShake`     | boolean | `true`    | Camera shake FX       |

**Guards:** Model `s_m_m_pilot_02`, health 400, accuracy \~35%, weapon combat pistol, 34 spawns across 3 decks.

### Substance X (`substanceX`) <a href="#izzy-illegaljob-substance-x" id="izzy-illegaljob-substance-x"></a>

| Parameter               | Type    | Default      | Description                 |
| ----------------------- | ------- | ------------ | --------------------------- |
| `enabled`               | boolean | `true`       | Feature on/off              |
| `requiredLevel`         | number  | `15`         | Required level              |
| `cooldown`              | number  | `7200`       | Cooldown (**seconds**, 2 h) |
| `policeChance`          | number  | `85`         | Dispatch chance (%)         |
| `activationRadius`      | number  | `80.0`       | Activation radius           |
| `crateMinigame`         | string  | `electrical` | Crate minigame type         |
| `crateMinigameDuration` | number  | `12000`      | Minigame duration (ms)      |

| Item                     | Min | Max | Chance (%) |
| ------------------------ | --- | --- | ---------- |
| `izzy_substance_x`       | 2   | 5   | 60         |
| `izzy_chemical_compound` | 1   | 3   | 30         |
| `izzy_lab_sample`        | 1   | 2   | 10         |

**Guards:** `s_m_y_blackops_01`, HP 300, armor 100, accuracy \~30%, carbine rifle, 13 spawns.

### Drug selling (`drugSelling`) <a href="#izzy-illegaljob-drug-selling" id="izzy-illegaljob-drug-selling"></a>

| Parameter        | Type    | Default | Description            |
| ---------------- | ------- | ------- | ---------------------- |
| `enabled`        | boolean | `true`  | Feature on/off         |
| `requiredLevel`  | number  | `4`     | Required level         |
| `cooldown`       | number  | `60000` | Per-zone cooldown (ms) |
| `policeChance`   | number  | `25`    | Dispatch chance (%)    |
| `targetDistance` | number  | `2.0`   | NPC interaction range  |

**Sellable items:**

| Drug              | Spawn name               | Min $ | Max $ |
| ----------------- | ------------------------ | ----- | ----- |
| Weed              | `izzy_weed_bag`          | 50    | 200   |
| Meth              | `izzy_meth_bag`          | 150   | 500   |
| Substance X       | `izzy_substance_x`       | 300   | 800   |
| Chemical compound | `izzy_chemical_compound` | 200   | 500   |
| Lab sample        | `izzy_lab_sample`        | 400   | 1,000 |

**Zones (5):** Legion Square `126.42, -1039.78`, Del Perro Pier `-1171.47, -1572.72`, Strawberry `296.55, -1060.83`, Davis `-47.62, -1757.86`, Mirror Park `1163.18, -323.85`.

**Buyer personalities:**

| Type     | Notes                    | Price mult | Buy % | Police % |
| -------- | ------------------------ | ---------- | ----- | -------- |
| Generous | Pays well                | ×1.3       | 90    | 5        |
| Normal   | Baseline                 | ×1.0       | 75    | 15       |
| Cheap    | Low offer                | ×0.6       | 80    | 10       |
| Paranoid | Nervous, may call police | ×0.8       | 50    | 40       |
| Junkie   | Desperate buyer          | ×0.5       | 95    | 5        |
| Snitch   | High police chance       | ×1.0       | 30    | 70       |

### Minigame durations (`minigames`) <a href="#izzy-illegaljob-minigames" id="izzy-illegaljob-minigames"></a>

| Minigame    | Duration |
| ----------- | -------- |
| Lockpick    | 30 s     |
| Electrical  | 30 s     |
| Laptop hack | 10 min   |
| Safecrack   | 60 s     |
| Wiregame    | 30 s     |
| Grab weed   | 30 s     |
| Grab meth   | 30 s     |
| Wash game   | 2 min    |

### SQL tables <a href="#izzy-illegaljob-sql-tables" id="izzy-illegaljob-sql-tables"></a>

| Table                        | Columns                             | Purpose               |
| ---------------------------- | ----------------------------------- | --------------------- |
| `izzy_illegaljob_levels`     | identifier, level, exp              | Per-player level / XP |
| `izzy_illegaljob_dirtymoney` | id, identifier, amount, created\_at | Dirty money ledger    |

### Locales <a href="#izzy-illegaljob-i18n" id="izzy-illegaljob-i18n"></a>

| Language | Code |
| -------- | ---- |
| English  | `en` |
| Turkish  | `tr` |

**Translation groups:** `ui` (UI labels), `notify` (toasts), `hlab_*` (Humane Labs), `bobcat_*` (Bobcat heist).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://izzyshop-1.gitbook.io/izzyshop-docs/izzyshop-resources/izzy-illegaljob/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.