> For the complete documentation index, see [llms.txt](https://nanoscripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nanoscripts.gitbook.io/docs/scripts/nn_heistcreator.md).

# 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>