AK47 Inventory Installation

This guide covers adding all weapons and components to ak47_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

ak47_inventory installed and running
The weapon asset pack (VVSGUNV2) installed

Step 1 - Shared Components

Merge the weapon component definitions into your ak47 shared components file.

The component data includes mappings for:

Extended magazines (extendedmag1, extendedmag2, extendedmag3)
Scope, suppressor, laser, grip
Gold camo, diamond camo

Note: The exact file path depends on your ak47_inventory version. Check your ak47_inventory documentation for where shared components are defined.

Each weapon has its own set of component hashes following the pattern:

COMPONENT_{WEAPONNAME}_MAG2 through MAG4 for magazines
COMPONENT_{WEAPONNAME}_SCOPE, _SUPP, _LASER, _GRIP for attachments
COMPONENT_{WEAPONNAME}_GOLD, _DIAMOND for camos

Refer to the ox_inventory or qs-inventory installation files for the complete component hash mappings if needed.

Step 2 - Weapons

Open ak47_inventory/shared/items.lua and add the following weapon entries:

    ['WEAPON_APCVVR'] = {
        label = 'APC Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A compact automatic weapon effective in close quarters.',
    },
    ['WEAPON_AR15CVVR'] = {
        label = 'AR15C Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A reliable rifle platform built for mid to long range engagements.',
    },
    ['WEAPON_AR15TVVR'] = {
        label = 'AR15T Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A tactical rifle with strong all-around performance.',
    },
    ['WEAPON_ARP9VVR'] = {
        label = 'ARP9 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A lightweight pistol-caliber platform suited for fast engagements.',
    },
    ['WEAPON_ARPVVR'] = {
        label = 'ARP Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A modern rifle platform with balanced handling and firepower.',
    },
    ['WEAPON_BRUENVVR'] = {
        label = 'Bruen Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A heavy automatic weapon designed for sustained fire.',
    },
    ['WEAPON_DEAGLEVVR'] = {
        label = 'Deagle Custom',
        weight = 1100,
        stack = false,
        close = true,
        description = 'A high-caliber sidearm with powerful stopping force.',
    },
    ['WEAPON_DRACOVVR'] = {
        label = 'Draco Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A compact rifle variant with aggressive close-range performance.',
    },
    ['WEAPON_G17SVVR'] = {
        label = 'G17S Custom',
        weight = 1100,
        stack = false,
        close = true,
        description = 'A dependable sidearm configured for versatility.',
    },
    ['WEAPON_G17VVR'] = {
        label = 'G17 Custom',
        weight = 1100,
        stack = false,
        close = true,
        description = 'A standard-duty handgun known for balance and reliability.',
    },
    ['WEAPON_G40VVR'] = {
        label = 'G40 Custom',
        weight = 1100,
        stack = false,
        close = true,
        description = 'A full-size pistol offering strong accuracy and control.',
    },
    ['WEAPON_G45VVR'] = {
        label = 'G45 Custom',
        weight = 1100,
        stack = false,
        close = true,
        description = 'A modern sidearm built for fast response and dependable handling.',
    },
    ['WEAPON_MP7VVR'] = {
        label = 'MP7 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A compact personal defense weapon with a high fire rate.',
    },
    ['WEAPON_SPAS12VVR'] = {
        label = 'SPAS12 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A powerful shotgun built for devastating close-range impact.',
    },
    ['WEAPON_THOMPSONVVR'] = {
        label = 'Thompson Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A classic submachine gun with strong close-quarters performance.',
    },
    ['WEAPON_SM17VVR'] = {
        label = 'SM17 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A full-size pistol offering strong accuracy and control.',
    },
    ['WEAPON_M45VVR'] = {
        label = 'M45 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A full-size pistol offering strong accuracy and control.',
    },
    ['WEAPON_FN5VVR'] = {
        label = 'FN5 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A full-size pistol offering strong accuracy and control.',
    },
    ['WEAPON_P90VVR'] = {
        label = 'P90 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A compact personal defense weapon with a high fire rate.',
    },
    ['WEAPON_AK102VVR'] = {
        label = 'AK102 Custom',
        weight = 1400,
        stack = false,
        close = true,
        description = 'A compact rifle variant with aggressive close-range performance.',
    },
    ['WEAPON_BOWIEVVR'] = {
        label = 'Bowie Knife Custom',
        weight = 1000,
        stack = false,
        close = true,
        description = 'A large combat knife built for heavy strikes.',
    },
    ['WEAPON_BUTTERFLYVVR'] = {
        label = 'Butterfly Knife Custom',
        weight = 1000,
        stack = false,
        close = true,
        description = 'A folding balisong knife for quick deployment.',
    },
    ['WEAPON_DRAGONKATANAVVR'] = {
        label = 'Katana Dragon Custom',
        weight = 1200,
        stack = false,
        close = true,
        description = 'A ceremonial katana with a dragon-forged blade.',
    },
    ['WEAPON_KARAMBITVVR'] = {
        label = 'Karambit Custom',
        weight = 900,
        stack = false,
        close = true,
        description = 'A curved tactical blade designed for close combat.',
    },
    ['WEAPON_TACTICALAXEVVR'] = {
        label = 'Tactical Axe Custom',
        weight = 1600,
        stack = false,
        close = true,
        description = 'A reinforced tactical axe for breaching and melee.',
    },

