⚗️ Chemistry meets 💸 Crime in the ultimate drug production and trafficking system for FiveM

🎞️ Showcase

Watch the demonstration video to see mad-drugruns in action.

📘 Documentation

Read the docs for more in-depth installation, and other guides.

Introduction

🧪 Players dive into a custom laboratory UI where they experiment with different ingredient ratios to discover what makes the perfect product. With formulas either randomly generated at server startup or custom-defined by administrators, each experience is unique - criminals must test and refine their process to maximize profits.

But manufacturing is only half the game. Once they've created their product, the real thrill begins: locating the transport vehicle and embarking on heart-pounding delivery missions where police tracking systems create intense cat-and-mouse chases across the map.

🚓 Only by successfully evading law enforcement until the tracker deactivates can they complete their delivery for substantial rewards. The higher the purity, the bigger the payoff.

With a configuration system where almost nothing is hard-coded, server owners can customize virtually every aspect of the experience: drug types and their ingredients, ideal formulas, random spawn locations, vehicle options with full performance tuning, tracking systems, rewards, police integration and countless other parameters. mad-drugruns creates the most immersive and 🔥 adrenaline-fueled criminal underworld experience available for any FiveM framework.

Why Choose mad-drugruns?

• 🔁 Engaging Gameplay Loop: Players stay invested as they experiment with formulas and master evasion tactics
• 👮 Immersive Police Integration: Creates organic roleplay opportunities between criminals and law enforcement
• 👨‍💻 Highly Configurable: Define your own drug types, ingredients, formulas, locations, and much more
• ✅ Automatic Integration: Works seamlessly with supported frameworks and resources

How it works

The resource features two main gameplay components that work together:

📦 Drug Manufacturing: Players use a custom laboratory UI to process ingredients into valuable drug packages. By experimenting with different ingredient ratios, they discover formulas that yield higher-quality products. The formulas can be randomly generated at server startup or custom-defined by administrators, making each experience unique.

🚗 Drug Running: After creating drug packages, players engage in high-stakes deliveries. They locate NPC contacts who provide coordinates to transport vehicles. Once inside the vehicle, a police tracking system activates, alerting law enforcement and creating intense pursuits across the map. Only by successfully evading police until the tracker deactivates can players complete their delivery for rewards - with higher quality packages commanding better payouts.

Features

🧪 Drug Manufacturing System

• Custom Laboratory UI: Immersive interface with sliders for precise ingredient control
• Products Page: Visual indication of ingredient combinations and drug descriptions
• Mixing System: Process your drug package ready for transport
• Experimental Approach: Discover the ideal mix of ingredients for maximum purity
• Multiple Drug Types:Four complete drug types ready to use:
  • Cocaine
  • Methamphetamine
  • Heroin
  • LSD
• Expandable System: Easily add custom drug types through configuration

🚗 Dynamic Drug Running Missions

• NPC Interactions: Find contacts to initiate trafficking missions
• Strategic Navigation: Locate and secure transport vehicles
• Police Pursuit System: Vehicle tracking activates when entering transport vehicles
• Evasion Gameplay: Successfully evade law enforcement until trackers deactivate
• Dynamic Rewards: Higher purity packages yield better rewards
• Multiple Destinations: Delivery locations vary to keep gameplay fresh and unpredictable

👮 Enhanced Police Roleplay

• Strategic Pursuit Gameplay: Real-time blips for officers allow coordinated pursuit efforts
• Framework Integration: Works with existing police dispatch systems
• Balanced Difficulty: Pursuit parameters can be fine-tuned to balance criminal success rate and police engagement

💰 Configurable Drug Economy

• Complete Control: Server owners can customize all drug types and ingredients
• Formula Generation: Define ideal ingredient mixes or let the server generate them randomly
• Progressive System: Players experiment to find optimal formulas for maximum profit
• Quality-Based Rewards: Better products command higher prices and special rewards
• Economic Balancing: Fine-tune pricing to perfectly balance your server's economy

🔒 Secure & Optimized

• Server-side Validation: Comprehensive checks throughout manufacturing and delivery
• Stable Implementation: Clean code architecture with proper error handling
• Optimised Performance: Function localization, efficient event handling, and smart resource use for minimal server impact
• Tamper-proof Logic:
  • Drug processing requires specific ingredients that can't be substituted
  • Drug quality tracking tied to server-verified production processes
  • Vehicle validation ensures mission integrity throughout the delivery process
  • Various checks during all stages to ensure players are playing fairly
  • And more..

Supported Frameworks, Resources & Languages

The following 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.

• 💻 Frameworks: qb-core, es_extended, qbx_core, ox_core, custom
• 🎒 Inventory: ox_inventory, custom
• 🚨 Dispatch: ps-dispatch, cd_dispatch, rcore_dispatch, qs_dispatch, custom
• 👁️‍🗨️ Target: ox_target, qb-target
• 💬 Notifications: ox_lib, qb-core, custom
• 📶 Progressbar: ox_lib, qb-progressbar
• 🗣️ Languages: English, Spanish, French, German, Italian, Russian, Chinese, Korean, Dutch, Japanese, Portuguese (Brazil), Polish, Turkish, Arabic, Swedish, Thai, Vietnamese, Hungarian, Czech, Greek

Economy Balancing

The script includes a powerful debugging tool called drugrewardtest that helps server administrators balance their economy and understand the potential financial impact of drug running on their server.

When running this command, detailed information will be displayed in your F8 console:

1. Drug Details: Type of drug, quality percentage, and quality tier
2. Calculation Breakdown: Shows the base reward range and exact calculation steps
3. Modifiers Applied: Displays drug-specific price modifiers and package count multipliers
4. Total Reward: Shows the final amount the player would receive
5. Comparison Table: Shows reward amounts at all purity levels for easy comparison

Why This Matters for Admins

This command helps you:

• Fine-tune your economy: Make sure drug rewards are balanced compared to other money-making activities
• Adjust risk/reward ratios: Ensure higher-risk activities provide appropriately higher rewards
• Test configuration changes: Quickly see how changes to config values affect payouts
• Plan server economy: Understand the minimum and maximum possible payouts in your economy
• Balance different drug types: Compare rewards between different drug types to ensure variety

Testing different combinations with /drugrewardtest will help you find the perfect balance for your server's unique economy.

Dependencies

• A supported framework: qb-core, es_extended, qbx_core, ox_core, or custom to setup your own logic
• ox_lib
• ox_inventory, or a custom inventory to setup your own logic
• ox_target or qb-target
• A supported dispatch system: ps-dispatch, cd_dispatch, qs_dispatch, rcore_dispatch or custom to setup your own logic

Support

Join our Discord community for support, regular updates and to request new features.