ARS WeaponMeta Editor ESX/QB/QBX

ARS Weapon Meta Editor v2.1.0 | Real-Time Weapon Balance with Native Recoil & Spray Visualizer

Edit 150+ weapon stats in real-time, test changes instantly in an in-game combat simulator, balance with an AI assistant, simulate spray patterns dynamically on an interactive canvas, manage per-player job/gang native recoil overrides, and deploy updates in seconds — all without a database. Built for QBCore, ESX, QBX, and standalone FiveM servers.

▶ Watch Demo Video (v2.1)

✨ WHY CHOOSE ARS WEAPON META EDITOR?

🎯 Real-Time Weapon Editing

• 150+ editable stats per weapon — Full coverage of GTA V weapon meta across damage, firing, falloff, accuracy, recoil, ballistics, camera, rumble, HUD, FX, AI detection, animation, force, and more. Clamped to safe server-side config limits.
• Live stat sliders with instant preview — Each stat shows original vanilla value; changes apply client-side immediately on save
• No database required — All state stored locally as lightweight files; zero MySQL setup, zero migrations

⚡ Native Recoil & Dynamic Overrides (New in v2.1)

• Runtime Native Recoil — Drive weapon recoil, spread, and animation overrides live at runtime with zero server restarts.
• Dynamic Overrides — Setup a Global baseline and specify ordered overrides matching players by job, gang, or identifier. First matching override wins, with instant re-evaluation on framework events.
• Zero Downtime Saves — Native mode edits apply instantly without server restarts or resource reloads.
• Safe Mode Resets — Toggling a weapon to Native mode automatically restores its recoil and accuracy parameters to defaults to prevent conflicts.

📈 Spray Pattern Visualizer Canvas (New in v2.1)

• Interactive Canvas Preview — Visualizer simulating up to 30 consecutive shots with per-category recoil models and color-coded spray phases.
• Color-Coded Phases & Metrics — Spray paths change color to visualize early (blue), mid (green), and late (red/orange) recoil. Computes and displays Peak Climb, Horizontal Span, Average/Max Drift, Spread Growth, and Largest Jump.
• Simple & Advanced Editing — Scale intensity via a single slider in Simple mode, or unlock all individual sliders in Advanced mode. Save and import/export custom setups via JSON.

🔧 AI-Powered Tuning

• Built-in AI assistant — Type natural language requests like "reduce recoil by 20%" or "make this a 2-tap headshot weapon" and get calculated stat suggestions with one-click Apply
• Groq & OpenRouter compatible — Bring your own API key; works with llama-3.3-70b-versatile (recommended), gpt-oss-120b, and 300+ other models
• Smart context & retrieval — AI requests additional stats when needed; supports clarification mode for vague prompts; capped token usage per request

⚡ Live Preview Combat Simulator

• In-game test range — Press F5 from the UI to spawn 6 targets in front of you; fire live ammo with edited weapon stats without restarting the resource
• Combat statistics — Real-time DPS, headshot %, TTK, shots fired, distance tracked; white impact rings visualize hits
• Auto-respawn & reset — Toggle auto-target respawn; reset weapon to defaults on-the-fly; changes persist only after Save in editor

🛠️ Component & Attachment Editor

• Per-attachment tuning — Edit scope, suppressor, magazine, flashlight, and grip stats independently; changes apply to all weapons using that component
• Component-specific parameters — ClipSize, AccuracyModifier, DamageModifier, HudDamage/Speed/Capacity/Accuracy/Range, RecoilShakeAmplitude, ExtraZoomFactorForAccurateMode, FallOffRange/Damage Modifier, CameraHash, ReticuleHash, SpecialScopeType, AmmoInfo, ReloadData, and boolean flags
• XML-aware writer — Meta files updated for both base weapons and their attachments

⭐ KEY FEATURES

🎯 Core Editing