Step 3 - Items

Open ak47_inventory/shared/items.lua and add the following attachment and crafting entries:

['extendedmag1'] = {
    label = 'Extended Magazine I',
    weight = 100,
    stack = true,
    close = true,
    description = 'An extended magazine attachment.',
},

['extendedmag2'] = {
    label = 'Extended Magazine II',
    weight = 100,
    stack = true,
    close = true,
    description = 'An upgraded magazine attachment.',
},

['extendedmag3'] = {
    label = 'Extended Magazine III',
    weight = 100,
    stack = true,
    close = true,
    description = 'A high-capacity magazine attachment.',
},

['scope'] = {
    label = 'Scope',
    weight = 100,
    stack = true,
    close = true,
    description = 'A scope attachment.',
},

['suppressor'] = {
    label = 'Suppressor',
    weight = 100,
    stack = true,
    close = true,
    description = 'A suppressor attachment.',
},

['laser'] = {
    label = 'Laser',
    weight = 100,
    stack = true,
    close = true,
    description = 'A laser attachment.',
},

['grip'] = {
    label = 'Angled Foregrip',
    weight = 100,
    stack = true,
    close = true,
    description = 'A foregrip attachment.',
},

['goldcamo'] = {
    label = 'Gold Camo',
    weight = 100,
    stack = true,
    close = true,
    description = 'A gold weapon camo skin.',
},

['diamondcamo'] = {
    label = 'Diamond Camo',
    weight = 100,
    stack = true,
    close = true,
    description = 'A diamond weapon camo skin.',
},

['partspistol'] = {
    label = 'Pistol Parts',
    weight = 100,
    stack = true,
    close = true,
    description = 'Parts used for crafting pistols.',
},

['partsrifle'] = {
    label = 'Rifle Parts',
    weight = 100,
    stack = true,
    close = true,
    description = 'Parts used for crafting rifles.',
},

['partsrifle2'] = {
    label = 'Advanced Rifle Parts',
    weight = 100,
    stack = true,
    close = true,
    description = 'Advanced rifle crafting parts.',
},

['partsshotgun'] = {
    label = 'Shotgun Parts',
    weight = 100,
    stack = true,
    close = true,
    description = 'Parts used for crafting shotguns.',
},

['partssmg'] = {
    label = 'SMG Parts',
    weight = 100,
    stack = true,
    close = true,
    description = 'Parts used for crafting SMGs.',
},

['switch'] = {
    label = 'Weapon Switch',
    weight = 100,
    stack = true,
    close = true,
    description = 'A weapon conversion switch.',
},

['weaponblack'] = {
    label = 'Weapon Black Finish',
    weight = 100,
    stack = true,
    close = true,
    description = 'A black weapon finish.',
},

['diamond'] = {
    label = 'Diamond',
    weight = 100,
    stack = true,
    close = true,
    description = 'A valuable diamond.',
},

['gold_bar'] = {
    label = 'Gold Bar',
    weight = 100,
    stack = true,
    close = true,
    description = 'A solid bar of gold.',
},

Step 3 - Ammo Plugin Config

