QS Inventory Installation

This guide covers adding all weapons, attachments, and items to qs-inventory for ARS VVS Guns V2.

Important: This guide only covers the inventory setup. You must also complete the framework installation first:

• ESX users: Follow the ESX Installation Steps 1-2 first
• QB-Core users: Follow the QBCore Installation Steps 1-5 first

---

Prerequisites

• qs-inventory installed and running
• The weapon asset pack (VVSGUNV2) installed

---

Step 1 - Items

Open qs-inventory/shared/items.lua and add the following entries to the ItemList table:

    ['weapon_apcvvr'] = {
        ['name'] = 'weapon_apcvvr',
        ['label'] = 'APC Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_APCVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A custom APC firearm.'
    },

    ['weapon_ar15cvvr'] = {
        ['name'] = 'weapon_ar15cvvr',
        ['label'] = 'AR15C Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_AR15CVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A custom AR15C rifle.'
    },

    ['weapon_ar15tvvr'] = {
        ['name'] = 'weapon_ar15tvvr',
        ['label'] = 'AR15T Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_AR15TVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A tactical AR15 rifle.'
    },

    ['weapon_arp9vvr'] = {
        ['name'] = 'weapon_arp9vvr',
        ['label'] = 'ARP9 Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_ARP9VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A compact ARP9 firearm.'
    },

    ['weapon_arpvvr'] = {
        ['name'] = 'weapon_arpvvr',
        ['label'] = 'ARP Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_ARPVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A custom ARP rifle.'
    },

    ['weapon_bruenvvr'] = {
        ['name'] = 'weapon_bruenvvr',
        ['label'] = 'Bruen Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_BRUENVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A heavy Bruen machine gun.'
    },

    ['weapon_deaglevvr'] = {
        ['name'] = 'weapon_deaglevvr',
        ['label'] = 'Deagle Custom',
        ['weight'] = 1100,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_DEAGLEVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A powerful heavy pistol.'
    },

    ['weapon_dracovvr'] = {
        ['name'] = 'weapon_dracovvr',
        ['label'] = 'Draco Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_DRACOVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A compact Draco rifle.'
    },

    ['weapon_g17svvr'] = {
        ['name'] = 'weapon_g17svvr',
        ['label'] = 'G17S Custom',
        ['weight'] = 1100,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_G17SVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A suppressed Glock 17 sidearm.'
    },

    ['weapon_g17vvr'] = {
        ['name'] = 'weapon_g17vvr',
        ['label'] = 'G17 Custom',
        ['weight'] = 1100,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_G17VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A standard Glock 17 pistol.'
    },

    ['weapon_g40vvr'] = {
        ['name'] = 'weapon_g40vvr',
        ['label'] = 'G40 Custom',
        ['weight'] = 1100,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_G40VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A Glock 40 sidearm.'
    },

    ['weapon_g45vvr'] = {
        ['name'] = 'weapon_g45vvr',
        ['label'] = 'G45 Custom',
        ['weight'] = 1100,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_G45VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A Glock 45 sidearm.'
    },

    ['weapon_mp7vvr'] = {
        ['name'] = 'weapon_mp7vvr',
        ['label'] = 'MP7 Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_9',
        ['image'] = 'WEAPON_MP7VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A compact MP7 SMG.'
    },

    ['weapon_spas12vvr'] = {
        ['name'] = 'weapon_spas12vvr',
        ['label'] = 'SPAS12 Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_SHOTGUN',
        ['image'] = 'WEAPON_SPAS12VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A powerful SPAS-12 shotgun.'
    },

    ['weapon_thompsonvvr'] = {
        ['name'] = 'weapon_thompsonvvr',
        ['label'] = 'Thompson Custom',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_RIFLE',
        ['image'] = 'WEAPON_THOMPSONVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A classic Thompson SMG.'
    },

    ['weapon_sm17vvr'] = {
        ['name'] = 'weapon_sm17vvr',
        ['label'] = 'SM17',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'WEAPON_SM17VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A compact sidearm.'
    },

    ['weapon_m45vvr'] = {
        ['name'] = 'weapon_m45vvr',
        ['label'] = 'M45',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'WEAPON_M45VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A reliable M45 pistol.'
    },

    ['weapon_fn5vvr'] = {
        ['name'] = 'weapon_fn5vvr',
        ['label'] = 'FN5',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'WEAPON_FN5VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A custom FN Five-seveN pistol.'
    },

    ['weapon_p90vvr'] = {
        ['name'] = 'weapon_p90vvr',
        ['label'] = 'P90',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'WEAPON_P90VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A compact P90 SMG.'
    },

    ['weapon_ak102vvr'] = {
        ['name'] = 'weapon_ak102vvr',
        ['label'] = 'AK102',
        ['weight'] = 1400,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'WEAPON_AK102VVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A modern AK102 rifle.'
    },

    ['weapon_bowievvr'] = {
        ['name'] = 'weapon_bowievvr',
        ['label'] = 'Bowie Knife',
        ['weight'] = 1000,
        ['type'] = 'weapon',
        ['image'] = 'WEAPON_BOWIEVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A sharp Bowie knife.'
    },

    ['weapon_butterflyvvr'] = {
        ['name'] = 'weapon_butterflyvvr',
        ['label'] = 'Butterfly Knife',
        ['weight'] = 1000,
        ['type'] = 'weapon',
        ['image'] = 'WEAPON_BUTTERFLYVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A sleek butterfly knife.'
    },

    ['weapon_dragonkatanavvr'] = {
        ['name'] = 'weapon_dragonkatanavvr',
        ['label'] = 'Katana Dragon',
        ['weight'] = 1200,
        ['type'] = 'weapon',
        ['image'] = 'WEAPON_DRAGONKATANAVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A decorative dragon katana.'
    },

    ['weapon_karambitvvr'] = {
        ['name'] = 'weapon_karambitvvr',
        ['label'] = 'Karambit',
        ['weight'] = 900,
        ['type'] = 'weapon',
        ['image'] = 'WEAPON_KARAMBITVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A curved karambit blade.'
    },

    ['weapon_tacticalaxevvr'] = {
        ['name'] = 'weapon_tacticalaxevvr',
        ['label'] = 'Tactical Axe',
        ['weight'] = 1600,
        ['type'] = 'weapon',
        ['image'] = 'WEAPON_TACTICALAXEVVR.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'A heavy tactical axe.'
    },
    ['diamond'] = {
        ['name'] = 'diamond',
        ['label'] = 'Diamond',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'diamond.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A valuable diamond.'
    },

    ['diamondcamo'] = {
        ['name'] = 'diamondcamo',
        ['label'] = 'Diamond Camo',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'diamondcamo.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A diamond weapon camo skin.'
    },

    ['extendedmag1'] = {
        ['name'] = 'extendedmag1',
        ['label'] = 'Extended Mag 1',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'extendedmag1.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'An extended magazine attachment.'
    },

    ['extendedmag2'] = {
        ['name'] = 'extendedmag2',
        ['label'] = 'Extended Mag 2',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'extendedmag2.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'An upgraded extended magazine attachment.'
    },

    ['extendedmag3'] = {
        ['name'] = 'extendedmag3',
        ['label'] = 'Extended Mag 3',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'extendedmag3.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A high-capacity magazine attachment.'
    },

    ['gold_bar'] = {
        ['name'] = 'gold_bar',
        ['label'] = 'Gold Bar',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'gold_bar.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A solid bar of gold.'
    },

    ['goldcamo'] = {
        ['name'] = 'goldcamo',
        ['label'] = 'Gold Camo',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'goldcamo.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A gold weapon camo skin.'
    },

    ['grip'] = {
        ['name'] = 'grip',
        ['label'] = 'Grip',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'grip.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A weapon grip attachment.'
    },

    ['laser'] = {
        ['name'] = 'laser',
        ['label'] = 'Laser',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'laser.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A laser sight attachment.'
    },

    ['partspistol'] = {
        ['name'] = 'partspistol',
        ['label'] = 'Pistol Parts',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'partspistol.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Parts used for crafting pistols.'
    },

    ['partsrifle'] = {
        ['name'] = 'partsrifle',
        ['label'] = 'Rifle Parts',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'partsrifle.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Parts used for crafting rifles.'
    },

    ['partsrifle2'] = {
        ['name'] = 'partsrifle2',
        ['label'] = 'Advanced Rifle Parts',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'partsrifle2.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Advanced parts for rifles.'
    },

    ['partsshotgun'] = {
        ['name'] = 'partsshotgun',
        ['label'] = 'Shotgun Parts',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'partsshotgun.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Parts used for crafting shotguns.'
    },

    ['partssmg'] = {
        ['name'] = 'partssmg',
        ['label'] = 'SMG Parts',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'partssmg.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Parts used for crafting SMGs.'
    },

    ['scope'] = {
        ['name'] = 'scope',
        ['label'] = 'Scope',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'scope.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A scope attachment.'
    },

    ['suppressor'] = {
        ['name'] = 'suppressor',
        ['label'] = 'Suppressor',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'suppressor.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A suppressor attachment.'
    },

    ['switch'] = {
        ['name'] = 'switch',
        ['label'] = 'Switch',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'switch.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A weapon switch attachment.'
    },

    ['weaponblack'] = {
        ['name'] = 'weaponblack',
        ['label'] = 'Weapon Black',
        ['weight'] = 100,
        ['type'] = 'item',
        ['image'] = 'weaponblack.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A black weapon finish.'
    },

---

Step 2 - Weapon List

Open qs-inventory/shared/weapon_list.lua and add the following entries to the WeaponList table:

    [`weapon_apcvvr`] = {
        name = 'weapon_apcvvr',
        label = 'APC Custom',
        weapontype = 'SMG',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Sprayed / Shot down / Floored"
    },

    [`weapon_ar15cvvr`] = {
        name = 'weapon_ar15cvvr',
        label = 'AR15C Custom',
        weapontype = 'Assault Rifle',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Rifled / Shot down / Floored"
    },

    [`weapon_ar15tvvr`] = {
        name = 'weapon_ar15tvvr',
        label = 'AR15T Custom',
        weapontype = 'Assault Rifle',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Rifled / Shot down / Floored"
    },

    [`weapon_arp9vvr`] = {
        name = 'weapon_arp9vvr',
        label = 'ARP9 Custom',
        weapontype = 'SMG',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Sprayed / Shot down / Floored"
    },

    [`weapon_arpvvr`] = {
        name = 'weapon_arpvvr',
        label = 'ARP Custom',
        weapontype = 'Assault Rifle',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Rifled / Shot down / Floored"
    },

    [`weapon_bruenvvr`] = {
        name = 'weapon_bruenvvr',
        label = 'Bruen Custom',
        weapontype = 'LMG',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Suppressed / Shot down / Floored"
    },

    [`weapon_deaglevvr`] = {
        name = 'weapon_deaglevvr',
        label = 'Deagle Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_dracovvr`] = {
        name = 'weapon_dracovvr',
        label = 'Draco Custom',
        weapontype = 'Assault Rifle',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Rifled / Shot down / Floored"
    },

    [`weapon_g17svvr`] = {
        name = 'weapon_g17svvr',
        label = 'G17S Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_g17vvr`] = {
        name = 'weapon_g17vvr',
        label = 'G17 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_g40vvr`] = {
        name = 'weapon_g40vvr',
        label = 'G40 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_g45vvr`] = {
        name = 'weapon_g45vvr',
        label = 'G45 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_mp7vvr`] = {
        name = 'weapon_mp7vvr',
        label = 'MP7 Custom',
        weapontype = 'SMG',
        ammotype = 'AMMO_9',
        damagereason = "Ended / Sprayed / Shot down / Floored"
    },

    [`weapon_spas12vvr`] = {
        name = 'weapon_spas12vvr',
        label = 'SPAS12 Custom',
        weapontype = 'Shotgun',
        ammotype = 'AMMO_SHOTGUN',
        damagereason = "Ended / Blasted / Shot down / Floored"
    },

    [`weapon_thompsonvvr`] = {
        name = 'weapon_thompsonvvr',
        label = 'Thompson Custom',
        weapontype = 'SMG',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Sprayed / Shot down / Floored"
    },

    [`weapon_sm17vvr`] = {
        name = 'weapon_sm17vvr',
        label = 'SM17 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_PISTOL',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_m45vvr`] = {
        name = 'weapon_m45vvr',
        label = 'M45 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_PISTOL',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_fn5vvr`] = {
        name = 'weapon_fn5vvr',
        label = 'FN5 Custom',
        weapontype = 'Pistol',
        ammotype = 'AMMO_PISTOL',
        damagereason = "Ended / Pistoled / Shot down / Floored"
    },

    [`weapon_p90vvr`] = {
        name = 'weapon_p90vvr',
        label = 'P90 Custom',
        weapontype = 'SMG',
        ammotype = 'AMMO_PISTOL',
        damagereason = "Ended / Sprayed / Shot down / Floored"
    },

    [`weapon_ak102vvr`] = {
        name = 'weapon_ak102vvr',
        label = 'AK102 Custom',
        weapontype = 'Assault Rifle',
        ammotype = 'AMMO_RIFLE',
        damagereason = "Ended / Rifled / Shot down / Floored"
    },

    [`weapon_bowievvr`] = {
        name = 'weapon_bowievvr',
        label = 'Bowie Knife Custom',
        weapontype = 'Melee',
        damagereason = "Ended / Stabbed / Slashed / Floored"
    },

    [`weapon_butterflyvvr`] = {
        name = 'weapon_butterflyvvr',
        label = 'Butterfly Knife Custom',
        weapontype = 'Melee',
        damagereason = "Ended / Stabbed / Slashed / Floored"
    },

    [`weapon_dragonkatanavvr`] = {
        name = 'weapon_dragonkatanavvr',
        label = 'Katana Dragon Custom',
        weapontype = 'Melee',
        damagereason = "Ended / Sliced / Slashed / Floored"
    },

    [`weapon_karambitvvr`] = {
        name = 'weapon_karambitvvr',
        label = 'Karambit Custom',
        weapontype = 'Melee',
        damagereason = "Ended / Stabbed / Slashed / Floored"
    },

    [`weapon_tacticalaxevvr`] = {
        name = 'weapon_tacticalaxevvr',
        label = 'Tactical Axe Custom',
        weapontype = 'Melee',
        damagereason = "Ended / Axed / Slashed / Floored"
    },

---

Step 3 - Durability and Attachments Config

Open qs-inventory/config/config.lua and merge the following.

3a. Durability multipliers

Add to Config.DurabilityMultiplier:

    weapon_apcvvr = 0.02,
    weapon_ar15cvvr = 0.02,
    weapon_ar15tvvr = 0.02,
    weapon_arp9vvr = 0.02,
    weapon_arpvvr = 0.02,
    weapon_bruenvvr = 0.02,
    weapon_deaglevvr = 0.20,
    weapon_dracovvr = 0.02,
    weapon_g17svvr = 0.20,
    weapon_g17vvr = 0.20,
    weapon_g40vvr = 0.20,
    weapon_g45vvr = 0.20,
    weapon_mp7vvr = 0.02,
    weapon_spas12vvr = 0.02,
    weapon_thompsonvvr = 0.02,
    weapon_sm17vvr = 0.02,
    weapon_m45vvr = 0.02,
    weapon_fn5vvr = 0.02,
    weapon_p90vvr = 0.02,
    weapon_ak102vvr = 0.02,
    weapon_bowievvr = 0.03,
    weapon_butterflyvvr = 0.03,
    weapon_dragonkatanavvr = 0.03,
    weapon_karambitvvr = 0.03,
    weapon_tacticalaxevvr = 0.03,

