Configuration

This page documents all configuration options available in ARS VVS Guns V2.

Core Settings

Config.Framework = 'esx' -- 'esx' or 'qb'

The server framework. Must match your server framework (ESX Legacy or QBCore).

Config.Debug = false

Enable debug mode for console logging. Useful for troubleshooting.

Inventory Settings

Config.Images = 'nui://ox_inventory/web/images/'
Config.ImagesFileExtension = '.png'

Inventory image path and file extension. Update based on your inventory system:

ox_inventory: nui://ox_inventory/web/images/
qb-inventory: nui://qb-inventory/html/images/
qs-inventory: nui://qs-inventory/html/images/
ps-inventory: nui://ps-inventory/html/images/

Config.CheckCanCarryItem = false

When enabled, checks if player can carry item before purchase.

Config.UseStash = true

Enable job stash access for shop employees.

Config.SocietyInBank = true

Controls which banking system handles society money for QBCore. This setting only applies when okokBanking and ars_banking are not running (they are auto-detected and take priority).

Value	Banking System	QBCore Version
`true`	qb-banking	New QBCore (separate banking resource)
`false`	qb-management	Old QBCore (society in management)

See the Society Banking Setup guide for detailed setup instructions for all supported banking systems.

Config.UseTatget = true

Use ox_target for interactions. Set to false to use legacy marker interactions (Press E when near location).

Skill Check Settings

Config.ShowSkillCheckUI = false

Show skill check mini-game UI after crafting process is complete.

Config.SkillCheckMiniGame = function()
    return lib.skillCheck({ 'easy', 'easy', 'easy' }, { 'a', 's', 'd' })
end

Custom skill check configuration. Adjust difficulty and keys as needed.

Shop Defaults

Config.Default = {
    stock = 5,
    price = 1000000,
}

Default stock and price for new items added to shops.

Config.Pricerange = {
    min = 1,
    max = 999999999,
}

Minimum and maximum price range for items in the shop management interface.

Shop Configuration Structure

Each shop in Config.Shop requires these keys. The default shop is named vvsgundealer and is configured in shops/vvsgundealer.lua.

Important: You can add multiple shops by creating new files in the shops/ folder (e.g., shops/newshop.lua). Each shop file should follow the same structure as the default vvsgundealer.lua.

Supported Weapons

The script supports 25 weapons from the VVSGUNV2 weapon pack:

Pistols

G45 (WEAPON_G45VVR)
G17 (WEAPON_G17VVR)
G17S (WEAPON_G17SVVR) - Requires switch attachment
G40 (WEAPON_G40VVR)
Deagle (WEAPON_DEAGLEVVR)
SM17 (WEAPON_SM17VVR)
M45 (WEAPON_M45VVR)
FN5 (WEAPON_FN5VVR)

Assault Rifles

AR15C (WEAPON_AR15CVVR)
AR15T (WEAPON_AR15TVVR)
Draco (WEAPON_DRACOVVR)
ARP (WEAPON_ARPVVR)
Bruen (WEAPON_BRUENVVR)
AK102 (WEAPON_AK102VVR)

Sub Machine Guns

APC (WEAPON_APCVVR)
Thompson (WEAPON_THOMPSONVVR)
MP7 (WEAPON_MP7VVR)
ARP9 (WEAPON_ARP9VVR)
P90 (WEAPON_P90VVR)

Shotguns

SPAS12 (WEAPON_SPAS12VVR)

Melee Weapons

Bowie Knife (WEAPON_BOWIEVVR)
Butterfly Knife (WEAPON_BUTTERFLYVVR)
Katana Dragon (WEAPON_DRAGONKATANAVVR)
Karambit (WEAPON_KARAMBITVVR)
Tactical Axe (WEAPON_TACTICALAXEVVR)

Attachments

Extended Magazine 1 (extendedmag1)
Extended Magazine 2 (extendedmag2)
Extended Magazine 3 (extendedmag3)
Scope (scope)
Suppressor (suppressor)
Laser (laser)
Grip (grip)
Gold Camo (goldcamo)
Diamond Camo (diamondcamo)

Crafting Materials

