RK WEAPON DAMAGE

RK WEAPON MANAGER | Advanced Weapon Balancing System for FiveM

Full admin menu interface to balance damage, range, headshots, and recoil for every weapon on your server — without editing files for every change. Modern React UI, inventory-linked weapon catalog, live in-game testing with a dedicated HUD, server-side damage pipeline with body zones, and a built-in theme editor to customize the interface 100%.

KEY FEATURES — IN-GAME BALANCING

Complete Admin Menu Interface: Open the menu with a command, search weapons by name or code, adjust values with intuitive sliders, and save everything to the database — changes apply instantly for all players.

Zero Restarts for Changes: Every weapon setting (damage, range, headshot, recoil) is stored in MySQL. Update balance and the server applies it in real time, with no resource restart.

Automatic Weapon Catalog: The menu reads weapons directly from your inventory (ox, qb, qs, codem, or custom). Add addon weapons via open config files — no UI rebuild required.

Unified Interface: One menu for dashboard, weapon categories, per-weapon editor, combat testing, and theme editor — all in a single polished UI.

Brand Customization: Built-in theme editor with custom logos (sidebar, watermark), full color palette, ready-made presets, and adjustable UI transparency in real time.

Multilingual: Italian and English included, switchable from config.

WEAPON MENU

Configuration Dashboard: Instant overview with total weapons, modified weapons, active categories, and NPC test status — plus recent changes list and global search.

Organized Categories: Sidebar with Melee, Handguns, SMG, Assault Rifles, LMG, Shotgun, Snipers, Heavy, Throwables, and Custom Weapons — labels customizable from config.

Per-Weapon Modifiers: Tune four independent parameters for each weapon:

• Base Damage — multiplier on damage dealt (1.0 = standard)
• Range Modifier — how effectively damage holds at distance
• Headshot — headshot damage multiplier
• Recoil — scales native GTA behavior (1.0 = vanilla)

Give Weapon & Ammo: From the menu, give yourself the selected weapon and linked ammo, integrated with your configured inventory bridge.

Reset & Indicators: Reset individual weapons to defaults, visual badge on modified weapons, and save confirmation.

ADVANCED DAMAGE SYSTEM

Server-Side Pipeline: Intercepts hits via weaponDamageEvent, calculates custom damage on the server, and applies it to the victim — anti-cheat friendly and consistent across all clients.

Body Zone Damage: Configurable multipliers for each body part (neck, torso, abdomen, arms, legs, hands, feet) — headshots handled separately per weapon.

Distance Falloff: The range modifier controls how quickly damage drops off based on hit distance.

Smart Client Fallback: If the server pipeline doesn’t respond in time, the test HUD keeps working with client-side calculation — useful for debug and admin sessions.

Available Exports: GetAllWeaponSettings and GetWeaponSetting to integrate other scripts with your balance system.

LIVE IN-GAME TESTING

NPC Test Mode: Spawn a mannequin in front of you, shoot, and see hit zone, distance, single-shot damage, total damage, and headshot indicator in real time — with hit history and automatic respawn.

Target Mode (Shooting Range): Spawn a range target prop, position and rotate it in-game, shoot, and analyze recoil pattern with a live on-screen chart.

Dedicated Combat HUD: Side overlay during tests with controls to reposition, change distance, switch NPC/Target mode, reset stats, and quick-edit the weapon without closing the test.

Recoil Pattern Chart: Visualize every shot in a burst on an interactive graph — horizontal/vertical spread, color by shot order, and fullscreen mode for detailed analysis.

Advanced Placement: In-game positioning for NPC and target — adjustable distance, mouse-wheel rotation, and live repositioning from the HUD.

PER-WEAPON RECOIL

Scales Native Behavior: Each weapon has its own recoil multiplier — 1.0 keeps vanilla GTA recoil, higher/lower values intensify or reduce it.

Camera Shake + Drift: Vertical kick and random horizontal drift scaled by the multiplier, with configurable min/max limits.

Pattern Tracking: During target testing, every impact is recorded and shown on the chart — ideal for balancing SMGs, ARs, and automatic pistols.

THEME EDITOR

Full Color Control: Customize backgrounds, text, primary accents, and status colors (success, error, warning) with live preview on the menu.

Custom Logos: Load logos via URL or local file for sidebar and watermark — with scale, opacity, offset, and rotation.

Ready-Made Presets: Full preconfigured themes applied in one click, plus restore to default.

UI Transparency: Adjust interface opacity with a slider — useful to match your server’s visual style.

Inline Editing: In the editor, change colors and logos directly on the preview with contextual brushes.

INTEGRATIONS

All configurable from open files, without touching encrypted code:

Dual Framework: Auto-detect ESX Legacy or QBCore — or force manually from config.

Supported Inventories: ox_inventory, qb-inventory, qs-inventory, codem-inventory, and custom inventory with dedicated bridges (open files in escrow_ignore).

Catalog + Custom Weapons: Read weapons from inventory, add manual addon entries, override label/category/image, and exclude non-balance items (fire extinguisher, jerry can, etc.).

Weapon Images: Local PNGs in assets/weapon/ or URL per weapon — no UI rebuild required.

Flexible Permissions: ESX admin groups, QBCore permission, ACE permission from server.cfg — all from config.

SIMPLE CONFIGURATION

Everything via open files (escrow_ignore):

config.lua — Framework, language, commands (/weaponmanager, /weaponmanagertheme), admin permissions, body zone multipliers, recoil settings, damage pipeline, NPC/target test

inventory_config.lua — Inventory type, automatic or manual catalog

custom_weapons.lua — Addon weapons, categories, overrides, and exclusions

INVENTORY.md and CUSTOM_WEAPONS.md included with step-by-step guides for custom inventory and addon weapons

REQUIREMENTS

• ESX Legacy or QBCore
• oxmysql
• Compatible inventory (ox_inventory, qb-inventory, qs-inventory, codem-inventory, or custom)