MTL-Advanced-Weapons
MTL-Advanced-Weapons — Durability, Recoil & Realism
Advanced weapons system for FiveM
Make combat feel real: weapon quality wears down, dirty guns jam, recoil scales with skill, custom aim reticles unlock as you improve, and long guns / pistols show on your back or hip when holstered.
Requirements
-
MTL-Bridge (required)
-
QBCore / QBox / ESX via Bridge
-
Optional gym integration via Bridge (
rtx_gym, vms_gym, KRp-Gym, or built-in shooting XP)
Core Features
Durability & Maintenance
-
Per-weapon quality / wear with configurable multipliers
-
Dirt buildup from shooting (dirty weapons wear faster)
-
F7 maintenance NUI — clean & repair
-
Optional clean/repair items + cash costs
-
World weapon repair points with costs
Weapon Jam
-
Damaged weapons can jam mid-fight
-
Clear jam with progress bar (E)
-
Configurable quality threshold & jam chance
Recoil & Skill
-
Recoil reduced by gym strength / condition / shooting / stamina (best skill wins)
-
Built-in shooting XP if no gym resource
-
Sniper steadiness unlock (rock-steady aim at skill threshold)
Combat Roll Lock
-
GTA combat roll gated until shooting skill unlocks
-
Optional: only while armed / aiming
Custom Aim Reticle (F7 → Aim)
-
Unlock styles & colors by skill level (dot, cross, chevron, diamond, and more)
-
Hide default reticle; optional first-person hide (snipers allowed)
Ammo Capacity
-
Realistic ammo caps by ammo type
-
Extended clip / drum bonuses
-
Buyable capacity packs (tiers) saved on the weapon
-
Admin
/setammo support
Holster & Visuals
-
Weapons on back (rifles/shotguns) and side holster (pistols)
-
Job-based hip-holster draw animations (police jobs) vs intimidation-style back draw
-
Attachment install animations & timings
-
Reload animations + progress
Pistol Whip
-
Melee with a handgun near a ped — knock down NPCs or players (server-validated)
-
Configurable range, damage, cooldown, weapon list
Damage & Throwables
-
Damage handling system + throwables support
-
Durability blocklist for weapons you don’t want to wear down
Localization
Includes many locales (en, fr, es, de, and more) — set Config.Locale
Frameworks
QBCore ✅ | QBox ✅ | ESX ✅
Current Version: 1.0.0