Recoil System

Explore our resource’s outstanding features that enhance your server’s gameplay experience.

Key Features:

Customizable Recoil Patterns: Each weapon has unique recoil characteristics, including vertical and horizontal (right-left) recoil.
Vehicle-Specific Recoil: Special recoil patterns when shooting from vehicles, adding an extra layer of challenge to drive-bys and car chases.
First-Person Recoil Adjustment: Configurable recoil multiplier for first-person shooting, allowing for fine-tuned gameplay balance.
Component-Based Modifications: Suppressors and grips affect recoil, encouraging strategic weapon customization.
Screen Explosions: Visual feedback that enhances the feeling of powerful shots.

Configuration Options:

Config.WeaponSettings = {
    RecoilSystem = {
        Enabled = true,
        UseRightLeftRecoil = true,
        UseVehicleRecoil = true,
        UseScreenExplosions = true,
        ScreenExplosionsMultiplier = 1.0,
        UseGripMultipliers = true,
        UseSuppressorMultipliers = true,
        UseFirstPersonRecoilMultiplier = true,
        FirstPersonRecoilMultiplier = 0.7
    },
    -- Other settings...
}

Weapon-Specific Configurations:

Each weapon can be finely tuned with the following parameters:

recoil: Base vertical recoil
rightLeftRecoil: Horizontal recoil
vehicleRecoil: Recoil when shooting from vehicles
vehicleRightLeftRecoil: Horizontal recoil in vehicles
innacuracy: Innacuracy for x weapon
components: Recoil multiplier for x weapon with y component

Example for WEAPON_PISTOL:

Config.Weapons[`WEAPON_PISTOL`] = {
    damageMultiplier = 1.00,
    recoil = 5.50,
    rightLeftRecoil = 1.00,
    vehicleRecoil = 1.10,
    vehicleRightLeftRecoil = 2.00,
    inaccuracy = 0.15,
    overheatThreshold = 200.0,
    degreesPerBullet = 4.0,
    cooldownRate = 0.2,
    jamPercentage = 0.08,
    components = {
        suppressor = {
            hash = `COMPONENT_AT_PI_SUPP_02`,
            temperatureMultiplier = 0.8,
            recoilMultiplier = 0.9
        },
        grip = {
            hash = nil,
            temperatureMultiplier = 0.9,
            recoilMultiplier = 0.8
        }
    }
}