Camera shake and aim sway for FiveM weapons

#Built-in shake names

#Aim sway after sprinting

local lastSprint = 0
local shaking = false

CreateThread(function()
    while true do
        local sleep = 250
        local ped = PlayerPedId()
        if IsPedSprinting(ped) then lastSprint = GetGameTimer() end

        local tired = GetGameTimer() - lastSprint < 4000
        local aiming = IsPlayerFreeAiming(PlayerId())

        if aiming and tired and not shaking then
            ShakeGameplayCam('HAND_SHAKE', 0.6)
            shaking = true
        elseif (not aiming or not tired) and shaking then
            StopGameplayCamShaking(true)
            shaking = false
        end

        if aiming then sleep = 100 end
        Wait(sleep)
    end
end)

Start the shake once and stop it once — calling ShakeGameplayCam every frame restarts it and looks jittery.

#Injury and effect shakes

• Low health: HAND_SHAKE whose amplitude rises as health falls (SetGameplayCamShakeAmplitude).
• Drunk or drugged: DRUNK_SHAKE with the matching timecycle modifier.
• Nearby explosion: a short SMALL_EXPLOSION_SHAKE scaled by distance.

#Firing shake in weapons.meta

Lowering RecoilShakeAmplitude gives a steadier view without changing where bullets go. Real recoil (the camera kick) is a script or pattern — see the recoil script guide — and spread is AccuracySpread. Field details are in weapons.meta explained.

#Removing shake

StopGameplayCamShaking(true) stops script shakes immediately. For firing shake, edit the weapon meta or stream a meta override. Offer players a calmer option if your server is shake-heavy — accessibility keeps people around.