Eyes WeaponStore V2

Eyes WeaponStore V2 - Professional Weapon Shop System for FiveM

Eyes WeaponStore V2 redefines what a weapon shop script should deliver for modern FiveM roleplay servers. This isn't a basic gun menu with clunky UI—it's a comprehensive weapon retail system that balances immersive design with practical functionality. Whether you're running an Ammunation for civilians, a police armory for law enforcement, or specialized weapon dealers for criminal organizations, this script adapts to every scenario while maintaining consistent, high-quality user experience across all screen sizes and resolutions.

What's Included in Version 2

This complete weapon shop solution provides everything needed to create professional firearm retail experiences. The system handles weapon sales, ammunition purchases, accessory attachments, and even weapon customization—all within a unified interface that feels polished and responsive. Server administrators get granular control over inventory, pricing, permissions, and categorization without touching a single line of code beyond the configuration file.

The V2 update brings significant improvements over the original release including refined UI elements with smoother animations, expanded category system supporting unlimited weapon classes, enhanced basket logic that prevents purchase errors, improved mobile/ultrawide screen compatibility, and optimized performance that reduces client-side resource usage by nearly 40%.

Core Features That Deliver Results

• Fully Responsive Design System - Automatically adapts to any screen resolution from 1280x720 to 4K ultrawide displays. The UI intelligently rescales elements, adjusts spacing, and reflows content so players on any setup get an optimal experience. No more players complaining they can't see buttons or read prices.
• Advanced Categorization Engine - Create unlimited weapon categories organized by type, caliber, profession, or any classification system you envision. Each category supports custom background images, unique color schemes, and independent pricing multipliers. Want separate categories for law enforcement, military contractors, and black market dealers? Done.
• Smart Shopping Basket - Players can add multiple weapons and ammunition quantities to a cart before checkout, review their total purchase cost, modify quantities or remove items easily, and complete transactions in a single streamlined process. Reduces accidental purchases and supports bulk buying.
• Detailed Weapon Information - Every weapon displays comprehensive stats including damage ratings, fire rate, accuracy, recoil, and effective range. Show ammunition types with caliber specifications (9mm, .45 ACP, 7.62mm NATO, etc.), magazine capacity, and special properties. Players make informed decisions rather than guessing.
• Attachment & Accessory System - Sell weapon attachments like suppressors, extended magazines, optics, and grips directly through the shop interface. Visual previews show how attachments affect weapon appearance and stats. Supports bundle deals for weapons with pre-installed accessories.
• Multi-Location Support - Configure different shop locations across the map, each with unique inventory, pricing, and access permissions. Run civilian gun stores with basic firearms, police armories with service weapons, and gang hideouts with illegal military hardware—all using the same script with different configs.
• Profession-Specific Shops - Lock entire categories or individual weapons to specific jobs/gangs. Police see service pistols and shotguns, gang members access automatic weapons, hunters get rifles and bows, military contractors view heavy ordnance. Perfect for roleplay servers with strict weapon control.
• Dynamic Pricing Controls - Set base prices, apply category-wide multipliers, create temporary sales/discounts, and adjust pricing by player rank or loyalty level. Build weapon economies that respond to in-game events or scarcity mechanics.
• Ammunition Management - Separate ammo purchasing with per-round pricing, bulk discounts for large quantities, caliber-specific restrictions, and smart inventory stacking. Players can stock up without buying a new gun every time they need bullets.

Perfect For These Server Types

• Realistic Roleplay Servers - Create immersive weapon purchasing experiences where civilians buy hunting rifles, criminals source illegal firearms, and police maintain service weapon inventories. The detailed weapon info and categorization supports serious roleplay.
• Economy-Focused Communities - Weapon shops become significant economic drivers with dynamic pricing, scarcity mechanics, and legitimate business opportunities. Players can own and operate gun stores, competing on price and selection.
• Whitelisted Law Enforcement - Run secure police armories where officers access duty weapons, specialized units get tactical equipment, and supervisors manage department inventories. The job-locking features ensure only authorized personnel access restricted firearms.
• Gang & Criminal Servers - Operate black market weapon dealers with access restricted to specific gangs or criminal organizations. Stock changes based on shipments creating scarcity and conflict over resources.
• Military Simulation Servers - Equip military faction bases with full armories containing service rifles, sidearms, machine guns, and explosives. Different loadouts for infantry, special forces, and vehicle crews all managed through one system.
• Survival & Apocalypse Servers - Control weapon availability to create survival pressure. Make ammunition scarce and expensive, limit powerful weapons to rare finds, and force players to manage resources carefully.

Framework Compatibility & Integration

✅ ESX Framework - Complete integration with all ESX versions (Legacy and 1.9.x). Automatically registers weapons with ESX item system, supports job-based restrictions using ESX jobs, integrates with esx_society for business ownership, and works with popular ESX economy systems. Drop-in compatible with most ESX weapon scripts.

✅ QBCore Framework - Full QBCore support including QB-Core inventory integration, job permission system compatibility, and metadata support for weapon attachments. Works seamlessly with qb-weapons, qb-inventory, and qb-shops. Includes pre-configured QB setup examples.

Flexible Configuration: Choose your framework in the config file with a single setting change. The script automatically adapts database calls, inventory methods, and permission checks to match your framework's architecture.

Customization & Branding Options

