mad-drugruns

Chemistry meets Crime in the ultimate drug production and trafficking system for FiveM.

Previousmad-thoughts NextAdding New Drugs

Last updated 1 month ago

mad-drugruns

Chemistry meets Crime in the ultimate drug production and trafficking system for FiveM.

Link

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.

🎞️ Showcase

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

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

Installation

STEP 1: Dependencies

Ensure you have all the required dependencies:

A supported framework: qb-core, es_extended, qbx_core, ox_core, or custom to setup your own logic
(Optional, but recommended) A supported dispatch system: ps-dispatch, cd_dispatch, qs_dispatch, rcore_dispatch or custom to setup your own logic

STEP 2: Drag & Drop

Download the resource and place it in your FiveM server's resources folder.
Add start mad-drugruns to your server.cfg file.

STEP 3: Items

Add the required items to your inventory system. ox_inventory item definitions are provided below, and item images can be found in the INSTALL folder. The resource is designed for ox_inventory but includes a bridge for implementing custom inventory support.

ox_inventory: (Click to expand)

    -- mad-drugruns
	['mad_drug_package'] = {
	    label = 'Drug Package',
	    weight = 0, -- weight established by drug quality
	    stack = false,
	    degrade = 4320, -- 3 days
	    decay = true,
	    description = 'A sealed package.',
	    client = {
	        image = 'mad_drug_package.png',
	    },
	},

	-- Cocaine ingredients
	['coca_leaves'] = {
	    label = 'Coca Leaves',
	    weight = 100,
	    stack = true,
	    degrade = 2880, -- 2 days
	    decay = true,
	    description = 'Raw coca leaves used in the production of cocaine.',
	    client = {
	        image = 'coca_leaves.png',
	    }
	},

	['sodium_carbonate'] = {
	    label = 'Sodium Carbonate',
	    weight = 150,
	    stack = true,
	    degrade = 14400, -- 10 days
	    decay = true,
	    description = 'A chemical compound used in drug production.',
	    client = {
	        image = 'sodium_carbonate.png',
	    }
	},

	['gasoline'] = {
	    label = 'Gasoline',
	    weight = 400,
	    stack = true,
	    degrade = 10080, -- 7 days
	    decay = true,
	    description = 'Flammable liquid used as a solvent in drug production.',
	    client = {
	        image = 'gasoline.png',
	    }
	},

	-- Methamphetamine ingredients
	['pseudoephedrine'] = {
	    label = 'Pseudoephedrine',
	    weight = 120,
	    stack = true,
	    degrade = 7200, -- 5 days
	    decay = true,
	    description = 'A precursor chemical used in methamphetamine production.',
	    client = {
	        image = 'pseudoephedrine.png',
	    }
	},

	['red_phosphorus'] = {
	    label = 'Red Phosphorus',
	    weight = 120,
	    stack = true,
	    degrade = 8640, -- 6 days
	    decay = true,
	    description = 'A chemical used in the synthesis of methamphetamine.',
	    client = {
	        image = 'red_phosphorus.png',
	    }
	},

	['iodine'] = {
	    label = 'Iodine',
	    weight = 100,
	    stack = true,
	    degrade = 10080, -- 7 days
	    decay = true,
	    description = 'A crystalline chemical element used in drug production.',
	    client = {
	        image = 'iodine.png',
	    }
	},

	-- Heroin ingredients
	['opium'] = {
	    label = 'Opium',
	    weight = 150,
	    stack = true,
	    degrade = 4320, -- 3 days
	    decay = true,
	    description = 'Raw opium extract used for heroin production.',
	    client = {
	        image = 'opium.png',
	    }
	},

	['acetic_anhydride'] = {
	    label = 'Acetic Anhydride',
	    weight = 200,
	    stack = true,
	    degrade = 5760, -- 4 days
	    decay = true,
	    description = 'A chemical reagent used in heroin production.',
	    client = {
	        image = 'acetic_anhydride.png',
	    }
	},

	['lime'] = {
	    label = 'Lime',
	    weight = 150,
	    stack = true,
	    degrade = 14400, -- 10 days
	    decay = true,
	    description = 'A white powder used in various drug manufacturing processes.',
	    client = {
	        image = 'lime.png',
	    }
	},

	-- LSD ingredients
	['ergotamine'] = {
	    label = 'Ergotamine',
	    weight = 100,
	    stack = true,
	    degrade = 2880, -- 2 days
	    decay = true,
	    description = 'A precursor used in LSD synthesis.',
	    client = {
	        image = 'ergotamine.png',
	    }
	},

	['chloroform'] = {
	    label = 'Chloroform',
	    weight = 250,
	    stack = true,
	    degrade = 4320, -- 3 days
	    decay = true,
	    description = 'A volatile liquid used in drug production.',
	    client = {
	        image = 'chloroform.png',
	    }
	},

	['diethylamine'] = {
	    label = 'Diethylamine',
	    weight = 200,
	    stack = true,
	    degrade = 5760, -- 4 days
	    decay = true,
	    description = 'A chemical compound essential for LSD synthesis.',
	    client = {
	        image = 'diethylamine.png',
	    }
	},

