Installation

1. Download the resource from your Cfx.re Portal and drop it into your resources folder

2. Edit your config.lua

   config.lua

   -- __          _________   __    _____                 _                                  _   
   -- \ \        / /_   _\ \ / /   |  __ \               | |                                | |  
   --  \ \  /\  / /  | |  \ V /    | |  | | _____   _____| | ___  _ __  _ __ ___   ___ _ __ | |_ 
   --   \ \/  \/ /   | |   > <     | |  | |/ _ \ \ / / _ \ |/ _ \| '_ \| '_ ` _ \ / _ \ '_ \| __|
   --    \  /\  /   _| |_ / . \    | |__| |  __/\ V /  __/ | (_) | |_) | | | | | |  __/ | | | |_ 
   --     \/  \/   |_____/_/ \_\   |_____/ \___| \_/ \___|_|\___/| .__/|_| |_| |_|\___|_| |_|\__|
   --                                                            | |                             
   --                                                            |_|                             
   Config = {}
   
   Config.RealisticFlashlight = true -- Enables realistic flashlight behavior
   Config.DisableHeadshots = true -- Disables headshots, preventing instant kills
   Config.DisableAimPunching = true -- Disables screen shake when hit by bullets
   Config.DisplayAmmo = true -- Displays ammo count on HUD
   Config.DisableHealthRegeneration = true -- Prevents automatic health regeneration
   
   Config.DisableCrosshair = true -- Disables crosshair
   Config.CrosshairWeapons = { -- Weapons wich still have crosshair
     `WEAPON_SNIPERRIFLE`,
     `WEAPON_HEAVYSNIPER`,
     `WEAPON_MARKSMANRIFLE`
   }
   
   Config.Weapons = {
     -- Pistols
     [GetHashKey('WEAPON_PISTOL')] = { recoil = 0.1, shake = 0.08, damage = 0.40 },
     [GetHashKey('WEAPON_PISTOL_MK2')] = { recoil = 0.12, shake = 0.09, damage = 0.45 },
     [GetHashKey('WEAPON_COMBATPISTOL')] = { recoil = 0.1, shake = 0.08, damage = 0.45 },
     [GetHashKey('WEAPON_APPISTOL')] = { recoil = 0.15, shake = 0.09, damage = 0.50 },
     [GetHashKey('WEAPON_PISTOL50')] = { recoil = 0.3, shake = 0.1, damage = 0.75 },
     [GetHashKey('WEAPON_SNSPISTOL')] = { recoil = 0.2, shake = 0.1, damage = 0.35 },
     [GetHashKey('WEAPON_HEAVYPISTOL')] = { recoil = 0.25, shake = 0.12, damage = 0.55 },
     [GetHashKey('WEAPON_VINTAGEPISTOL')] = { recoil = 0.2, shake = 0.09, damage = 0.40 },
     [GetHashKey('WEAPON_REVOLVER')] = { recoil = 0.6, shake = 0.12, damage = 0.80 },
     [GetHashKey('WEAPON_REVOLVER_MK2')] = { recoil = 0.65, shake = 0.14, damage = 0.90 },
     [GetHashKey('WEAPON_DOUBLEACTION')] = { recoil = 0.4, shake = 0.09, damage = 0.55 },
     [GetHashKey('WEAPON_CERAMICPISTOL')] = { recoil = 0.15, shake = 0.08, damage = 0.35 },
     [GetHashKey('WEAPON_NAVYREVOLVER')] = { recoil = 0.6, shake = 0.13, damage = 0.85 },
     
     -- Shotguns
     [GetHashKey('WEAPON_PUMPSHOTGUN')] = { recoil = 0.4, shake = 0.07, damage = 1.0 },
     [GetHashKey('WEAPON_PUMPSHOTGUN_MK2')] = { recoil = 0.45, shake = 0.08, damage = 1.2 },
     [GetHashKey('WEAPON_SAWNOFFSHOTGUN')] = { recoil = 0.5, shake = 0.08, damage = 1.1 },
     [GetHashKey('WEAPON_BULLPUPSHOTGUN')] = { recoil = 0.35, shake = 0.06, damage = 1.1 },
     [GetHashKey('WEAPON_ASSAULTSHOTGUN')] = { recoil = 0.5, shake = 0.07, damage = 0.95 },
     [GetHashKey('WEAPON_MUSKET')] = { recoil = 0.65, shake = 0.1, damage = 1.75 },
     [GetHashKey('WEAPON_HEAVYSHOTGUN')] = { recoil = 0.6, shake = 0.09, damage = 1.25 },
     [GetHashKey('WEAPON_DBSHOTGUN')] = { recoil = 0.6, shake = 0.1, damage = 1.3 },
     [GetHashKey('WEAPON_AUTOSHOTGUN')] = { recoil = 0.55, shake = 0.08, damage = 0.9 },
     
     -- Submachine Guns
     [GetHashKey('WEAPON_MICROSMG')] = { recoil = 0.55, shake = 0.05, damage = 0.5 },
     [GetHashKey('WEAPON_SMG')] = { recoil = 0.5, shake = 0.045, damage = 0.6 },
     [GetHashKey('WEAPON_SMG_MK2')] = { recoil = 0.6, shake = 0.055, damage = 0.7 },
     [GetHashKey('WEAPON_ASSAULTSMG')] = { recoil = 0.6, shake = 0.05, damage = 0.65 },
     [GetHashKey('WEAPON_GUSENBERG')] = { recoil = 0.65, shake = 0.07, damage = 0.7 },
     
     -- Rifles
     [GetHashKey('WEAPON_ASSAULTRIFLE')] = { recoil = 0.35, shake = 0.05, damage = 0.85 },
     [GetHashKey('WEAPON_ASSAULTRIFLE_MK2')] = { recoil = 0.4, shake = 0.06, damage = 0.9 },
     [GetHashKey('WEAPON_CARBINERIFLE')] = { recoil = 0.3, shake = 0.04, damage = 0.8 },
     [GetHashKey('WEAPON_CARBINERIFLE_MK2')] = { recoil = 0.35, shake = 0.05, damage = 0.85 },
     [GetHashKey('WEAPON_ADVANCEDRIFLE')] = { recoil = 0.28, shake = 0.04, damage = 0.75 },
     [GetHashKey('WEAPON_SPECIALCARBINE')] = { recoil = 0.32, shake = 0.045, damage = 0.75 },
     [GetHashKey('WEAPON_SPECIALCARBINE_MK2')] = { recoil = 0.35, shake = 0.05, damage = 0.8 },
     [GetHashKey('WEAPON_BULLPUPRIFLE')] = { recoil = 0.3, shake = 0.04, damage = 0.7 },
     [GetHashKey('WEAPON_BULLPUPRIFLE_MK2')] = { recoil = 0.35, shake = 0.05, damage = 0.75 },
     [GetHashKey('WEAPON_COMPACTRIFLE')] = { recoil = 0.4, shake = 0.055, damage = 0.7 },
     
     -- Sniper Rifles
     [GetHashKey('WEAPON_SNIPERRIFLE')] = { recoil = 0.9, shake = 0.1, damage = 2.0 },
     [GetHashKey('WEAPON_HEAVYSNIPER')] = { recoil = 1.0, shake = 0.15, damage = 2.5 },
     [GetHashKey('WEAPON_HEAVYSNIPER_MK2')] = { recoil = 1.1, shake = 0.18, damage = 2.7 },
     [GetHashKey('WEAPON_MARKSMANRIFLE')] = { recoil = 0.85, shake = 0.1, damage = 1.5 },
     [GetHashKey('WEAPON_MARKSMANRIFLE_MK2')] = { recoil = 0.9, shake = 0.12, damage = 1.6 },
     
     -- Stun Gun
     [GetHashKey('WEAPON_STUNGUN')] = { recoil = 0.0, shake = 0.0, damage = 0.0 },
   }

3. Add ensure wix_recoil to your server.cfg

4. Enjoy your Recoil and don't forget to write a rating on my Discord server