Pistol Parts (partspistol)
Rifle Parts (partsrifle)
Advanced Rifle Parts (partsrifle2)
Shotgun Parts (partsshotgun)
SMG Parts (partssmg)
Weapon Switch (switch)
Weapon Black Finish (weaponblack)
Gunpowder (gunpowder)
Empty Shell (emptyshell)
Gold Bar (gold_bar)
Diamond (diamond)

Note: All weapons require proper item definitions in your framework and inventory config files. See Installation Guide for detailed setup instructions.

Key	Type	Description
`blip`	table	Map blip settings (sprite, color, size, radius)
`description`	string	Shop welcome message
`logo`	string	Logo image path
`boss_action`	vector3	Boss menu location coordinates
`management`	vector3	Management menu location coordinates
`managementRankFor`	table	Grade requirements for management tasks
`autoStock`	table	Auto-restocking configuration
`crafting`	table	Crafting system configuration
`storage`	table	Storage system configuration
`sell_coords`	table	Shop entrance coordinates for players
`stash`	table	Employee stash configuration
`data`	table	Market items and pagination

Example Shop Configuration

Config.Shop['vvsgundealer'] = {
    blip = {
        enable = true,
        name = 'VVS Guns',
        sprite = 617,
        color = 3,
        size = 0.8,
        radius = 0.0,
        radius_color = 4
    },
    description = 'Welcome to VVS Guns, how can we help you today?',
    logo = 'images/vvsguns.png',
    boss_action = vector3(351.0538, 3394.9087, 37.6834),
    management = vector3(349.0309, 3405.8740, 36.8514),
    managementRankFor = {
        price = 2,  -- Minimum grade to change prices
        stock = 2,  -- Minimum grade to manage stock
    },
    autoStock = {
        enable = false,
        slots = 10,
        regeneration = 10,
        add = 10
    },
    crafting = {
        menu = vector3(357.9569, 3409.7681, 37.2231),
        data = {
            WEAPON_G45VVR = {
                reward = 1,
                required = {
                    { item = 'partspistol', quantity = 1, willremove = true },
                },
                steps = {
                    { pos = vector4(370.9619, 3401.7300, 36.2927, 206.2020), delay = 10, msg = 'Gathering raw materials...' },
                    { pos = vector4(363.0826, 3399.6721, 36.2743, 195.9199), delay = 10, msg = 'Machining upper receiver...' },
                    { pos = vector4(367.4690, 3399.3438, 36.2866, 201.6882), delay = 10, msg = 'Installing internal components...' },
                    { pos = vector4(357.1966, 3404.7141, 36.2661, 2.6692), delay = 10, msg = 'Final assembly and inspection...' },
                }
            },
        },
    },
    storage = {
        pos = vector4(360.3284, 3396.3047, 36.2716, 204.0994),
        items = {
            partspistol = {
                name = 'Weapon Parts Pistol',
                price = 500,
                slots = 50,
                available = 50,
                regeneration = 60,
            },
        },
    },
    sell_coords = {
        vector3(339.8679, 3402.6123, 36.8749),
    },
    stash = {
        enable = true,
        pos = vector4(356.2418, 3402.0842, 36.2660, 110.2180),
        minGrade = 2,
        slots = 50,
        maxWeight = 100000,
    },
    data = {
        market_items = {
            WEAPON_G45VVR = {
                name = "G45",
                page = 0,
                process = true,
            },
        },
        pagination = {
            [0] = { name = "Pistols", icon = 'fa-gun' },
            [1] = { name = "Assault Rifles", icon = 'fa-gun' },
            [2] = { name = "Sub Machine Guns", icon = 'fa-gun' },
            [3] = { name = "Shotguns", icon = 'fa-gun' },
            [4] = { name = "Ammo", icon = 'fa-gun' },
            [5] = { name = "Melee", icon = 'fa-gun' },
        },
    }
}

Crafting Configuration Details

Each weapon in the crafting system requires:

reward - Amount of weapon/item to create
required - Array of crafting materials (item, quantity, willremove)
steps - Array of crafting stations (position vector4, delay seconds, message)

Crafting moves the player through multiple stations with progress bars at each step.

Storage Configuration Details

Storage items support auto-regeneration:

slots - Maximum quantity available
available - Current quantity in stock
regeneration - Seconds to regenerate one item
timeleft - Time until next regeneration (auto-managed, do not edit)

Storage can be purchased with society money at configured prices.

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.