SetWeaponAnimationOverride
DocsSetWeaponAnimationOverride(ped, animStyle)Description
Changes the selected ped aiming animation style, you can find the list of animations below.
These are stored in the weaponanimations.meta file located in Grand Theft Auto V\update\update.rpf\common\data\ai\weaponanimations.meta.
For Lua, it's best if you send the animation using compile-time jenkins hashes to avoid overhead. An example is shown down below.
### Animations
enum eWeaponAnimationOverrides {
Ballistic = 0x5534A626,
Default = 0xE4DF46D5,
Franklin = 0x44C24694,
Gang = 0xBC066B98,
Michael = 0x55932F38,
MP_F_Freemode = 0xACB10C83,
Trevor = 0x2737D5AC,
Hillbilly = 0x8503D409,
Gang1H = 0x724A7AB7,
FirstPerson = 0xEE38E8E0,
FirstPersonAiming = 0xC76297A3,
FirstPersonRNG = 0xA4FDD608,
FirstPersonScope = 0x28117C22,
FirstPersonMichael = 0xEAA2550B,
FirstPersonMichaelAiming = 0x3E6FF30F,
FirstPersonMichaelRNG = 0xB7A826C1,
FirstPersonMichaelScope = 0xC554CF97,
FirstPersonFranklin = 0xC407163A,
FirstPersonFranklinAiming = 0x3D4B7B03,
FirstPersonFranklinRNG = 0xBE79B0B4,
FirstPersonFranklinScope = 0xAFEA6593,
FirstPersonTrevor = 0xA65D5351,
FirstPersonTrevorAiming = 0xF9BE8ED9,
FirstPersonTrevorRNG = 0xD181ED09,
FirstPersonTrevorScope = 0x34A67D6D,
FirstPersonMPFemale = 0x8431583F,
Fat = 0xC531A409,
SuperFat = 0x529E5780,
Female = 0x6D155A1B,
GangFemale = 0x678ADF82,
}Parameters
| Name | Type | Description |
|---|---|---|
ped | Ped | The ped handle. |
animStyle | Hash | The animation style to apply, passed as a hash. |
Quick Snippet: Get Ped Handleped
pedUse this to get the player ped handle for this native.
-- Get the player's ped handle (client-side)
local ped = PlayerPedId()
print("Ped handle: " .. ped)
-- For a specific player's ped (server-side):
-- local targetPed = GetPlayerPed(source)Ped Models

mp_m_freemode_01
player_zero
ig_agatha
s_m_y_cop_01
s_m_m_gaffer_01
g_m_m_armboss_01
a_c_boar
a_m_m_bevhills_01Returns
voidThis native does not return a value.
Examples
Official
-- Works when holding a pistol.
-- 'Hillbilly' also works for most peds.
SetWeaponAnimationOverride(PlayerPedId(), `Gang1H`)