> 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

Advanced Mug & Carjack for FiveM Servers

## 📜 Description

<figure><img src="https://2652661357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUsY4h9tsm7XSZY5ZzV3l%2Fuploads%2FVTXJGCIx1ZJ8BOi7PrRC%2Fimage1111111.png?alt=media&amp;token=ded4e41a-f439-4f6a-9ec3-3d32d02f8ec2" alt=""><figcaption><p>Aiming an NPC</p></figcaption></figure>

<figure><img src="https://2652661357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUsY4h9tsm7XSZY5ZzV3l%2Fuploads%2FLjNAT0JZC7uQRxgCE6uh%2Fimage22222222.png?alt=media&amp;token=a8e429ec-e522-4f71-aa60-2bf84b927506" alt=""><figcaption><p>Mugging an NPC</p></figcaption></figure>

<figure><img src="https://2652661357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUsY4h9tsm7XSZY5ZzV3l%2Fuploads%2F0ePPlQ8PzA03ZV5ItJSM%2F3333333333.png?alt=media&amp;token=80213b22-4d7d-4f24-957b-d9d5abe12ad8" alt=""><figcaption><p>The NPC was already mugged</p></figcaption></figure>

<figure><img src="https://2652661357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUsY4h9tsm7XSZY5ZzV3l%2Fuploads%2FhRnPUOpOZD9Pq05IFNIf%2Fimage444444444.png?alt=media&amp;token=4514af43-cf23-4fd8-9daf-315c29828356" 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 %}