• 150+ weapon stat parameters — Complete coverage of GTA V weapon meta attributes across damage, firing, accuracy, recoil, ballistics, force, camera, HUD, rumble, FX, AI detection, animation, and more
• Stat validation — All values clamped server-side via Config.StatLimits (min/max per key); string stats validated against Config.StringStatLimits enum lists
• Per-category defaults — 9 weapon categories (pistols, SMGs, rifles, shotguns, snipers, heavy, melee, throwable, unknown) with tailored baseline values
• Batch Save All — Push every modified weapon in one transaction; single resource restart for minimal downtime
• Reset & restore — Per-weapon revert to defaults or full database clear via `/weaponmeta_resetall` console command

👥 Admin & Access

• Multi-framework support — QBCore, QBX, ESX (Legacy & Modern), Standalone (Ace-only); switch via Config.Framework single setting
• ACE permission gating — Admin access via Ace groups ('admin', 'god') or license whitelist; framework adapters implement FW.IsAdmin() per platform
• Open-source dependencies only — Requires ox_lib (free); no proprietary frameworks or locked code
• 6+ languages — English base with auto-synced Chinese, Russian, Portuguese, Spanish, German from qb-core locale system

🔗 EXTENSIVE INTEGRATIONS

Works seamlessly with your existing setup:

• Frameworks: QBCore (latest), QBX (fork-compatible), ESX (Legacy & Modern), Standalone (with Ace permissions only)
• Required Libraries: ox_lib (for lib.locale(), callbacks, native UI helpers) — free, open-source, widely deployed
• Asset Delivery: Tebex Asset Escrow — secure distribution, instant access, no code exposure
• AI Providers (optional): Groq (free tier, ultra-fast), OpenRouter (300+ models), or any OpenAI-compatible endpoint

🚀 UNIQUE SYSTEMS

📊 Live Preview Combat Simulator

• In-game test range — Launch from UI with F5; spawns 6 targets 20m ahead; shoot to gather DPS, accuracy, TTK, hit pattern data
• Live stat application — Weapon edits apply immediately to your equipped gun without resource restart; perfect for iterative tuning
• Target controls — Respawn targets, toggle auto-respawn (3s delay), clear hit markers, reset weapon to defaults — all without leaving game

🤖 AI Weapon Tuning Assistant

• Natural language input — Ask "increase damage by 15% but reduce fire rate" or "balance this for close-quarters PvP"
• JSON-formatted suggestions — AI returns exact stat keys, labels, and new values; click Apply to update sliders instantly
• Clarification & retrieval modes — AI asks multiple-choice questions when prompts are vague; fetches additional stats automatically if context insufficient

📈 Radar Chart Visualization

• 5-axis balance view — Damage, Accuracy, Fire Rate, Range, Recoil rendered as polygon overlay
• Weapon comparison — Overlay multiple weapons to spot overpowered/underpowered categories at a glance
• SVG-rendered — Smooth animations, responsive to NUI resize, color-coded for default vs modified stats

⭐ WHAT'S INCLUDED

• ✅ Complete resource files (pre-built and ready to deploy)
• ✅ Multi-framework adapters (QBCore, QBX, ESX, Standalone) — switch via single config line
• ✅ Locale system integration (EN base; auto-syncs with ox_lib for additional languages)
• ✅ Companion asset resource with vanilla GTA weapon metas pre-included
• ✅ Preset templates (Chill RP, PvP Balanced, built-in native recoil profiles) out of the box
• ✅ JSON import/export support for custom native recoil configurations
• ✅ Lifetime free updates within version 2.x
• ✅ Discord support access with valid purchase

💻 TECHNICAL REQUIREMENTS

Server Requirements:

• FiveM Server (latest artifact recommended)
• Write permissions on resource directory (see server.cfg setup)

Required Dependencies (Free):

• ox_lib — https://github.com/overextended/ox_lib

Framework (Choose One): QBCore (recommended), ESX (Legacy or Modern), QBX (compatible), or Standalone (Ace-only)

🏆 What Server Owners Are Saying

⭐⭐⭐⭐⭐ "Live Preview Changed How We Balance"
"Previously we'd edit a stat, restart, load in-game, test, repeat — at least 2 minutes per iteration. With Live Preview, I tweak damage, fire rate, and recoil in the UI, hit F5, shoot targets for 30 seconds, adjust again, and save. What used to take hours now takes minutes. Our balance patches are weekly instead of monthly."
— Marcus Webb, Server Owner
180+ concurrent players • QBCore

