How to Add & Edit Weapons in FiveM (weapons.meta Guide)

Custom and tweaked weapons are a staple of FiveM roleplay and combat servers — adjusting damage, adding attachments, or dropping in new weapon models. This guide covers how to add and edit weapons in FiveM, and the meta files that control them.

Two kinds of weapon changes

• Editing existing weapons — changing damage, recoil, accuracy, range, clip size or flags on the base GTA weapons via weapons.meta.
• Adding new weapons — streaming a new weapon model as an add-on resource, with its own model files and meta.

Editing weapon stats (weapons.meta)

Every weapon’s behaviour lives in a CWeaponInfo block in weapons.meta: Damage, WeaponRange, AccuracySpread, RecoilShakeAmplitude, ClipSize and a long list of WeaponFlags. To change a weapon, you stream a modified weapons.meta in a resource and point to it with a data_file 'WEAPONINFO_FILE' entry in your fxmanifest.lua.

Editing that XML by hand is error-prone — our free weapons.meta editor lets you paste your file and edit every documented field, with the ~120 WeaponFlags as checkboxes, then export clean XML.

Adding a new weapon

1. Get an add-on weapon resource (model .ydr/.ytd plus its metas).
2. Place it in resources and make sure the fxmanifest.lua streams the model and registers the weapon metas.
3. ensure the resource in your server.cfg.
4. Give it to a player with GiveWeaponToPed using its name or JOAAT hash.

Weapon hashes

Natives like GiveWeaponToPed and GetHashKey work with the weapon’s JOAAT hash. Look up any weapon’s model, hash (signed/unsigned/hex), damage and ammo type in our weapons database, or compute a hash with the JOAAT hash generator.

Frequently asked questions

How do I change weapon damage in FiveM?

Edit the weapon’s CWeaponInfo Damage value in a streamed weapons.meta, registered via a data_file 'WEAPONINFO_FILE' in your fxmanifest. Use our weapons.meta editor to avoid XML mistakes.

How do I give a player a weapon in FiveM?

Use GiveWeaponToPed(ped, GetHashKey('WEAPON_PISTOL'), ammo, false, true) — pass the weapon name or its JOAAT hash.

Where do I find FiveM weapon names and hashes?

In our weapons database — every GTA V / FiveM weapon with its model name and JOAAT hash, ready to copy.