Every visual element can be customized to match your server's aesthetic. Change color schemes with hex color codes, upload custom background images for categories and shop locations, modify font styles and sizes, adjust element positioning and spacing, and rebrand with your own shop names and logos. The UI framework separates styling from functionality, making visual customization straightforward even for non-developers.

Server owners create unique weapon shop identities—urban gun stores with street aesthetics, upscale sporting goods retailers with refined styling, military surplus dealers with tactical branding, or futuristic weapons merchants with cyberpunk themes. The system adapts to any creative vision.

Advanced Configuration Features

• Weapon Annotations System - Add detailed descriptions, lore information, usage warnings, and legal status notes to any weapon. Enhance roleplay with background stories for unique firearms or explain mechanics with in-universe documentation.
• Stock Management - Enable limited inventory where shops run out of popular weapons until restocked. Create supply chain gameplay where weapon dealers must source inventory, pay for shipments, and manage stock levels strategically.
• Purchase Cooldowns - Prevent rapid weapon buying with configurable cooldown timers. Stop players from buying 10 pistols in 30 seconds or limit how often they can access restricted weapon categories.
• Transaction Logging - Every purchase is logged with buyer identity, items purchased, prices paid, and timestamp. Admins can track weapon flow for balance monitoring or investigation of rule violations.
• License Requirements - Require players to have weapon licenses before purchasing firearms. Integrate with license systems to create realistic gun control mechanics where legal purchases need proper documentation.
• Rank-Based Discounts - Reward loyal customers or faction members with pricing discounts based on rank, loyalty level, or VIP status. Encourages player retention and adds progression depth.

Installation & Setup Process

1. Extract Resource Files - Place the Eyes WeaponStore folder into your server's resources directory.
2. Install Dependencies - Ensure your framework (ESX or QBCore) is properly configured and running. The script requires no additional dependencies.
3. Import Database - Run the included SQL file if your framework requires weapon tables (some frameworks handle this automatically).
4. Configure Framework Selection - Edit config.lua and set your framework type (ESX or QB). The script will automatically adapt.
5. Customize Inventory - Edit the weapons.lua file to add your available firearms, set prices, assign categories, and define attachment options.
6. Set Shop Locations - Configure shop coordinates where players can access the weapon store. Add blips, markers, and interaction prompts.
7. Configure Permissions - Define which jobs/gangs can access which categories using the job-lock features in the config.
8. Customize Appearance - Upload custom backgrounds, adjust colors, and modify UI elements to match your server branding.
9. Test Thoroughly - Verify purchases work correctly, weapons spawn properly, prices calculate accurately, and framework integration functions as expected.
10. Launch & Monitor - Restart server, inform players, and monitor transaction logs for any issues or balancing concerns.

What Makes Eyes WeaponStore V2 Stand Out

Most weapon shop scripts suffer from one of two problems—they're either beautifully designed but functionally limited, or feature-rich but visually dated and clunky. Eyes WeaponStore V2 solves this false dichotomy by refusing to compromise on either front. The UI genuinely looks professional with smooth animations and thoughtful design, while the backend delivers enterprise-level features and configurability.

The responsive design isn't just marketing—the system actually works flawlessly across screen sizes because it uses percentage-based layouts and intelligent breakpoints rather than hardcoded pixel positions. Players on 21:9 ultrawide monitors see the same properly formatted interface as someone on a basic 1080p laptop.

The basket system alone saves countless support headaches. Players can review their entire purchase before committing, preventing I accidentally bought the wrong gun complaints. The clear pricing breakdown shows exactly what they're paying for weapons versus ammunition versus attachments.

Performance & Optimization

• Client Resource Usage: 0.00ms when closed, 0.01-0.03ms when shop is open (tested with 100+ weapon inventory)
• Database Queries: Optimized single-query loading with proper indexing (sub-50ms load times)
• Memory Footprint: ~8MB for UI assets and weapon data (minimal)
• Network Sync: Efficient client-server communication prevents purchase duplication or desync issues
• Compatibility: Conflicts with no known major resources, works alongside other shop systems

Business & Economy Integration

For servers with business ownership systems, this weapon shop supports full commercial integration. Players can purchase gun store businesses, set their own markup percentages on weapons, manage inventory procurement and costs, hire employees with sales commission, and compete with other dealers on price and selection. The transaction logging provides all data needed for accounting and tax systems.

Weapon shops become strategic assets that generate passive income while requiring active management. Owners must balance competitive pricing against profit margins, maintain inventory levels to avoid stockouts, and market their selection to attract customers away from competitors.

Support & Documentation

Purchase includes comprehensive documentation covering installation, configuration, customization, and troubleshooting. Example configurations for common setups (civilian Ammunation, police armory, gang weapon cache) are included. Support is provided through Discord with active developer assistance for technical questions and integration challenges.

Technical Requirements

• FiveM Server (artifact 4752 or newer recommended)
• ESX Framework (Legacy or 1.9.x) OR QBCore Framework
• MySQL Database (oxmysql, mysql-async, or ghmattimysql)
• Basic Lua configuration knowledge
• No additional dependencies required

Deliver a weapon purchasing experience that enhances immersion, supports your server economy, and actually works reliably—Eyes WeaponStore V2.

Related FiveM Weapon Mods

• Premium Crafting
• QBCore Advanced Shops: Store/Vehicle/Weapons/Movable
• Premium Inventory Script
• Store Robberies