> 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_drugmissions.md).

# ak47\_drugmissions

The ultimate dynamic drug smuggling & trafficking experience for FiveM servers.

{% embed url="<https://youtu.be/AfIfGdZEvv4>" %}

Take illegal drug operations to the next level with air, sea, and land smuggling runs including Coke Planes, Weed Transports, and Meth Boats. Players navigate dangerous routes under time pressure, secure contraband pickups, and deliver vehicles safely to collect their returns and drug bricks. Built with native Cayo Perico Island integration, real-time sync, and `ak47_lib` compatibility across ESX, QBCore, and Qbox.

***

### 🔥 Key Features

Designed to improve roleplay immersion and economy balancing:

#### 🛩️ Multi-Tier Smuggling Operations (Land, Sea & Air)

* **Coke Plane Smuggling:** Fly a Dodo aircraft across the ocean to Cayo Perico Island, retrieve packages of cocaine bricks from remote drop zones, and navigate back to the hangar safely.
* **Weed Ground Transport:** Pilot high-speed ground vehicles across Los Santos and Blaine County to collect packed weed bricks under tight mission deadlines.
* **Meth Boat Operations:** Navigate coastal and offshore waters on a Dinghy boat to secure pseudoephedrine/meth bricks from water drop points.

#### 🏝️ Built-In Cayo Perico Island Support

* **Native IPL & Stream Manager:** Automatically requests and loads all Cayo Perico Island IPLs without requiring extra island mapping resources.
* **Minimap & Radar Fix:** Corrects radar boundaries and interior positioning for the island seamlessly.
* **Ambient Audio & Nodes:** Activates island ambient sound zones, scenario peds, and navigation path nodes when near Cayo Perico.

#### ⏱️ Real-Time Mission & Economy Systems

* **Live On-Screen Timer HUD:** Displays a synchronized countdown clock showing remaining minutes and seconds to complete the smuggling run.
* **Deposit & Return Guarantee:** Requires a mission entry deposit that is refunded with an extra return payout once the vehicle is returned in functional condition.
* **Configurable Contraband Yields:** Players receive inventory items (`cokebrick`, `weedbrick`, `methbrick`) with randomized quantity ranges defined per location.

#### 🚗 Vehicle Monitoring & State Synchronization

* **Engine Health Monitoring:** Active background thread checks engine health and vehicle existence; if destroyed or totaled, the mission immediately terminates in failure.
* **Server-Wide State Synchronization:** Synchronizes in-progress missions across all clients to prevent players from taking the same contract at the same time.
* **Automated Reset Timers:** Server-side threads automatically clean up and reset mission availability if a player disconnects or abandons the mission.

#### 🛠️ 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.
* **Marked Bills & Vehicle Integrations:** Supports marked bills/black money with item metadata worth handling, alongside automated fuel (100%) and vehicle keys handling via `ak47_lib`.

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

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

***

### ⚙️ How To Install:

* Download ak47\_drugmissions 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_drugmissions>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/5089663>
* **💬 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