ML Recoil | Weapon Recoil and Damage Manager

Name: ML Recoil | Weapon Recoil and Damage Manager
Brand: Micio Mods
SKU: ml_recoil

Give every gun on your server its own kick. ML Recoil controls camera recoil, climbing spray, aim sway and movement accuracy per weapon, and retunes damage without touching any game file. A trained shooter can earn a steadier aim through ML Skills. Runs on ESX, QBCore, QBox and Standalone.

Status

Gameplay

Compatible With

ESXQBCoreQBoxStandalone

Requirements

ml_bridgeox_lib

PriceFree

ML Recoil | Weapon Recoil & Damage Manager

Overview

Vanilla gunplay is point and click, every rifle laser-straight. ML Recoil gives each weapon its own kick and makes the player manage it, shot after shot: spray that climbs, aim that sways, movement that costs accuracy.

What to expect

Per-weapon profiles: camera lift, side kick, climb, shake and aim sway
Spray builds shot after shot up to a ceiling, then settles
Standing still is clean, sprinting throws the aim, crouching steadies it
Retune any weapon's damage without touching game files
One switch turns off instant headshot kills for fairer PvP
Recoil steps aside during drivebys so vehicle combat stays playable
An optional blocker stops the melee pistol whip mid-fight
Trained shooters aim steadier through the optional ml_skills link
Hooks fire on every shot, equip and aim change for your own scripts
0.00ms idle while the weapon is holstered

Works on ESX, QBCore, QBox and Standalone.

Key Features

Per-Weapon Recoil Profiles

Every weapon you list gets its own feel: vertical camera lift, a randomised left and right kick, the classic vertical climb, a camera shake preset, shake strength and aim sway. Tune each gun from one config block. Thirty-plus camera shake presets are listed right in the config to pick from.

Climbing Spray Control

Hold the trigger and the recoil builds shot after shot up to a ceiling you choose, then settles once the player stops firing for a moment. Set the per shot growth, the maximum and the reset time.

Movement-Based Accuracy

Recoil scales with how the player moves. Standing still is clean, walking and sprinting add a penalty, and dropping into a low crouch steadies the aim. Each multiplier is yours to set.

Aim-Down-Sights Sway

The first instant of aiming gives a short hand sway burst that calms after a set time, then holds a steady sway driven by the weapon's profile. Separate from the movement penalty and tuned per gun.

Classic Recoil Climb

A global switch adds GTA's classic vertical recoil climb on top of the camera kick, with the amount set per weapon. Turn it off for camera kick only if you prefer a cleaner feel.

Damage Tuning Without Game Files

Set the exact damage of any weapon without editing weapon files. The script works the value out against the gun's vanilla base and applies it cleanly, kept inside a minimum and maximum you choose.

Editable Vanilla-Damage Table

Damage is figured against an editable base damage table covering the vanilla arsenal. Running custom weapon stats already? Update the base values and every weapon stays accurate. The base table ships with 60+ vanilla weapons; guns you leave out keep their vanilla damage.

Headshot-Kill Toggle

A server wide switch turns off instant headshot deaths for fairer PvP. It applies on spawn and cleanly restores the normal behaviour when the resource stops.

ML Skills Integration

With ML Skills running, a player's accuracy rank trims their recoil so a trained shooter holds a tighter line. It only activates when ML Skills is present. The script never breaks on its own.

Recoil From Player Skill

Switch the skill source and each player's recoil comes from your server's own skill data, mapped from a skill level to a multiplier. Wire it to your own progression system and a higher rank means a steadier hand.

Catches Modified Weapons

In server skill mode, fail a player from the weapon-check hook and they take a heavy recoil penalty plus a line in your console. The penalty is built in; the check is yours to write.

Pistol-Whip Blocker

An optional switch stops the melee pistol whip while a chosen weapon is in hand. Firing never turns into a punch. It steps aside inside a vehicle so drivebys still work.

Driveby Recoil Suppression

When a player is doing a driveby, the camera kick steps aside automatically so vehicle combat stays smooth instead of throwing the view around.

Per-Weapon Skill Override

Any weapon can read a different skill than the global default. Any weapon can hand your skill hook its own skill name instead of the global default, ready for your own progression wiring.

Plug It Into Your Other Scripts

Open hooks fire on every shot, on weapon equip and on aim changes, plus a usage log point in server skill mode. Other resources can grant experience, feed analytics, or skip recoil on specific guns.

Optional Add-On Weapon Pack

Ships with recoil profiles and base damage entries for a popular add-on weapon pack out of the box. Keep it, remove the block if you do not run it, or use it as a template for your own weapons. Twenty add-on weapons ship fully profiled and damage-tuned.

Runs On Any Framework, Stays Quiet

Runs on ESX, QBCore, QBox and Standalone. The script sits quietly while a weapon is holstered and only works hard during active aimed combat, then restores damage and shake when it stops.