Open your ak47_inventory ammo plugin config file and merge the following entries:

    [`WEAPON_APCVVR`] = {
        weapon = 'WEAPON_APCVVR',
        ammo = 'ammo_smg',
    },

    [`WEAPON_AR15CVVR`] = {
        weapon = 'WEAPON_AR15CVVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_AR15TVVR`] = {
        weapon = 'WEAPON_AR15TVVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_ARP9VVR`] = {
        weapon = 'WEAPON_ARP9VVR',
        ammo = 'ammo_smg',
    },

    [`WEAPON_ARPVVR`] = {
        weapon = 'WEAPON_ARPVVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_AK102VVR`] = {
        weapon = 'WEAPON_AK102VVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_BRUENVVR`] = {
        weapon = 'WEAPON_BRUENVVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_DEAGLEVVR`] = {
        weapon = 'WEAPON_DEAGLEVVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_DRACOVVR`] = {
        weapon = 'WEAPON_DRACOVVR',
        ammo = 'ammo_rifle',
    },

    [`WEAPON_G17SVVR`] = {
        weapon = 'WEAPON_G17SVVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_G17VVR`] = {
        weapon = 'WEAPON_G17VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_G40VVR`] = {
        weapon = 'WEAPON_G40VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_G45VVR`] = {
        weapon = 'WEAPON_G45VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_SM17VVR`] = {
        weapon = 'WEAPON_SM17VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_M45VVR`] = {
        weapon = 'WEAPON_M45VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_FN5VVR`] = {
        weapon = 'WEAPON_FN5VVR',
        ammo = 'ammo_pistol',
    },

    [`WEAPON_MP7VVR`] = {
        weapon = 'WEAPON_MP7VVR',
        ammo = 'ammo_smg',
    },

    [`WEAPON_P90VVR`] = {
        weapon = 'WEAPON_P90VVR',
        ammo = 'ammo_smg',
    },

    [`WEAPON_SPAS12VVR`] = {
        weapon = 'WEAPON_SPAS12VVR',
        ammo = 'ammo_shotgun',
    },

    [`WEAPON_THOMPSONVVR`] = {
        weapon = 'WEAPON_THOMPSONVVR',
        ammo = 'ammo_smg',
    },

    [`WEAPON_BOWIEVVR`] = {
        weapon = 'WEAPON_BOWIEVVR',
        ammo = nil,
    },

    [`WEAPON_BUTTERFLYVVR`] = {
        weapon = 'WEAPON_BUTTERFLYVVR',
        ammo = nil,
    },

    [`WEAPON_DRAGONKATANAVVR`] = {
        weapon = 'WEAPON_DRAGONKATANAVVR',
        ammo = nil,
    },

    [`WEAPON_KARAMBITVVR`] = {
        weapon = 'WEAPON_KARAMBITVVR',
        ammo = nil,
    },

    [`WEAPON_TACTICALAXEVVR`] = {
        weapon = 'WEAPON_TACTICALAXEVVR',
        ammo = nil,
    },

Step 4 - Rob Plugin Config

Open your ak47_inventory robbery plugin config file and merge the following entries:

    ['WEAPON_APCVVR'] = true,
    ['WEAPON_AR15CVVR'] = true,
    ['WEAPON_AR15TVVR'] = true,
    ['WEAPON_ARP9VVR'] = true,
    ['WEAPON_ARPVVR'] = true,
    ['WEAPON_AK102VVR'] = true,
    ['WEAPON_BRUENVVR'] = true,
    ['WEAPON_DEAGLEVVR'] = true,
    ['WEAPON_DRACOVVR'] = true,
    ['WEAPON_G17SVVR'] = true,
    ['WEAPON_G17VVR'] = true,
    ['WEAPON_G40VVR'] = true,
    ['WEAPON_G45VVR'] = true,
    ['WEAPON_SM17VVR'] = true,
    ['WEAPON_M45VVR'] = true,
    ['WEAPON_FN5VVR'] = true,
    ['WEAPON_MP7VVR'] = true,
    ['WEAPON_P90VVR'] = true,
    ['WEAPON_SPAS12VVR'] = true,
    ['WEAPON_THOMPSONVVR'] = true,

    -- Melee
    ['WEAPON_BOWIEVVR'] = true,
    ['WEAPON_BUTTERFLYVVR'] = true,
    ['WEAPON_DRAGONKATANAVVR'] = true,
    ['WEAPON_KARAMBITVVR'] = true,
    ['WEAPON_TACTICALAXEVVR'] = true,

Step 5 - Database Items (only if needed)

Some ak47_inventory setups require items in the database items table. If yours does, use the SQL from the ESX installation guide:

See the ESX Installation Step 1c for the items SQL. The same SQL works for ak47_inventory.

Step 6 - Images

Copy all PNG files from the INSTALL_ME/images/ folder to your ak47_inventory image directory. Check your ak47_inventory config for the exact image path.

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

Component Types Reference

Component	Type
extendedmag1 / 2 / 3	magazine
scope	scope
suppressor	muzzle
laser	flashlight
grip	grip
goldcamo	skin
diamondcamo	skin

Troubleshooting

Ammo not loading: Verify the ammo type in the ammo plugin config matches what ak47_inventory expects (e.g., ammo_pistol, ammo_rifle, ammo_smg, ammo_shotgun).
Weapons not droppable/robable: Check that the rob plugin config has entries for all weapons.
Components not applying: Ensure component hashes in your shared components file match the weapon model names exactly.
Images not loading: Confirm PNG filenames are correct and the image path in config is set properly.

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.