> For the complete documentation index, see [llms.txt](https://madcap.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://madcap.gitbook.io/docs/premium-resources/mad-vendrob-v2.md).

# mad-vendrob v2

## Link

{% embed url="<https://madcap-scripts.tebex.io/package/6679119>" %}
Tebex Package
{% endembed %}

## Introduction

A comprehensive and highly customisable vending machine robbery system for your FiveM server. This **complete rewrite** of my most popular free resource brings **new features, better performance, and enhanced gameplay.**

* :computer: **Seamless Compatibility -** Automatically detects and works with your resources: framework, inventory, police dispatch, target (third-eye),  notifications, mini-games, progress-bars and language - **no manual setup required!**
* :fire: **Dynamic Consequences** – Machines can fall apart, zap you, trap your hand, or even **explode** if you're unlucky!
* :muscle: **Improved & Upgraded** – Countless refinements and optimisations make gameplay more dynamic, immersive, and seamless on your server.
* :white\_check\_mark: **Fully Customisable & Optimised** – Easily tweak everything to match your server’s style and economy.
* :closed\_lock\_with\_key: **Completely Secure** - Not even the most determined script kiddy can exploit this. All critical logic runs server-side, with the client handling only minor tasks, making it fully secure and tamper-proof.

:star2: **New Additions**

* **Improved Reward Logic** - Choose between built-in rewards or integrate with [mad-loot](https://github.com/ThatMadCap/mad-loot).
* **Synchronized State -** Machine damage and cooldowns are synced across all players.
* **Dynamic Random Events** - Experience unpredictable outcomes with fully customisable random events:
  * **Machine Breakdown -** Watch as the vending machine crumbles and falls apart before your eyes.
  * **Arm Entrapment -** Players can get their arm stuck inside, requiring them to complete a skillcheck to free themselves - or remain trapped until police arrive.
  * **Electrical Shock** - Hit a loose wire and get temporarily stunned by an electric shock.
  * **Catastrophic Failure** - Machines can explode with configurable damage radius and impact.
* Each event features immersive animations and particle effects for maximum realism. Server owners can fine-tune individual event probabilities, toggle features on/off, and control event behaviour through comprehensive configuration options.

### Preview

{% embed url="<https://youtu.be/FXekNg0pF_I>" %}
Preview Video
{% endembed %}

***

## Installation

1. Drag and drop `mad-vendrob` into your server resources folder.
2. Add `start mad-vendrob` to your `server.cfg`.
3. Configure the resource in `server/config.lua` to your liking.
4. Set your language in your `server.cfg`, example: `setr ox:locale en`.

### Dependencies

* [ox\_lib](https://github.com/overextended/ox_lib)

### Supports

The following resources are **automatically detected** and integrated into the resource. No manual setup is required. If you need any custom logic, you can easily set that up in the "custom" section in the bridge, for each supported type. If you have any issues, please feel free to open a ticket in our [Discord server](https://discord.gg/dTNWpmPGyc) :relaxed:

#### :computer: Supported frameworks

* qb-core
* esx\_core
* qbx\_core
* ox\_core
* custom

#### :school\_satchel: Supported inventories

* qb-inventory
* ox\_inventory
* qs-inventory
* custom

#### :rotating\_light: Supported dispatches

* ps-dispatch
* cd\_dispatch
* rcore\_dispatch
* qs\_dispatch
* custom

#### :eye\_in\_speech\_bubble: Supported targets (third-eyes)

* qb-target
* ox\_target

#### :speech\_balloon: Supported notifications

* ox\_lib&#x20;
* qb-core
* custom

#### :game\_die: Supported mini-games

* ox\_lib skillcheck
* qb-minigames lockpick

#### :signal\_strength: Supported progress-bars

* ox\_lib progressBar
* ox\_lib progressCircle
* qb-core progressbar

#### :speaking\_head: Supported Languages

* English (en)
* Spanish (es)
* French (fr)
* German (de)
* Italian (it)
* Russian (ru)
* Chinese (zh)

Additional languages can be added in the `locales` folder.

***

## Configuration

Debug prints are handled via [ox\_lib prints](https://overextended.dev/ox_lib/Modules/Print/Shared#libprint).

<figure><img src="/files/fVDEMc7ItMpHHrxLp3xI" alt=""><figcaption><p>mad-vendrob config</p></figcaption></figure>

#### Escrow Protection

This resource is protected by FiveM's escrow system to safeguard against unauthorised distribution. The core functionality is secured while maintaining full customisability through the extensive configuration system and bridge architecture.

Despite the security measures:

* All configuration options remain **fully editable** in `server/config.lua`.
* The **comprehensive bridge system** allows integration with custom frameworks and resources.
* Server owners retain **complete control** over gameplay settings, rewards, and event probabilities.
* **No functionality is limited** by the protection system.

This approach ensures you receive a premium, leak-protected resource while maintaining the freedom to customise it for your server's unique needs.