> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_mafiasupply.md).

# ak47\_mafiasupply

The ultimate underground mafia supply chain and black market trading experience for FiveM servers.

{% embed url="<https://youtu.be/U-Rhgrgli9Q>" %}

AK47 Mafia Supply brings a deep, roleplay-driven syndicate economy to your city featuring custom interactive UIs, dynamic tactical meetups, trust progression, and police risk balancing. Built on `ak47_lib`, it offers seamless multi-framework compatibility with comprehensive server-side security.

***

### 🔥 Key Features

Designed to improve roleplay immersion and economy balancing:

#### 📟 Mafiacom Pager & Interactive UIs

* **Encrypted Handheld Pager:** Custom retro green-screen LCD pager UI displaying live network status, player identification, active appointment timers, and network messages.
* **Modern Trade Hub Interface:** High-tech dual-panel tablet UI displaying agent stock, requested items, payment offers, live trade balance indicators, and real-time value math.
* **One-Click Auto-Fill:** Built-in auto-fill algorithm that instantly balances payment trade offers with available inventory items and cash.

#### 📍 Dynamic World Encounters & Tactical Departures

* **Randomized Appointment Locations:** Appointments dynamically spawn across 12+ diverse locations including remote industrial zones, hidden helipads, docks, and coastal drop-offs.
* **Full Scene Spawning:** Spawns a complete mafia syndicate scene featuring the main broker NPC, armed security guards with assault rifles, and transport vehicles (SUVs, Frogger helicopters, Dinghy boats).
* **Cinematic Departure:** Once deals finish or players hold \[H] to wrap up, guards and the broker board their vehicle and drive, fly, or sail away before despawning cleanly.

#### 🤝 Dues System & Multi-Tier Trust Progression

* **Earning Mafia Trust:** Players must first prove their loyalty by delivering requested contraband dues (weed bricks, meth, coke) to unlock access to the syndicate.
* **5-Tier Trust Levels:** Timely trade and payment compliance ranks players from Level 1 up to Level 5, unlocking progressive discounts (up to 12% off).
* **Trust Decay & Deadlines:** Configurable payment cycles (e.g. 7 days). Missing deadlines or late payments lowers trust rank and can revoke trusted standing.

#### 🚨 Law Enforcement Balancing & Risk Mechanics

* **Proximity Police Busts:** If on-duty police or sheriff units enter the appointment zone during a deal, the mafia immediately cancels the drop and the player suffers a trust penalty.
* **Minimum Cop Enforcement:** Configurable minimum active police requirement before players can initiate contact via their pager.
* **Dispatch Integration Hook:** Built-in alert trigger ready to connect with any dispatch system (cd\_dispatch, ps-dispatch, qs-dispatch, core-dispatch).

#### 🛠️ Technical Excellence

* **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget).
* **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating.
* **Flexible Inventory & Marked Bills:** Full compatibility with ox\_inventory, qb-inventory, and metadata-based marked bills/black money worth calculations.

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>

***

### ⚙️ How To Install:

* Download ak47\_mafiasupply from your cfx portal.
* Add the script in your resources folder.
* Add items based on your framework instruction.
* Add item images into inventory.
* Start the script in your server.cfg below framework files.
* Make sure you have all dependencies.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47_mafiasupply>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/7082611>
* **💬 Discord Support:** <https://discord.gg/menanak47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading
