Introduction
ARS Weapon Meta Editor is an admin tool for FiveM servers that provides a React-based NUI panel for editing weapon and attachment statistics in real-time. Changes are saved automatically and applied without restarting your server.
Features
Section titled “Features”Core Features
Section titled “Core Features”- Full weapon stat editor with 150+ editable parameters per weapon
- Component stat editor for attachments (scopes, suppressors, magazines, etc.)
- Real-time editing with per-weapon and bulk Save All actions
- One-click reset to vanilla defaults per weapon or full reset
- Automatic weapon meta scanning from server resources
- No database required — state persisted as JSON files (
data/weapon_meta_state.json,data/native_recoil_state.json) - Live preview combat simulator with 5 target peds, auto-respawn, and hit visualization
- AI-powered weapon tuning assistant (OpenAI-compatible API)
- Stat presets for saving and loading weapon configurations
- Critical headshot disable toggle for consistent live preview testing
- Native Recoil Mode: Toggle weapons between XML-driven meta recoil and runtime FiveM native recoil (
SetWeaponRecoilShakeAmplitude,SetWeaponWeaponSpread,SetWeaponAnimationOverride) - Per-Player Recoil Overrides: Define a Global baseline plus flat overrides matching on player
job,gang, oridentifierwith explicit priority sorting (first match wins) - Recoil Spray Pattern Visualizer: Interactive canvas preview simulating deterministic weapon spray using category-based shake profiles, color gradients (Early/Mid/Late), camera path tracking, and camera shake hash resolution
- Tuning Modes: Toggle between Simple (single-slider intensity scaling) and Advanced (fine-grained control over individual recoil parameters)
- Simulation Metrics & Presets: Real-time computation of peak climb, horizontal span, camera drift, spread growth, largest shot jump, plus built-in or custom JSON presets (import/export)
Integrations
Section titled “Integrations”- Frameworks: QBCore, QBX, ESX, Standalone (
Config.Framework='qb','qbx','esx', or'standalone') - Required Libraries: ox_lib
Requirements
Section titled “Requirements”- ox_lib — Required
- QBCore / QBX / ESX / Standalone — One framework must be present and
Config.Frameworkset accordingly
Commands
Section titled “Commands”Player Commands
Section titled “Player Commands”No player commands are available. This is an admin-only tool.
Admin Commands
Section titled “Admin Commands”/weaponmeta— Open the Weapon Meta Editor UI/weaponmeta_scan— Scan all resources for weapon.metafiles and update defaults (server console or admin in-game)/weaponmeta_resetall— Reset all weapons to scanned defaults and clear overrides (server console only)
Note: This guide is written by a third party. If you find any incorrect or outdated information, please contact us on Discord so we can update it for you.