Weapon tints in FiveM: every tint index and how to set it

#Tints for normal weapons (0–7)

local ped = PlayerPedId()
SetPedWeaponTintIndex(ped, `WEAPON_PISTOL`, 2) -- gold
print(GetPedWeaponTintIndex(ped, `WEAPON_PISTOL`)) -- 2

#Tints for Mk II weapons (0–31)

Mk II weapons use an extended palette of 32 tints, which is why the same index gives a different colour on a Mk II gun than on its normal version. Rather than hard-coding a table that may differ between game builds, read the count and let players cycle through them in your UI:

local ped = PlayerPedId()
local weapon = GetSelectedPedWeapon(ped)
local count = GetWeaponTintCount(weapon)
local current = GetPedWeaponTintIndex(ped, weapon)

SetPedWeaponTintIndex(ped, weapon, (current + 1) % count)

#Saving tints with the weapon

The game forgets tints when the player disconnects or the weapon is removed. On ox_inventory, a weapon’s metadata can hold a tint value that the inventory applies when the weapon is equipped, so the tint follows that exact weapon — through a stash, a trade or a drop. See ox_inventory metadata.

exports.ox_inventory:AddItem(source, 'WEAPON_PISTOL', 1, { tint = 2 })

#Beyond tints

Tints only recolour the weapon’s material with a preset palette. For finishes, camos or your own logo on the weapon, you need components or a texture change: see Mk II camos and making a weapon skin.