# unexis_weapondamage

Per‑weapon outgoing damage multipliers with optional per‑weapon headshot neutralization / scaling for FiveM. 100% client‑side (no server events, no persistence needed).

## ✨ Feature Overview

* Per‑weapon damage scaling (buff or nerf) using native `SetWeaponDamageModifier` (floating point precision).

* Optional headshot control (enable globally, opt‑in per weapon) that can:

    * Fully neutralize headshots (treat as body shot), or

    * Replace headshot damage with a custom scaled value (e.g. 0.5, 1.25, etc.).

* Runtime refresh event (`weaponDamage:refresh`) to re‑apply multipliers after other scripts give weapons or overwrite modifiers.

* Non‑intrusive: does NOT block other damage logic, does not modify server state.

* Lightweight health caching for accurate headshot adjustment while minimizing per‑frame cost.

* Safe fallbacks (manual bitwise band if `bit32` not present) for wider Lua compatibility.

## 🧠 Why Use This Script?

Fine control over weapon balance lets you: nerf custom overpowered mod weapons, slightly buff underused firearms, standardize variant reskins, or reduce one‑shot frustration by neutralizing headshots on selected weapons (e.g., pistols in RP shootouts). Because it runs only on clients, deployment is trivial and low‑risk.

## ✅ Requirements

* FiveM (recommended artifact supporting `lua54`).

* Runs with or without frameworks (QBCore / ESX / standalone). No framework API calls are used.