> For the complete documentation index, see [llms.txt](https://ns-scripts.gitbook.io/ns-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ns-scripts.gitbook.io/ns-scripts/pay-scripts/advanced-weapon-damage-system.md).

# Advanced Weapon Damage System

Welcome to NS Weapons!

[Advanced Weapon Damage System](https://nss.tebex.io/package/7254919) is a high-performance weapon damage management system designed for FiveM servers. It provides administrators with granular control over combat balance, allowing for real-time configuration of damage multipliers, camera shake, and headshot mechanics through an intuitive, modern in-game interface.

### ✨ Core Features

**🎮 Immersive UI Experience**

* Sleek, responsive NUI dashboard for real-time weapon tuning.
* Live telemetry overlays during testing to visualize damage output.
* Automatic weapon list detection compatible with major inventory systems.

**⚙️ Advanced Combat Tuning**

* Per-weapon damage multiplier configuration for precise balancing.
* Per-weapon camera shake intensity settings for recoil simulation.
* Headshot damage multiplier control to reward precision.

**🛡️ Administrative Control**

* Integrated weapon banning system to restrict specific items.
* In-game testing dummy with real-time damage tracking and statistics.
* Persistent settings saved to JSON for easy backup and deployment.

### 🚀 Use Cases

**Server Balancing**

* Quickly adjust weapon damage to match your server's specific combat meta or health system.

**Combat Testing**

* Use the built-in NPC dummy to test weapon effectiveness, recoil, and headshot multipliers without leaving the game.

**Anti-Cheat & Utility**

* Disable specific weapons or prevent "pistol whipping" globally to maintain server integrity.

### 🛠️ Technical Specifications

**Dependencies**

* ox\_inventory, qb-inventory, ps-inventory, or lj-inventory.

**Performance**

* 🚀 Optimized - Minimal resource usage (Idle: 0.00ms).

**Frameworks**

* ✅ QBCore & Qbox - Native bridge support included.
* ✅ ESX - Full compatibility via bridge.
* ✅ Standalone - Flexible implementation for custom setups.

**Data Storage**

* 💾 JSON - Persistent storage for all weapon configurations.

### 🔗 Support

* [Discord Support](https://discord.gg/your-link)
* [Tebex Store](https://store.your-link.com)