G4 Addiction

Video Preview

G4 Addiction - Advanced Drug System for FiveM

Transform your FiveM server's drug roleplay with the G4 Addiction System, a sophisticated drug mechanics script that introduces realistic addiction, overdose consequences, and withdrawal effects. This comprehensive system goes far beyond simple drug items, creating genuine gameplay consequences that force players to manage their character's substance dependencies realistically.

Perfect for serious roleplay servers seeking authentic drug mechanics, criminal roleplay depth, and medical department engagement. This system creates meaningful player choices with lasting consequences, adding layers of realism to your server's drug trade and rehabilitation storylines.

Core Addiction Mechanics

The addiction system operates on a sophisticated drug immunity model where each player has a base tolerance level (default: 100). Every drug interaction temporarily reduces this immunity based on the drug's strength value, creating realistic tolerance buildup and overdose risks when players consume too many substances simultaneously.

• Drug Immunity System - Player tolerance levels that decrease with drug use and recover over time
• Overdose Mechanics - Automatic overdose when immunity drops too low, with blackout effects
• Withdrawal Symptoms - Time-based addiction that requires regular doses or medical treatment
• Addiction Chance - Configurable probability (0-100%) for each drug to create dependency
• Treatment System - Medication items that cure specific or all drug addictions
• Health Consequences - Positive and negative effects on player health and armor
• Visual Effects - Screen filters, camera shake, and walking style alterations per drug type
• Duration Control - Per-drug effect timing from seconds to minutes

Included Drug Profiles

The system comes pre-configured with four major drug types, each with unique characteristics:

Marijuana

• Animation: Smoking animation
• Drug Strength: 30 (moderate tolerance impact)
• Health Effects: +10 armor, -10 health
• Addiction: 100% chance, 60-minute withdrawal timer
• Effect Duration: 30 seconds
• Visual Effects: Screen flash, drunk walking style, camera shake

Cocaine

• Animation: Sniffing/snorting animation
• Drug Strength: 10 (lighter tolerance impact)
• Addiction: 100% chance, 60-minute dependency
• Speed Boost: Configurable movement speed multiplier
• Quick Effects: Fast-acting with immediate visual feedback

Heroin

• Animation: Syringe/injection animation
• Drug Strength: 5 (minimal tolerance impact)
• Addiction: Configurable (default 0% for testing)
• Long Duration: 180-second effects (3 minutes)
• Intense Effects: Prolonged visual distortion and impairment

MDMA (Ecstasy)

• Animation: Pill consumption animation
• Drug Strength: 5 (controlled impact)
• Effect Duration: 180 seconds for extended party RP
• Energy Boost: Speed multiplier and stamina effects

Treatment & Recovery System

Medical departments can create and distribute treatment items that cure addictions:

• Targeted Cures: Medication for specific drug types (e.g., marijuana_cure)
• Universal Treatment: Broad-spectrum medication that cures all addictions
• Hospital RP: Creates demand for EMS/hospital rehabilitation services
• Black Market Alternatives: Street dealers can sell questionable cures

Configuration Power

Every aspect is fully configurable through the config file:

• Drug Strength Values: Control how each drug impacts player immunity
• Addiction Probability: Set individual addiction chances per drug (0-100%)
• Withdrawal Timers: Configure how long between doses before withdrawal symptoms
• Health Modifiers: Customize armor/health gains or losses per drug
• Animation Types: Four built-in animation styles (smoke/syringe/sniff/pill)
• Screen Effects: Choose from multiple screen filter options
• Walking Styles: Select drunk/impaired movement animations
• Speed Multipliers: Adjust movement speed from 1.0 to 1.49x
• Camera Shake Intensity: Control visual impairment level
• Custom Translations: Fully translatable notification system

Roleplay Applications

This system enables rich storytelling opportunities:

• Criminal Organizations: Drug empire building with repeat customer mechanics
• Medical Departments: Addiction treatment programs and rehabilitation roleplay
• Police Investigations: Identifying addicts through behavior patterns
• Character Development: Long-term addiction storylines with consequences
• Economy Impact: Recurring demand creates sustainable drug markets
• Gang Territories: Control areas where specific drugs are prevalent

Technical Specifications

• Dependencies: oxmysql (required)
• Framework Compatibility: ESX and QBCore fully supported
• Performance: Optimized with minimal resource usage
• Database: Persistent addiction tracking across sessions
• Notifications: Customizable UI alerts for overdose/addiction events
• Multi-Language: Full translation support for international servers

Perfect For

• Serious roleplay servers with active criminal factions
• Communities wanting realistic drug trade consequences
• Servers with dedicated medical/EMS departments
• Gang-focused servers needing territory control mechanics
• Economy-driven servers requiring recurring consumable demand

