FiveM weapons.meta Editor

GTA V's weapons.meta controls every numeric value of every weapon: damage, recoil, accuracy spread, falloff range, lock-on range, fire rate, bullet velocity, ammo capacity, headshot multipliers, network damage modifiers (separate values for SP and MP), wheel-stat HUD bars, ~120 WeaponFlags that toggle behavior. The XML is verbose and the field names are obscure (RecoilAccuracyToAllowHeadShotAI, NetworkHeadShotPlayerDamageModifier, TimeLeftBetweenShotsWhereShouldFireIsCached) — most modders trial-and-error their way through it because there's no in-game help and the wiki coverage is patchy. This editor exposes every documented field with a plain-English description, a realistic min/max range pulled from real Rockstar weapons (Heavy Pistol, Assault Rifle Mk2, Heavy Sniper Mk2, Pump Shotgun Mk2), and a slider you can drag.

Workflow: paste your existing weapons.meta into the import box (or pick a preset baseline). The parser pulls every documented CWeaponInfo field, populates the form, and preserves any sub-block — `<Explosion>` (RPG/Grenade Launcher/Stickybomb explosion-tag refs), `<Fx>` (muzzle flash, smoke, tracer, shell ejection FX names), `<AttachPoints>` (component slots for sights/grips/suppressors), `<OverrideForces>` (per-bone force overrides for heavy weapons), `<FirstPersonScopeAttachmentData>` (per-scope FoV / offset data), and `<AimingInfo>` (aim-cone limits) — all kept verbatim on output. Edit anything in the form, watch the right-hand pane update live, copy or download when ready.

The editor groups fields into 8 tabs: Identity (Name, Model, Audio, Slot, HumanNameHash, StatName, Group, WheelSlot, DamageType, FireType, AmmoInfo ref), Ammo + Reload (ClipSize, ReloadTimeSP/MP, VehicleReloadTime, AnimReloadRate, BulletsPerAnimLoop), Damage (base damage, headshot mods for player + AI, head-shot distance bands, falloff range/min/max/modifier, hit-limbs modifiers, network damage modifiers, lightly-armoured modifier), Force + Range (impulse, ped/vehicle force overrides, penetration, force falloff, weapon range, lock-on range, AI sound range, blast event range), Recoil + Accuracy (accuracy spread, accurate-mode + run-and-gun modifiers, max recoil accuracy, error time, recovery rate, headshot allow threshold for AI, shake amplitude + cooldown), Timing (time between shots, fire-buffer cache, bullet speed, shotgun batch + spread, minigun spin times, alternate-fire wait), HUD (5 wheel-stat bars, reticule style hashes, scale), and Flags (~120 WeaponFlags grouped into 9 categories with one-line effect descriptions per flag).

Five baseline presets snap you into a sensible config for the common weapon archetypes: Heavy Pistol (default sidearm baseline), Assault Rifle Mk2 (full-auto rifle with FP scope), Heavy Sniper Mk2 (one-shot scope sniper, 1500m range, 5000 bullet speed, ArmourPenetrating + Penetration=9), Pump Shotgun Mk2 (8 pellets in batch, 1.0 spread, 40m range, force-eject-shell flag), and SMG (high fire rate, treated-as-one-handed-in-cover). Pick a preset, override any single field, the live preview updates instantly.

Critical gotchas the editor flags for you up-front: ReloadTimeSP/MP = -1 means "use the animation duration" not "no reload" — almost every Rockstar weapon uses -1. HeadShotDamageModifierAI = 1000.0 is NORMAL — that's how Rockstar produces one-shot NPC headshots regardless of base damage; lowering it breaks the gun. FireType = PROJECTILE makes most CWeaponInfo numeric fields IGNORED at runtime — the engine reads from the linked CAmmoInfo's projectile block instead; the editor shows a yellow banner when you switch to PROJECTILE. WeaponFlags is a single space-separated list inside ONE `<WeaponFlags>` element — multiple tags break the parser; the checkbox UI serializes correctly. GROUP_TRANQILIZER is misspelled in vanilla — preserve the typo or your weapon won't classify.

Why a dedicated editor: no free no-login web tool exists for weapons.meta. Paid Tebex / Cfx Marketplace scripts run in-game and cost $15-30 per pack. Community tutorials walk you through ~10 of the ~80 documented fields and ignore network multipliers, recoil tuning, and the projectile-vs-hitscan distinction entirely. This editor is a complete reference + edit surface in one page, free, no login. Pairs with the FiveM Weapons Database (look up real damage / hash / class for any of the 113 base GTA V / FiveM weapons) and the FiveM Vehicles Database for cross-reference.

Field reference adapted from the GTAMods Wiki under CC-BY-SA-3.0 with cross-validation against decrypted Rockstar weapons.meta files (extracted via community tools like CyCoSnag/snag_weapon_metas) — every enum literal, flag name, and reference value here has been seen in real R* shipping files; nothing is invented.