STEP 4: Configuration

Configure the resource to your liking in server/config.lua. This resource is highly configurable. A few things I suggest you begin with are:

Set up the processing location, mission start NPC random locations, and random drop-off locations
Adjust the transport vehicles that can spawn, and their performance and mods settings
Set the cooldown time between players being able to start a new drug run, or if you like only allow one drug run to be active at once server-wide, if you don't want overwhelm your police force.
Set the tracker duration to your liking, which (depending on the driving & tactical skills of your police) essentially defines the duration the police chases will be
Customize rewards based on drug quality
And much more, dive into the config and adjust everything your heart desires to fit your server's theme.

STEP 5: Integration

Add a way for players to obtain the initial ingredients (through farming, shops, or other means).

STEP 6: Language Support

Set your language in your server.cfg, example: setr ox:locale en, where "en" is replaced with your chosen language based on the locale file you wish to use.

STEP 7: 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.

Command Usage

/drugrewardtest [quality] [drugName] [count]

quality: A number from 0-100 representing the drug quality (defaults to 50)
drugName: The type of drug to test (cocaine, meth, heroin, lsd, etc.) (defaults to cocaine)
count: Number of packages to sell at once (defaults to 1)

Example Usage

/drugrewardtest 95 cocaine 1 - Test reward for a premium quality cocaine package
/drugrewardtest 25 meth 3 - Test reward for three low-quality meth packages
/drugrewardtest 50 - Test reward for average quality cocaine package (using defaults)

Output Information

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

Drug Details: Type of drug, quality percentage, and quality tier
Calculation Breakdown: Shows the base reward range and exact calculation steps
Modifiers Applied: Displays drug-specific price modifiers and package count multipliers
Total Reward: Shows the final amount the player would receive
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

Configuring Your Economy

To adjust rewards based on your testing, modify these config values:

CashRewardMin and CashRewardMax: Control the minimum/maximum possible payouts
DrugPriceModifiers: Adjust rewards for specific drug types
QualityModifiers: Tune reward scaling based on quality tiers

Example Reward Scale (Default Settings)

Drug Type

Quality Range (%)

Quality Tier

Single Package

Multiple Packages (3)

Cocaine

95-100

Premium

$95,000-$100,000

$285,000-$300,000

Cocaine

85-94

High

$85,000-$94,000

$255,000-$282,000

Cocaine

75-84

Pure

$75,000-$84,000

$225,000-$252,000

Cocaine

65-74

Refined

$65,000-$74,000

$195,000-$222,000

Cocaine

55-64

Standard

$55,000-$64,000

$165,000-$192,000

Cocaine

45-54

Basic

$45,000-$54,000

$135,000-$162,000

Cocaine

35-44

Crude

$35,000-$44,000

$105,000-$132,000

Cocaine

25-34

Cut

$25,000-$34,000

$75,000-$102,000

Cocaine

0-24

Contaminated

$1,000-$24,000

$3,000-$72,000

Note: Values shown with default config settings and assuming CashRewardMin=$1,000 and CashRewardMax=$100,000. Your actual values may vary based on your configuration and drug-specific price modifiers.

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

Exports

The resource provides the following exports that can be used by other resources:

openDrugMenu

Opens the drug lab UI directly without proximity checks.

-- Open the drug manufacturing UI
exports['mad-drugruns']:openDrugMenu()

Usage Example

-- Example: Creating a custom zone that opens the drug lab UI
exports.ox_target:addBoxZone({
    coords = vec3(711.17, -962.91, 30.40),
    size = vec3(2.0, 1.0, 0.5),
    rotation = 0,
    options = {
        {
            icon = "fa-solid fa-flask",
            label = "Access Drug Lab",
            onSelect = function()
                exports['mad-drugruns']:openDrugMenu()
            end
        },
    },
})

Note: This export bypasses the normal distance check to the mixing location, allowing the UI to be opened from anywhere. This is useful for creating custom lab locations or alternative triggers beyond the default mixing station.

Config File

Support

Escrow Protection

This resource is protected by FiveM's escrow system to safeguard against unauthorised distribution. The core functionality is secured while maintaining full customisability through the extensive configuration system and bridge architecture.

Despite the security measures:

All configuration options remain fully editable in server/config.lua.
The comprehensive bridge system allows integration with custom frameworks and resources.
Server owners retain complete control over all gameplay settings.
No functionality is limited by the protection system.

This approach ensures you receive a premium, leak-protected resource while maintaining the freedom to customise it for your server's unique needs.

Previousmad-thoughts NextAdding New Drugs

Last updated 1 month ago