Overdose

Ak47 Drug Manager V3 features a realistic drug toxicity and overdose system that tracks active substances in the player's bloodstream in real-time.

⚠️ 1. How Overdose is Triggered

Configured in configs/usable.lua under Config.OverDoseLimit and Config.DrugStayInBlood:

• Single-Drug Toxicity: Consuming the same drug 10 times (Config.OverDoseLimit.same_drug) within the bloodstream retention window.

• Poly-Drug Mixture (Lethal Mix): Mixing 5 different drug types (Config.OverDoseLimit.mixed_drug) concurrently in the bloodstream.

• Bloodstream Window: Traces remain active in the player's blood for 5 minutes per dose (Config.DrugStayInBlood).

---

🩸 2. Symptoms & Overdose Effects

When an overdose occurs:

1. Screen Notification: Alerts the player with a warning notification: _U('overdose') ("Overdose is killing you. Take recovery medicine to feel better again!").

2. Lethal Health Drain: The player loses 1 HP every second (Config.OverdoseEffect.HealthLose = 1, tick = 1) until cured or incapacitated.

3. Event Broadcast: Dispatches the ak47_drugmanagerv3:onOverdose event across both client and server:

   TriggerEvent('ak47_drugmanagerv3:onOverdose', {
       mixed = true, -- true if mixed drug overdose
       drugs = usedDrug -- table of active substances in blood
   })

4. Death Reset: If the player dies from the overdose, active blood toxicity and overdose counters reset automatically.

---

💉 3. Cures & Medical Treatment

Item ID	Item Label	Type	Use Case & Effect
antidote	Antidote	Usable Syringe	Emergency Overdose Reversal: Injected via syringe animation (miranda_shooting_up). Immediately stops lethal health drain, clears blood toxicity, broadcasts ak47_drugmanagerv3:onAntidoteUsed, and saves the player's state.

---

🩺 4. Police & EMS Blood Drug Testing

Item ID	Item Label	Type	Use Case & Effect
drugtestkit	Drug Test Kit	Usable Tool	Diagnostic Swab: Police officers and EMS medics can interact with a target player to perform a blood swab (ak47_drugmanagerv3:drugtestkit). Opens an interactive React NUI Diagnostic Report showing all detected substances and their remaining blood retention timers.

---

👑 5. Admin Management Commands

Admins (or server console) can clear active overdoses using the following commands:

Command	Syntax	Description
/removeoverdose	/removeoverdose [player_id]	Clears active overdose, stops health drain, and resets visual screen shaders.
/cleardrugs	/cleardrugs [player_id]	Complete wipe: clears all overdoses, addictions, tolerances, and active shaders in one action.

---

⚙️ 6. Configuration Reference (configs/usable.lua)

Config.DrugStayInBlood = 5 -- 5 minutes retention window

Config.OverDoseLimit = {
    same_drug = 10,  -- Maximum doses of the same drug before overdose
    mixed_drug = 5,  -- Maximum different drug types before lethal mix
}

Config.OverdoseEffect = {
    tick = 1,        -- Health loss interval in seconds
    HealthLose = 1,  -- HP lost per tick
}

Config.TestKit = 'drugtestkit'
Config.RemoveKit = true
Config.DrugTestDelay = 5 -- Test progress duration in seconds