Every GTA V weapon name and hash, for FiveM scripts

#Names, hashes and the two ways a hash is printed

GTA V identifies weapons, vehicles, peds and almost everything else by a 32-bit hash of their name, produced by Bob Jenkins’ one-at-a-time function, which the modding community calls joaat. The function lowercases the name first, so capitalisation never matters.

The same 32 bits can be read two ways. As an unsigned number WEAPON_ASSAULTRIFLE is 3220176749 (0xBFEFFF6D); read as a signed 32-bit integer it is −1074790547. GetSelectedPedWeapon and several other natives hand back the signed form, which is why a comparison against a hash copied from a website sometimes fails even though both numbers mean the same weapon.

local a = GetHashKey('WEAPON_PISTOL')   -- 453432689
local b = joaat('WEAPON_PISTOL')        -- same value (CfxLua helper)
local c = `WEAPON_PISTOL`              -- same value, computed at compile time

-- Compare the weapon in hand without worrying about signed/unsigned:
local current = GetSelectedPedWeapon(PlayerPedId())
if current == `WEAPON_PISTOL` then
    print('holding a pistol')
end

// JavaScript (FiveM runtime)
const hash = GetHashKey('WEAPON_PISTOL');

// C# (CitizenFX.Core)
uint hash = (uint)API.GetHashKey("WEAPON_PISTOL");

#Pistols (20)

Sidearms, including the Mk II variants, the stun gun and the flare gun.

#Submachine guns (8)

Compact automatic weapons. WEAPON_TECPISTOL is the Tactical SMG despite its internal name.

#Assault rifles (14)

Rifles and carbines, the core of most police and gang arsenals.

#Shotguns (10)

Pump, semi-automatic and break-action shotguns, plus the musket.

#Machine guns (5)

Belt-fed and drum-fed automatic weapons.

#Sniper and marksman rifles (6)

Long-range rifles; most accept scopes as components.

#Heavy weapons (11)

Launchers, miniguns and the railguns. Most servers restrict or remove these.

#Melee (18)

Melee weapons carry no ammo; WEAPON_UNARMED (fists, 0xA2719263) is not listed as an item.

#Throwables (11)

Grenades, gas, explosives and harmless throwables such as the ball and snowball.

#Tools and misc (5)

Weapon-slot tools: fuel cans, the fire extinguisher and the metal detector.

#Addon weapons and their names

Addon weapons are not in these tables. Each one declares its own name in its weapons.meta (the <Name> of its CWeaponInfo), and that name is hashed exactly the same way. If your server uses addon weapons, read the name from the pack’s meta files, not from the file names. The full install path — metadata, inventory entry and image — is in how to add a custom weapon to FiveM, and the meta file itself is explained in weapons.meta explained.

A skinned copy of a vanilla gun, like the ones exported by the weapon studio, keeps a unique name of its own so it never replaces the original. That is also what lets two differently branded versions of the same rifle exist side by side on one server. The same list with the signed and unsigned forms side by side is on FAM Tools.

#Using the list in scripts

-- Map hashes back to names for logs and UIs
local NAMES = {}
for _, name in ipairs({
    'WEAPON_PISTOL', 'WEAPON_COMBATPISTOL', 'WEAPON_CARBINERIFLE', 'WEAPON_PUMPSHOTGUN',
}) do
    NAMES[joaat(name)] = name
end

local function weaponName(hash)
    -- natives may return the signed form; normalise to unsigned first
    if hash < 0 then hash = hash + 0x100000000 end
    return NAMES[hash] or ('unknown: ' .. hash)
end

• Store weapon names in your database and configs, never raw hashes: names survive game updates, are readable and can be searched.
• Convert to a hash at the moment you call a native.
• When logging, convert hashes back to names so staff can read the logs.
• To give a weapon to a player, see giving weapons to players.