Removed unused function & updated docs

Author: AtrixZockt

addons/vitals/XEH_PREP.hpp

@@ -4,7 +4,6 @@ PREP(basicDiagnosticLocal);
 PREP(fullHealLocal);
 PREP(handleCardiacFunction);
 PREP(handleOxygenFunction);
-PREP(handlePoisoning);
 PREP(handleRespawn);
 PREP(handleSimpleVitals);
 PREP(handleTemperatureFunction);

addons/vitals/functions/fnc_handlePoisoning.sqf

@@ -71,7 +71,6 @@ if (_adjustments isNotEqualTo []) then {
 
 private _heartRate = [_unit, _hrTargetAdjustment, _deltaT, _syncValues] call ACEFUNC(medical_vitals,updateHeartRate); //Rename
 [_unit, _painSupressAdjustment, _deltaT, _syncValues] call ACEFUNC(medical_vitals,updatePainSuppress); //Leave alone
-[_unit, POISON_DECREASE, _deltaT, _syncValues] call FUNC(handlePoisoning);
 
 private _bloodPressure = [80,120];
 _unit setVariable [VAR_BLOOD_PRESS, _bloodPressure, _syncValues];

addons/vitals/functions/fnc_handleSimpleVitals.sqf

@@ -122,7 +122,6 @@ if (_adjustments isNotEqualTo []) then {
 [_unit, _peripheralResistanceAdjustment, _deltaT, _syncValues] call ACEFUNC(medical_vitals,updatePeripheralResistance);
 [_unit, _opioidAdjustment, _deltaT, _syncValues] call FUNC(updateOpioidRelief);
 [_unit, _opioidEffectAdjustment, _deltaT, _syncValues] call FUNC(updateOpioidEffect);
-[_unit, POISON_DECREASE, _deltaT, _syncValues] call FUNC(handlePoisoning);
 
 private _aceAnFatigue = 0;
 if (_unit getVariable [QGVAR(fatigueEnabled), false]) then {

addons/vitals/functions/fnc_handleUnitVitals.sqf

@@ -0,0 +1,27 @@
+# Chemical Warfare — Player & Mission-Maker Guide
+
+The **Chemical** addon adds a realistic CBRN (Chemical, Biological, Radiological, Nuclear) warfare layer on top of KAT Advanced Medical. Instead of a single generic "toxic gas," the battlefield now has six distinct agents — from non-lethal riot control all the way up to persistent nerve agents — each with its own cloud, symptoms, protective requirements, and treatment.
+
+It is built to reward preparation. A unit that masks up, carries detection paper, and packs the right antidotes can walk through a contaminated area and live. A unit that doesn't will find out — often several minutes later — exactly which agent it walked into.
+
+This guide is written for two audiences:
+
+- **Players / medics** — what the gases do, how to survive them, and how to treat casualties.
+- **Mission makers / Zeus** — how to deliver gas and how to tune everything through CBA settings.
+
+---
+
+## Quick Start
+
+If you only read one section, read this one.
+
+1. **Mask up.** A gas mask stops CS, chlorine, and phosgene outright. It does **not** stop mustard, sarin, or VX — those need a full CBRN suit (mask **and** a whitelisted uniform).
+2. **Identify the threat.** Use **M8 detection paper** for nerve and blister agents, the **JCAD detector** for a live readout, and your nose for the choking agents (some have a tell-tale smell).
+3. **Treat by agent class:**
+   - Choking agents (chlorine, phosgene) → **Atropine**
+   - Nerve agents (sarin, VX) → **ATNAA auto-injector**
+   - Blister/persistent contamination (mustard, VX) → **Decontamination Kit**
+4. **Decon if you're contaminated.** Mustard and VX stick to your skin and keep poisoning you every 40 seconds even after you've left the cloud. The decon kit is the only thing that stops that.
+5. **VX needs both.** ATNAA stops the nerve symptoms; the decon kit stops the re-contamination. Use one without the other and VX will eventually finish the job.
+
+---

docs/Chemical/Chemical-Warfare-Guide.md

@@ -0,0 +1,67 @@
+## Detection/Identification & Equipment/Items
+
+## Detection & Identification
+
+Knowing *what* you walked into decides whether you reach for atropine, an ATNAA, or a decon kit. You have three tools.
+
+### M8 / M9 Detection Paper
+
+Single-use paper that reacts to nerve and blister agents on contact. Use the **Use M8 Detection Paper** self-action (a 3-second wipe). The result appears as a paper-style readout on screen for about 8 seconds, then the paper is consumed.
+
+| Agent | M8 result | Stain colour |
+|-------|-----------|--------------|
+| Sarin | **G-Series Nerve** | Yellow |
+| VX | **V-Series Nerve** | Green / dark green |
+| Mustard | **Blister Agent** | Red |
+| CS, Chlorine, Phosgene, clean air | **No mark = Clean** | — |
+
+> M8 paper genuinely cannot detect choking agents — a NEGATIVE result does **not** mean the air is safe, only that there's no nerve or blister agent present. For chlorine and phosgene, trust your nose and the JCAD detector instead.
+
+The paper reads your most recent cloud exposure, remembered for **30 seconds** after you leave. Test promptly.
+
+### JCAD Chemical Detector
+
+A worn detector (`KAT_ChemicalDetector`, watch slot). Turn it on through its *JCAD* self-action menu, where you can also toggle the warning tone. When you're in or have recently been in a cloud, its top line shows the **detected agent name** (for example "SARIN", "MUSTARD"; chlorine reads "TOXIC GAS") along with an intensity reading from 0.00 (cloud edge) to 1.00 (dead centre). In clean air it falls back to showing the clock, reverting roughly 30 seconds after you leave a cloud.
+
+### Smell
+
+Unmasked units get a one-time text hint the first time they enter certain clouds:
+
+| Agent | Hint |
+|-------|------|
+| Chlorine | "You smell chlorine in the air..." |
+| Phosgene | "You catch a faint smell of fresh hay..." |
+| Mustard | "You smell garlic and mustard..." |
+| Sarin / VX | *(odourless — no hint, which is exactly what makes them dangerous)* |
+
+Wearing a gas mask suppresses the hint, and each unit only gets each smell once per life. This can be disabled mission-wide via the *Enable Smell Hint* setting.
+
+### Visual cloud cheat-sheet
+
+| Cloud colour | Likely agent |
+|--------------|--------------|
+| White / pale | CS |
+| Greenish-yellow | Chlorine |
+| Pale grey-white | Phosgene |
+| Thick brown-yellow | Mustard |
+| Almost invisible, faint warm shimmer | Sarin |
+| Oily amber, slow to disperse | VX |
+
+> If a mission has turned off the *Enable Gas particle effects* setting, clouds are invisible regardless of agent — fall back on M8 paper, the JCAD detector, and smell to know what you're in.
+
+---
+
+## Equipment & Items
+
+| Item | Classname | Weight | Purpose | How to use |
+|------|-----------|--------|---------|------------|
+| M8 Detection Paper | `kat_m8paper` | 0.1 kg | Identifies nerve/blister agents | *Use M8 Detection Paper* self-action |
+| M291 Decontamination Kit | `kat_decon_kit` | 4 kg | Removes mustard/VX skin contamination | *Decontaminate* self-action (only shown when contaminated) |
+| ATNAA Auto-injector | `kat_atnaa` | 0.5 kg | Nerve-agent antidote (sarin, VX) | *Administer ATNAA* in the medical menu |
+| JCAD Chemical Detector | `KAT_ChemicalDetector` | — | Live agent identification & intensity | *JCAD* self-action menu (turn on / warning tone) |
+| Gas Mask Filter | `kat_gasmaskFilter` | 1 kg | Resets spent mask filter life | *Replace gas mask filter* self-action |
+| Sealant Tube | `kat_sealant` | 3 kg | Seals leaking contaminated objects | Seal action on a sealable source |
+
+> `kat_atnaa` lives in the **pharma** addon; everything else is in **chemical**. All items are available through ACE Arsenal.
+
+---

docs/Chemical/Info_and_QuickStart.md

@@ -0,0 +1,22 @@
+## FAQ & Troubleshooting
+
+**My gas mask isn't protecting me from the mustard/sarin/VX cloud.**
+That's intended. Level 2 agents go through the skin — you need a full CBRN suit, meaning a mask **and** a uniform that's on the *Available CBRN Suit Uniforms* whitelist. Check that your unit's uniform classname is in that setting.
+
+**I left the cloud but I'm still taking damage / coughing.**
+Two possibilities. If it's mustard or VX, you're **contaminated** — the agent is still on you and re-poisons you every 40 seconds. Use a **Decontamination Kit**. If it's phosgene, the **delayed onset** has caught up with you (2–6 minutes after exposure) — use **Atropine**.
+
+**I gave the casualty ATNAA but they went into cardiac arrest anyway.**
+For sarin, the ATNAA has to be administered **before** the cardiac-arrest deadline (90 seconds by default). For VX, ATNAA alone isn't enough — the skin contamination re-applies the agent and starts a new chain, so you must **also** use a decon kit. Re-administer ATNAA and follow up with decon.
+
+**M8 paper says NEGATIVE but people are getting sick.**
+M8 paper only detects nerve and blister agents. Chlorine and phosgene are choking agents and will always read NEGATIVE — that's realistic. Use the JCAD detector or smell hints for those.
+
+**Nothing shows up in the medical menu.**
+Check the *Show Poisoning* setting is enabled. If it's off, poisoning and intoxication are intentionally hidden from the menu.
+
+**AI mortars never fire sarin/VX/mustard.**
+Correct — AI mortars are restricted to choking agents by design. Use the gas module, Zeus, or a player-crewed mortar to deploy the Level 2 agents.
+
+---
+Last editet: 18.06.2026

docs/Chemical/detection_identification_items.md

@@ -0,0 +1,84 @@
+## The Six Agents (Gases)
+
+A bird's-eye comparison first, then the details.
+
+| Agent | Class | Tier | Cloud look | Smell | Onset | Lethality | Treatment |
+|-------|-------|------|-----------|-------|-------|-----------|-----------|
+| **CS / Tear gas** | Riot control | 0 | White / pale | None | Immediate | Non-lethal | Leave the cloud; wears off |
+| **Chlorine** | Choking | 1 | Greenish-yellow | Sharp chlorine | ~30 s in cloud | Low–moderate | Atropine |
+| **Phosgene** | Choking | 1 | Pale grey-white | Faint fresh hay | **Delayed 2–6 min** | High (sneaky) | Atropine |
+| **Mustard** | Blister | 2 | Brown-yellow | Garlic / mustard | Builds over minutes | Moderate, disabling | Decon kit (+ wound care) |
+| **Sarin** | Nerve (G) | 2 | Nearly invisible | None | Fast (~90 s to death) | **Very high** | ATNAA |
+| **VX** | Nerve (V) | 2 | Oily amber | None | Slower but persistent | **Very high** | ATNAA **and** decon kit |
+
+### CS / Tear Gas (Level 0)
+
+The non-lethal one. CS is a riot-control irritant — it won't injure anyone medically, but it's miserable to be in. A gas mask protects the airway; note that CS still affects the **eyes** even through an oxygen mask, so it's not something you can simply ignore.
+
+- **Cloud:** white / pale, lasts about 60 seconds.
+- **Effect:** there's a configurable chance of dropping your weapon while inside the cloud (off by default — set *Drop Weapon Chance* above 0 to enable it).
+- **Treatment:** none needed. Step out and it passes.
+- **Delivery of note:** the `KAT_M7A3` hand grenade is a dedicated CS gas grenade.
+
+### Chlorine (Level 1)
+
+The classic choking agent and the direct descendant of the legacy "toxic gas." A gas mask blocks it completely.
+
+- **Cloud:** greenish-yellow, lingers around 200 seconds — the longest-lasting of the conventional clouds.
+- **Smell (unmasked):** *"You smell chlorine in the air..."*
+- **Symptoms:** after roughly **30 seconds** of exposure you start coughing and pick up air poisoning (shown as intoxication in the medical menu).
+- **Treatment:** **Atropine**. This is the backwards-compatible behaviour — anything that worked on the old toxic gas still works on chlorine.
+
+### Phosgene (Level 1) — the silent killer
+
+Phosgene is what makes a gas mask feel essential. It's a choking agent like chlorine, but its danger is *time*. You can breathe a lethal dose, feel completely fine, walk away, and collapse minutes later.
+
+- **Cloud:** pale grey-white, lasts about 90 seconds.
+- **Smell (unmasked):** *"You catch a faint smell of fresh hay..."* — easy to dismiss, which is the point.
+- **Symptoms:** nothing at first. Then, **2 to 6 minutes after exposure** (randomised per victim), pulmonary edema hits — coughing and badly reduced breathing depth, *even though you left the cloud long ago*.
+- **Treatment:** **Atropine** clears it. The trick is realising you were dosed before the symptoms arrive.
+- **Important:** M8 paper reads **NEGATIVE** for phosgene — detection paper does not react to choking agents. Don't trust a clean M8 result as "all clear."
+
+### Mustard / Yperite (Level 2) — gets worse over time
+
+A blister agent that requires the full CBRN suit. Mustard doesn't kill quickly; it disables, and it keeps hurting you long after you've left the cloud because it contaminates your skin and gear.
+
+- **Cloud:** thick brown-yellow, lasts about 120 seconds.
+- **Smell (unmasked):** *"You smell garlic and mustard..."*
+- **Progression (with default timings):**
+  1. **On contact:** skin contamination is applied immediately (visible in the medical menu).
+  2. **~40–100 s:** eye injuries set in — heavy vision impairment, possibly both eyes.
+  3. **~100–240 s:** chemical burn wounds open up across the body, with lung damage and rising pain.
+  4. **Every 40 s thereafter:** while you remain contaminated, the burns keep re-applying. Leaving the cloud does **not** stop this.
+- **Treatment:** the **Decontamination Kit** is the cure — it clears the contamination and cancels the pending eye/burn timers. Burns and eye injuries that have already happened are treated as normal wounds through ACE/KAT medical. Atropine only suppresses the airway symptom, not the contamination.
+
+### Sarin (Level 2) — fast nerve agent
+
+A G-series nerve agent and the fastest killer in the set. Requires the full CBRN suit. What makes sarin terrifying is that the cloud is **nearly invisible and odourless** — you may not know you're in it until the symptoms start.
+
+- **Cloud:** faint warm tint, very hard to see; lasts about 90 seconds.
+- **Smell:** none.
+- **Progression (default timings, from first exposure):**
+  - **30 s:** vomiting begins.
+  - **60 s:** unconsciousness.
+  - **90 s:** cardiac arrest → death if untreated.
+- **Treatment:** the **ATNAA auto-injector**. Administered before the cardiac-arrest deadline, it clears the nerve-agent exposure and **aborts the cardiac arrest before it fires**. With default timings you have a 90-second window from exposure. Atropine does *not* work on nerve agents.
+
+### VX (Level 2) — slow, persistent, and the hardest to treat
+
+The other nerve agent, V-series. VX trades sarin's speed for persistence. The cloud lingers for **ten minutes** by default, and like mustard it contaminates the skin — so curing the nerve symptoms once is not enough.
+
+- **Cloud:** oily amber, visibly persistent; lasts about 600 seconds (10 minutes).
+- **Smell:** none.
+- **Progression (default timings):**
+  - **60 s:** vomiting.
+  - **120 s:** unconsciousness.
+  - **240 s:** cardiac arrest.
+- **The catch — it re-poisons you.** VX sets *both* nerve-agent exposure *and* skin contamination. ATNAA clears the nerve exposure and stops the current symptom chain, but the contamination tick fires every 40 seconds and re-applies VX, starting a fresh symptom chain each time.
+- **Treatment:** you need **two** items:
+  1. **ATNAA** — aborts the active nerve-agent symptom chain.
+  2. **Decontamination Kit** — clears the skin contamination so the tick stops re-poisoning you.
+
+  Use only the ATNAA and VX will keep coming back. Use only the decon and the already-running symptom chain still kills you. This dual requirement is the whole point of VX.
+
+---

docs/Chemical/faq_and_troubleshooting.md

@@ -0,0 +1,19 @@
+## Protection Tiers
+
+Every agent is assigned a **protection tier** that tells you what gear you need to survive it. The tier shown in module dropdowns is about *required protection*, not how dangerous the agent is.
+
+| Tier | Gear required | Agents |
+|------|---------------|--------|
+| **Level 0** | None (a mask still protects the airway; eyes are still affected by CS) | CS / Tear gas |
+| **Level 1** | Gas mask | Chlorine, Phosgene |
+| **Level 2** | **Full CBRN suit** — gas mask **and** a whitelisted uniform | Mustard, Sarin, VX |
+
+### What counts as protection
+
+- **Gas mask** — any mask in the accepted-masks list. Out of the box that's `G_AirPurifyingRespirator_01_F`, `kat_mask_M50`, and `kat_mask_M04`. A mask must actually be worn and still have filter life remaining.
+- **Filter life** — masks last **15 minutes** of active protection by default. When the filter is spent, the mask stops protecting you. Carry a **gas mask filter** (`kat_gasmaskFilter`) and use the *Replace gas mask filter* self-action to reset it.
+- **CBRN suit** — for Level 2 agents the mask alone is not enough. You also need a uniform that the mission has whitelisted. The default whitelist contains the vanilla CBRN suit (`U_C_CBRN_Suit_01_Blue_F`); mission makers add their own (see [CBA settings](#mission-configuration-cba-settings)).
+
+> **Common mistake:** wearing a mask into a mustard or sarin cloud and assuming you're safe. You're not. Level 2 agents go through the skin — only the full suit stops them.
+
+---