> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/bank-truck-robbery-4-in-1.md).

# Bank Truck Robbery - 4 in 1!

<figure><img src="/files/KM2K7GzqTTaP1fvgYGdL" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Pre-Installation Note**

This guide assumes you already know how to manage a FiveM server (start resources, edit configs). Following the steps out of order is the most common cause of errors.

**Support**

If something isn't working after you've followed every step, open a ticket in our [Discord](https://discord.gg/rainmad) with your server console output. Don't skip the [Installation](/resources/bank-truck-robbery-4-in-1/installation.md) and [Dependencies](/resources/bank-truck-robbery-4-in-1/dependencies.md) pages.
{% endhint %}

Bank Truck Robbery is a rolling heist. Armoured trucks patrol the city with an armed crew; players either hunt one down themselves or buy its current location from a mission NPC. Stopping a truck means killing the driver, and the crew fights back the whole way: the front passenger returns fire through the window, the truck runs once its driver goes down, and two more guards are waiting in the back.

The rear safe opens four ways. A portable drill grinds through the door hinges by hand, and three placeable devices (C4, a hack device, a gas tank) each open it on their own timer. Every device is positioned by the player against a live preview before it arms.

It works on QBCore/Qbox and ESX (auto-detected); target, notifications, text UI, minigames, vehicle keys and dispatch all bridge to whatever resources you already run.

## Features

* **Four ways in:** a portable drill grinds through the hinges by hand while the crew shoots back, or place C4, a hack device or a gas tank and take cover until it opens. Each device is aimed against a ghosted preview with free movement on all three axes before it arms.
* **The truck fights and runs:** the front guard returns fire from the passenger seat, and the driver switches to an aggressive driving style the moment shots are fired. Kill the driver and the passenger shuffles across to take the wheel, and the truck keeps running.
* **Crew that remembers you:** anyone who damages the truck or its guards is remembered for the rest of the job, along with everyone riding in their vehicle. Guards attack those players specifically instead of losing interest the moment you break line of sight, and they come after you again after a respawn.
* **Rear guards:** two more guards ride in the back, silent until the safe is breached. They stay put through a gassing or an explosion; drill or hack your way in and they come out shooting.
* **Find it or buy it:** trucks can be hunted on the streets, or a mission NPC sells the current location and tracks it live on the GPS for a configurable window. Auto-spawn is optional, and so is gating the location behind items.
* **Shared payout:** several players can work the same safe. The timer starts with the first collector and the money splits between everyone who joined before it ran out.
* **Black money support:** the reward and every shop price can use `black_money`; how your server stores it (plain item, framework account or marked bills) is configured once in `cfg.blackMoney`.
* **Dispatch integration:** separate alert chances for killing the driver and for opening the safe; 18 dispatch/MDT adapters ship open.
* **Server-authoritative:** spawns, drilling progress, device placement, collection and every payout are validated server-side, including how close the player actually is to the truck.
* **Cooldowns & gating:** per-player cooldown after a safe is opened, a spawn cooldown between location buys, minimum police count, and a lockdown export for your own emergency toggles.
* **Discord logging:** purchases and payouts route through a customer-editable file with a single webhook.

## Dependencies

A framework, `ox_lib` and `rm_tools` are required. See the full list on the [Dependencies](/resources/bank-truck-robbery-4-in-1/dependencies.md) page before installing.