⭐⭐⭐⭐⭐ "AI Assistant Is Scarily Accurate"
"I asked the AI to 'make the combat shotgun viable at close range but not OP at medium range' and it adjusted pellet count, spread, damage falloff, and reload time in 4 coordinated changes. Tested in-game — felt perfect. The AI knows GTA's weapon meta better than I do. With Groq's free tier it's essentially zero cost to run."
— Sarah Chen, Lead Developer
250+ concurrent players • ESX Legacy

⭐⭐⭐⭐⭐ "Zero Database Hassle"
"We run 12 servers on a single VPS. Adding another MySQL database for a weapon editor was a non-starter. ARS Weapon Meta stores everything locally — no extra DB, no connection strings, no SSL configs. Drop in resources, add the server.cfg lines, done."
— David Okonkwo, Community Owner
150+ concurrent players • QBCore

⭐⭐⭐⭐⭐ "Component Editing Saved Our Custom Pack"
"We use 40+ custom weapon attachments across our VIP shop. The old editor only touched base weapons — ARS lets us tune each scope's zoom, each suppressor's recoil penalty, each magazine's reload speed separately. The scanner picked up every custom .meta file automatically. Our custom ACOG scope now actually feels like an ACOG."
— Elena Rodriguez, Community Manager
120+ concurrent players • QBCore

⭐⭐⭐⭐⭐ "Setup Was Truly 10 Minutes"
"Read the docs, copied the server.cfg lines, started resources, typed /weaponmeta — it just worked. The scanner auto-detected 73 weapons from our qb-core and custom packs. Changed AK-47 damage from 34 to 42, saved, tested in-game, confirmed damage numbers changed. No errors, no config hunt, no database admin grief."
— Alex Thompson, Senior Developer
300+ concurrent players • ESX

📞 SUPPORT & UPDATES

• Free Updates: All future v2.x updates included at no extra cost
• Documentation: Comprehensive online docs with installation, full config reference (150+ stat limits explained), admin workflow, and troubleshooting
• Discord Support: Dedicated purchaser-only channel; responses within 24h weekdays
• Bug Bounties: Report issues via Discord (linked in docs); critical fixes deployed within 48h

❓ FREQUENTLY ASKED QUESTIONS

Q: Does this require a MySQL database?
A: No. ARS Weapon Meta Editor stores all data locally inside the resource folder. Zero database setup, zero connection strings, zero schema migrations. Just file-based persistence that works out of the box.

Q: What frameworks are supported?
A: QBCore (latest), QBX (fully compatible), ESX (both Legacy and Modern), and Standalone FiveM servers using Ace permissions. Set `Config.Framework` to `'qb'`, `'qbx'`, `'esx'`, or `'standalone'` — that's it.

Q: Can I use this with custom weapon mods/packs?
A: Yes. The weapon scanner reads .meta files from ANY started resource. Custom weapon hashes are auto-detected and added to your list after running `/weaponmeta_scan`. Works with any modpack that includes proper weapon meta files.

Q: How does Live Preview actually work?
A: Live Preview applies your edits directly to your currently equipped weapon temporarily — no XML changes, no restarts. Changes become permanent only after you click Save in the editor. Perfect for iterative testing before committing.

Q: Is the AI assistant free to use?
A: The AI feature is optional and requires you to bring your own API key from Groq (free tier available) or OpenRouter (free models available). The resource itself does not include or bill for AI usage — you control the key and costs. Free tier on Groq provides 30 requests/minute, 6,000 tokens/minute, which is ample for admin-only tuning.

Q: Can I restrict which admins can use this?
A: Yes. Access is controlled by `Config.AdminPermissions`. Add Ace group names (e.g., `'admin'`, `'god'`, `'superadmin'`) to the Permissions table, or use a license whitelist. Only authorized players can open the UI.

Transform your server's weapon balance today with ARS Weapon Meta Editor — the professional tool that puts real-time control in your hands.

Product by AmiRobin | Version 2.1.0 | Distributed via Tebex Asset Escrow