What Makes G4 Addiction Stand Out

Unlike basic drug scripts that only apply temporary effects, G4 Addiction creates genuine gameplay loops. Players who become addicted must either continue using (creating reliable customer bases for dealers) or seek expensive medical treatment (driving hospital RP). The configurable immunity system prevents abuse while maintaining realism—take too much too fast, and you'll overdose with serious consequences.

The four animation types ensure visual variety, and the extensive configuration options mean you can balance drug effects perfectly for your server's economy and roleplay style. Whether you're running a hardcore crime server or a balanced community with medical roleplay, this system adapts to your needs.

Installation & Setup

Simple drag-and-drop installation with comprehensive config file. Add your drug items to your framework's item database, configure effect durations and addiction rates, then customize visual effects to match your server's atmosphere. The included translation system supports any language.

Config File

Config = {}

Config.DrugImmunity = 100 -- how much the player can withstand the drug acting at the same time (drugStrength)

Config.UsableDrugs = {
    [marijuana] = {
        label = Marijuana,
        animation = 'smoke', -- (smoke/syringe/sniff/pill)
        drugStrength = 30, -- this amount is being removed from immunity of player for effect duration time
        healthEffects = {
            armour = 10,
            health = -10
        },
        addiction = {
            chance = 100, -- 0-100%
            time = 60 -- time until drug wears out and you need other dose (in minutes)
        },
        effect = {
            duration = 30, -- in seconds
            screenFX = DefaultFlash,
            speedMultiplier = 1.0, -- from 1.0 to 1.49
            walkingStyle = MOVE_M@DRUNK@SLIGHTLYDRUNK,
            cameraShakeIntensity = 1.0,
        }
    },
    [cocaine] = {
        label = Cocaine,
        animation = 'sniff', -- (smoke/syringe/sniff/pill)
        drugStrength = 10, -- this amount is being removed from immunity of player for effect duration time
        healthEffects = {
            armour = 10,
            health = -10
        },
        addiction = {
            chance = 100,
            time = 60 -- time until drug wears out and you need other dose (in minutes)
        },
        effect = {
            duration = 30, -- in seconds
            screenFX = DefaultFlash,
            speedMultiplier = 1.0, -- from 1.0 to 1.49
            walkingStyle = MOVE_M@DRUNK@SLIGHTLYDRUNK,
            cameraShakeIntensity = 1.0,
        }
    },
    [heroin] = {
        label = Heroin,
        animation = 'syringe', -- (smoke/syringe/sniff/pill)
        drugStrength = 5, -- this amount is being removed from immunity of player for effect duration time
        healthEffects = {
            armour = 10,
            health = -10
        },
        addiction = {
            chance = 0,
            time = 60 -- time until drug wears out and you need other dose (in minutes)
        },
        effect = {
            duration = 180, -- in seconds
            screenFX = DefaultFlash,
            speedMultiplier = 1.0, -- from 1.0 to 1.49
            walkingStyle = MOVE_M@DRUNK@SLIGHTLYDRUNK,
            cameraShakeIntensity = 1.0,
        }
    },
    [mdma] = {
        label = MDMA,
        animation = 'pill', -- (smoke/syringe/sniff/pill)
        drugStrength = 5, -- this amount is being removed from immunity of player for effect duration time
        healthEffects = {
            armour = 10,
            health = -10
        },
        addiction = {
            chance = 0,
            time = 60 -- time until drug wears out and you need other dose (in minutes)
        },
        effect = {
            duration = 180, -- in seconds
            screenFX = DefaultFlash,
            speedMultiplier = 1.0, -- from 1.0 to 1.49
            walkingStyle = MOVE_M@DRUNK@SLIGHTLYDRUNK,
            cameraShakeIntensity = 1.0,
        }
    },
}

Config.Medication = {
    [marijuana_cure] = {'marijuana'},
    [universal_cure] = {'marijuana', 'cocaine', 'heroin' , 'mdma'}
}

Config.Translations = {
    notification_header = Dikkat,
    overdose_text = Şu anda,
    overdose_highlighted_text = Aşırı Dozda,
    overdose_description = Vücudunuz aldığınız ilaç miktarıyla başa çıkamadı...,
    addiction_text = Şu anda,
    addiction_description = İlacın vücuttaki miktarı azaldıkça, kendinizi kötü hissedeceksiniz; bağımlılıktan kurtulmak için doğru türde bir tedavi almanız gerekiyor.,
}

Transform drug roleplay from simple item consumption into meaningful character-defining choices with G4 Addiction.

Related QBCore Scripts

• BB Store Robbery (Unique)
• Aquiver - Inventory System 4
• Advanced GPS Menu
• Car Lift Script