> For the complete documentation index, see [llms.txt](https://dynasty-store.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dynasty-store.gitbook.io/home/products/dynasty-mug-and-carjack.md).

# Dynasty Mug & Carjack

## 📜 Description

<figure><img src="/files/0SZDUbpKsPF4aHCeyHit" alt=""><figcaption><p>Aiming an NPC</p></figcaption></figure>

<figure><img src="/files/EyNdKOYGQPB7VLN0jWpH" alt=""><figcaption><p>Mugging an NPC</p></figcaption></figure>

<figure><img src="/files/9r08B8CzBPAzlYWWjMTP" alt=""><figcaption><p>The NPC was already mugged</p></figcaption></figure>

<figure><img src="/files/x4XTx3upNaFXAnIEhmfg" alt=""><figcaption><p>Carjacking</p></figcaption></figure>

## 🔥 Features

* **Advanced Police Requirement Mechanism**: Configurable settings require a minimum police presence for initiating muggings, ensuring gameplay realism.
* **Timed Mugging Process**: Features a customizable timer that defines the exact duration required to complete a mugging, adding tension and realism.
* **Regulated Mugging Cooldown**: Introduces a cooldown timer between muggings to maintain gameplay fairness and prevent abuse.
* **Police Alert System**: Offers a probability-based police notification mechanism that guarantees alerts if a mugging results in NPC death, enhancing law enforcement interaction.
* **Voice-Controlled Mugging Initiation**: Optional feature requiring players to actively use voice communication to start a mugging, increasing immersion.
* **Configurable Economic Impact**: Muggings can generate both regular and illicit funds, with adjustable minimum and maximum payouts.
* **Randomized Item Reward Mechanism**: Provides a probability-based system for acquiring additional items during muggings, enriching the reward structure.
* **Detailed Emergency Dispatch Notifications**: Configurable alerts provide comprehensive incident details to other players, simulating an authentic emergency response system.
* **Selective Vehicle Protection System**: Allows for specific vehicles to be designated as immune to carjacking, protecting key assets.
* **Integrated Vehicle Key Assignment**: Automatically assigns vehicle keys to players post-carjacking, seamlessly linking with vehicle management functionalities.

## 💻 Requirements <a href="#requirements" id="requirements"></a>

### **1. ESX** or **QBCore** Frameworks

{% embed url="<https://github.com/esx-framework>" %}
**ESX** Framework Official Repository
{% endembed %}

{% embed url="<https://github.com/qbcore-framework>" %}
**QBCore** Framework Official Repository
{% endembed %}

### Additional recommendation

Updated artifacts (if possible the latest recommended version)

{% embed url="<https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/>" %}
Official FiveM Repository
{% endembed %}

## 🔒 Security

{% hint style="info" %}
This script has the official protection of **Tebex** and **FiveM** (Cfx.re) that makes sure to protect buyers and the seller, also thanks to this you will get a product that is configurable and easy to understand for any user with or without programming knowledge.
{% endhint %}