3b. Weapon attachments

Add to Config.WeaponAttachments:

    ['WEAPON_APCVVR'] = {
        extendedmag1 = { component = 'COMPONENT_APCVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_APCVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_APCVVR_MAG4', item = 'extendedmag3' },
        grip = { component = 'COMPONENT_APCVVR_GRIP', item = 'grip' },
        laser = { component = 'COMPONENT_APCVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_APCVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_APCVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_APCVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_APCVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_AR15CVVR'] = {
        extendedmag1 = { component = 'COMPONENT_AR15CVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_AR15CVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_AR15CVVR_MAG4', item = 'extendedmag3' },
        grip = { component = 'COMPONENT_AR15CVVR_GRIP', item = 'grip' },
        laser = { component = 'COMPONENT_AR15CVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_AR15CVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_AR15CVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_AR15CVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_AR15CVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_AR15TVVR'] = {
        extendedmag1 = { component = 'COMPONENT_AR15TVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_AR15TVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_AR15TVVR_MAG4', item = 'extendedmag3' },
        grip = { component = 'COMPONENT_AR15TVVR_GRIP', item = 'grip' },
        laser = { component = 'COMPONENT_AR15TVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_AR15TVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_AR15TVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_AR15TVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_AR15TVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_ARP9VVR'] = {
        extendedmag1 = { component = 'COMPONENT_ARP9VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_ARP9VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_ARP9VVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_ARP9VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_ARP9VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_ARP9VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_ARP9VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_ARP9VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_ARPVVR'] = {
        extendedmag1 = { component = 'COMPONENT_ARPVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_ARPVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_ARPVVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_ARPVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_ARPVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_ARPVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_ARPVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_ARPVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_BRUENVVR'] = {
        laser = { component = 'COMPONENT_BRUENVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_BRUENVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_BRUENVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_BRUENVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_BRUENVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_DEAGLEVVR'] = {
        extendedmag1 = { component = 'COMPONENT_DEAGLEVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_DEAGLEVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_DEAGLEVVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_DEAGLEVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_DEAGLEVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_DEAGLEVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_DEAGLEVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_DEAGLEVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_DRACOVVR'] = {
        extendedmag1 = { component = 'COMPONENT_DRACOVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_DRACOVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_DRACOVVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_DRACOVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_DRACOVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_DRACOVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_DRACOVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_DRACOVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_G17SVVR'] = {
        extendedmag1 = { component = 'COMPONENT_G17SVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_G17SVVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_G17SVVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_G17SVVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_G17SVVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_G17SVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_G17SVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_G17SVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_G17VVR'] = {
        extendedmag1 = { component = 'COMPONENT_G17VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_G17VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_G17VVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_G17VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_G17VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_G17VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_G17VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_G17VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_G40VVR'] = {
        extendedmag1 = { component = 'COMPONENT_G40VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_G40VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_G40VVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_G40VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_G40VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_G40VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_G40VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_G40VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_G45VVR'] = {
        extendedmag1 = { component = 'COMPONENT_G45VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_G45VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_G45VVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_G45VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_G45VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_G45VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_G45VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_G45VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_MP7VVR'] = {
        extendedmag1 = { component = 'COMPONENT_MP7VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_MP7VVR_MAG3', item = 'extendedmag2' },
        laser = { component = 'COMPONENT_MP7VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_MP7VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_MP7VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_MP7VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_MP7VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_SPAS12VVR'] = {
        laser = { component = 'COMPONENT_SPAS12VVR_LASER', item = 'laser' },
        suppressor = { component = 'COMPONENT_SPAS12VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_SPAS12VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_SPAS12VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_THOMPSONVVR'] = {
        extendedmag1 = { component = 'COMPONENT_THOMPSONVVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_THOMPSONVVR_MAG3', item = 'extendedmag2' },
        laser = { component = 'COMPONENT_THOMPSONVVR_LASER', item = 'laser' },
        suppressor = { component = 'COMPONENT_THOMPSONVVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_THOMPSONVVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_THOMPSONVVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_SM17VVR'] = {
        extendedmag1 = { component = 'COMPONENT_SM17VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_SM17VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_SM17VVR_MAG4', item = 'extendedmag3' },
        laser = { component = 'COMPONENT_SM17VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_SM17VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_SM17VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_SM17VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_SM17VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_M45VVR'] = {
        extendedmag1 = { component = 'COMPONENT_M45VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_M45VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_M45VVR_MAG4', item = 'extendedmag3' },
        scope = { component = 'COMPONENT_M45VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_M45VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_M45VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_M45VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_FN5VVR'] = {
        extendedmag1 = { component = 'COMPONENT_FN5VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_FN5VVR_MAG3', item = 'extendedmag2' },
        extendedmag3 = { component = 'COMPONENT_FN5VVR_MAG4', item = 'extendedmag3' },
        scope = { component = 'COMPONENT_FN5VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_FN5VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_FN5VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_FN5VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_P90VVR'] = {
        laser = { component = 'COMPONENT_P90VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_P90VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_P90VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_P90VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_P90VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_AK102VVR'] = {
        extendedmag1 = { component = 'COMPONENT_AK102VVR_MAG2', item = 'extendedmag1' },
        extendedmag2 = { component = 'COMPONENT_AK102VVR_MAG3', item = 'extendedmag2' },
        laser = { component = 'COMPONENT_AK102VVR_LASER', item = 'laser' },
        scope = { component = 'COMPONENT_AK102VVR_SCOPE', item = 'scope' },
        suppressor = { component = 'COMPONENT_AK102VVR_SUPP', item = 'suppressor' },
        goldcamo = { component = 'COMPONENT_AK102VVR_GOLD', item = 'goldcamo' },
        diamondcamo = { component = 'COMPONENT_AK102VVR_DIAMOND', item = 'diamondcamo' },
    },

    ['WEAPON_BOWIEVVR'] = {
        goldcamo = { component = 'COMPONENT_BOWIEVVR_GOLD', item = 'goldcamo' },
    },

    ['WEAPON_BUTTERFLYVVR'] = {
        goldcamo = { component = 'COMPONENT_BUTTERFLYVVR_GOLD', item = 'goldcamo' },
    },

    ['WEAPON_DRAGONKATANAVVR'] = {
        goldcamo = { component = 'COMPONENT_DRAGONKATANAVVR_GOLD', item = 'goldcamo' },
    },

    ['WEAPON_KARAMBITVVR'] = {
        goldcamo = { component = 'COMPONENT_KARAMBITVVR_GOLD', item = 'goldcamo' },
    },

    ['WEAPON_TACTICALAXEVVR'] = {
        goldcamo = { component = 'COMPONENT_TACTICALAXEVVR_GOLD', item = 'goldcamo' },
    },

---

Step 4 - Images

Copy all PNG files from the INSTALL_ME/images/ folder to:

qs-inventory/html/images/

Also make sure Config.Images in the ars_vvsguns_v2 config points to the correct path:

Config.Images = 'nui://qs-inventory/html/images/'

---

Troubleshooting

• Weapons not showing: Make sure items are in qs-inventory/shared/items.lua AND weapon definitions are in qs-inventory/shared/weapon_list.lua.
• Attachments not equipping: Verify Config.WeaponAttachments entries match component names exactly (uppercase).
• Durability draining too fast: Adjust values in Config.DurabilityMultiplier (lower = slower).
• Images not loading: Confirm PNG filenames match the image field in items (case-sensitive on Linux).

---

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.