# nn\_heistcreator

## nn\_heistcreator

### The Ultimate Heist Creation System for FiveM

With Nano Scripts' Heist Creator, you can design, build, and deploy fully custom heists anywhere on the GTA map — all from an intuitive in-game visual editor. Chain together nodes like hacking minigames, guard spawns, loot objectives, thermite breaches, ATM rope robberies, and more using a drag-and-drop flow graph. Players progress through a built-in skill tree, acquire equipment via dynamic missions (dead drops, shipment hijacks, container raids), and tackle heists solo or with up to 4 players using the multiplayer lobby system — powered by the in-game DarkPhone.

***

#### Features

* **Visual Heist Editor** — A full node-based graph editor (React Flow) to design heist sequences in-game. Place nodes, connect them, set coordinates with a precision placement tool, and export/import heist templates as JSON.
* **40+ Node Types** — Guards, NPCs, doors, vaults, hacking minigames (GTAV hack, wire connect, maze runner, safe cracker, voltlab, firewall breach, reaction test, OSU lockpick), explosions, alarms, loot (cash/gold/diamonds/coke trolleys, jewellery cases, paintings, chests, safes, glass cutting, custom props, containers), thermite breaches, keycard scanners, ATM rope robberies, teleportation, interiors/shells, cutscenes, custom events, and more.
* **7 Built-in Minigames** — Hacking, Connect Wires, Maze Runner, Safe Cracker, OSU Lockpick, Reaction Test, Hack Firewall, and Voltlab Panel Hack — each with easy/medium/hard difficulty and configurable timers.
* **Equipment & Acquisition Missions** — Players must obtain equipment (drills, thermite, access cards, lockpicks, glass cutters, C4, bolt cutters, USB drives, crowbars, ropes) through dynamic mission flows: Dead Drops, Supplier Meetings, Shipment Hijacks, Stealth Thefts, Contraband Trades, Component Assembly, and Container Yard Raids.
* **Skill Tree System** — Three branches (Hacking, Stealth, Heist) with 25+ unlockable skills that affect minigame difficulty, alarm delays, loot bonuses, drilling speed, and more.
* **Multiplayer Lobbies** — Up to 4 players per heist with role assignment (Leader, Hacker, Muscle, Lookout). Invite nearby players, coordinate roles, and execute together.
* **DarkPhone** — In-game phone item for accessing heists, the skill tree, and equipment missions.
* **Container Raid System** — Full guarded container yard raids with angle grinder cutting, synced loot animations, configurable guard spawns, and per-site layouts.
* **ATM Rope Robbery** — Attach a rope to an ATM, rip it out with a vehicle, then drill it open. Configurable rip times per difficulty.
* **Difficulty Tiers** — Easy, Medium, Hard, Expert, and Hacker. Configurable rewards per tier.
* **Fully Configurable** — All translations, UI text, node schemas, equipment items, mission locations, skill trees, rewards, NPC/vehicle models, and cooldowns are exposed in config files.
* **Framework Agnostic** — Uses `community_bridge` for framework, inventory, notifications, progress bars, and target systems. Works with ESX, QBCore, QBox, and more.
* **Import / Export** — Share heist templates as JSON. Import community-made heists instantly.

***

#### Common Questions

<details>

<summary><strong>Does it work with any framework?</strong></summary>

Yes. The script uses `community_bridge` which supports ESX, QBCore, QBox, and other popular frameworks out of the box.

</details>

<details>

<summary><strong>Can I create multiple heists?</strong></summary>

Yes. You can create unlimited heists anywhere on the map. Each heist is a separate template stored in the database.

</details>

<details>

<summary><strong>Does it work with custom MLOs?</strong></summary>

Yes. The visual editor lets you place nodes at exact coordinates, so you can build heists inside any MLO or interior.

</details>

<details>

<summary><strong>Can I add my own minigames or node types?</strong></summary>

The node schema system is fully configurable in the config files. You can add new node types with custom fields, icons, and behavior.

</details>

<details>

<summary><strong>Is multiplayer supported?</strong></summary>

Yes. Heists support up to 4 players with role assignment (Leader, Hacker, Muscle, Lookout) and a lobby/invite system.

</details>

<details>

<summary><strong>Can players share heist templates?</strong></summary>

Yes. The editor has built-in Export and Import buttons. Heist templates are exported as JSON and can be shared and imported by anyone.

</details>

<details>

<summary><strong>What inventory systems are supported?</strong></summary>

Any inventory supported by `community_bridge` — including ox\_inventory, qb-inventory, qs-inventory, and more.

</details>


---

# Agent Instructions: 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:

```
GET https://nanoscripts.gitbook.io/docs/scripts/nn_heistcreator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.