AK47 Inventory Installation

This guide covers registering all VVS weapons and crafting items in ak47_inventory.

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 - Weapons

Open ak47_inventory/shared/weapons.lua and add the following entries to Config.Shared.Weapons:

    ['WEAPON_APCVVR'] = {
        label = 'APC Custom',
        weight = 1400,
        durability = 0.05,
        ammoname = 'ammo-9',
    },
    ['WEAPON_AR15CVVR'] = {
        label = 'AR15C Custom',
        weight = 3100,
        durability = 0.03,
        ammoname = 'ammo-rifle',
    },
    ['WEAPON_AR15TVVR'] = {
        label = 'AR15T Custom',
        weight = 3100,
        durability = 0.03,
        ammoname = 'ammo-rifle',
    },
    ['WEAPON_ARP9VVR'] = {
        label = 'ARP9 Custom',
        weight = 2300,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_ARPVVR'] = {
        label = 'ARP Custom',
        weight = 3100,
        durability = 0.03,
        ammoname = 'ammo-rifle',
    },
    ['WEAPON_BRUENVVR'] = {
        label = 'Bruen Custom',
        weight = 7500,
        durability = 0.02,
        ammoname = 'ammo-rifle',
    },
    ['WEAPON_DEAGLEVVR'] = {
        label = 'Deagle Custom',
        weight = 2000,
        durability = 0.1,
        ammoname = 'ammo-50',
    },
    ['WEAPON_DRACOVVR'] = {
        label = 'Draco Custom',
        weight = 3600,
        durability = 0.03,
        ammoname = 'ammo-rifle2',
    },
    ['WEAPON_G17SVVR'] = {
        label = 'G17S Custom',
        weight = 1000,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_G17VVR'] = {
        label = 'G17 Custom',
        weight = 1130,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_G40VVR'] = {
        label = 'G40 Custom',
        weight = 1130,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_G45VVR'] = {
        label = 'G45 Custom',
        weight = 1130,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_MP7VVR'] = {
        label = 'MP7 Custom',
        weight = 2300,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_SPAS12VVR'] = {
        label = 'SPAS12 Custom',
        weight = 4400,
        durability = 0.05,
        ammoname = 'ammo-shotgun',
    },
    ['WEAPON_THOMPSONVVR'] = {
        label = 'Thompson Custom',
        weight = 4900,
        durability = 0.04,
        ammoname = 'ammo-45',
    },
    ['WEAPON_SM17VVR'] = {
        label = 'SM17 Custom',
        weight = 1400,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_M45VVR'] = {
        label = 'M45 Custom',
        weight = 1400,
        durability = 0.1,
        ammoname = 'ammo-45',
    },
    ['WEAPON_FN5VVR'] = {
        label = 'FN5 Custom',
        weight = 1400,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_P90VVR'] = {
        label = 'P90 Custom',
        weight = 2300,
        durability = 0.1,
        ammoname = 'ammo-9',
    },
    ['WEAPON_AK102VVR'] = {
        label = 'AK102 Custom',
        weight = 3600,
        durability = 0.03,
        ammoname = 'ammo-rifle2',
    },
    ['WEAPON_BOWIEVVR'] = {
        label = 'Bowie Knife Custom',
        weight = 1000,
        durability = 0.1,
    },
    ['WEAPON_BUTTERFLYVVR'] = {
        label = 'Butterfly Knife Custom',
        weight = 800,
        durability = 0.1,
    },
    ['WEAPON_DRAGONKATANAVVR'] = {
        label = 'Katana Dragon Custom',
        weight = 1200,
        durability = 0.1,
    },
    ['WEAPON_KARAMBITVVR'] = {
        label = 'Karambit Custom',
        weight = 800,
        durability = 0.1,
    },
    ['WEAPON_TACTICALAXEVVR'] = {
        label = 'Tactical Axe Custom',
        weight = 2500,
        durability = 0.1,
    },

Step 2 - Items

Open ak47_inventory/shared/items.lua and add the following entries to Config.Shared.Items:

    ['partspistol'] = {
        name = 'partspistol',
        label = 'Pistol Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['partsrifle'] = {
        name = 'partsrifle',
        label = 'Rifle Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['partsrifle2'] = {
        name = 'partsrifle2',
        label = 'Advanced Rifle Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['partsshotgun'] = {
        name = 'partsshotgun',
        label = 'Shotgun Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['partssmg'] = {
        name = 'partssmg',
        label = 'SMG Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['partsmelee'] = {
        name = 'partsmelee',
        label = 'Melee Parts',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['switch'] = {
        name = 'switch',
        label = 'Weapon Switch',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['weaponblack'] = {
        name = 'weaponblack',
        label = 'Weapon Black Finish',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['gunpowder'] = {
        name = 'gunpowder',
        label = 'Gunpowder',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['emptyshell'] = {
        name = 'emptyshell',
        label = 'Empty Shell',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['gold_bar'] = {
        name = 'gold_bar',
        label = 'Gold Bar',
        weight = 100,
        type = 'item',
        close = true,
    },
    ['diamond'] = {
        name = 'diamond',
        label = 'Diamond',
        weight = 100,
        type = 'item',
        close = true,
    },

Step 3 - Components

Open ak47_inventory/shared/components.lua and add the following entries to Config.Shared.Components for VVS weapon component hash mappings:

    ['extendedmag1'] = {
        label = 'Extended Magazine I',
        weight = 100,
        type = 'magazine',
        component = {
            `COMPONENT_APCVVR_MAG2`,
            `COMPONENT_G17VVR_MAG2`,
            `COMPONENT_G17SVVR_MAG2`,
            `COMPONENT_ARPVVR_MAG2`,
            `COMPONENT_AR15TVVR_MAG2`,
            `COMPONENT_AR15CVVR_MAG2`,
            `COMPONENT_G45VVR_MAG2`,
            `COMPONENT_G40VVR_MAG2`,
            `COMPONENT_DRACOVVR_MAG2`,
            `COMPONENT_DEAGLEVVR_MAG2`,
            `COMPONENT_ARP9VVR_MAG2`,
            `COMPONENT_MP7VVR_MAG2`,
            `COMPONENT_THOMPSONVVR_MAG2`,
            `COMPONENT_SM17VVR_MAG2`,
            `COMPONENT_M45VVR_MAG2`,
            `COMPONENT_FN5VVR_MAG2`,
            `COMPONENT_AK102VVR_MAG2`,
        },
    },
    ['extendedmag2'] = {
        label = 'Extended Magazine II',
        weight = 100,
        type = 'magazine',
        component = {
            `COMPONENT_APCVVR_MAG3`,
            `COMPONENT_G17VVR_MAG3`,
            `COMPONENT_G17SVVR_MAG3`,
            `COMPONENT_ARPVVR_MAG3`,
            `COMPONENT_AR15TVVR_MAG3`,
            `COMPONENT_AR15CVVR_MAG3`,
            `COMPONENT_G45VVR_MAG3`,
            `COMPONENT_G40VVR_MAG3`,
            `COMPONENT_DRACOVVR_MAG3`,
            `COMPONENT_DEAGLEVVR_MAG3`,
            `COMPONENT_ARP9VVR_MAG3`,
            `COMPONENT_MP7VVR_MAG3`,
            `COMPONENT_THOMPSONVVR_MAG3`,
            `COMPONENT_SM17VVR_MAG3`,
            `COMPONENT_M45VVR_MAG3`,
            `COMPONENT_FN5VVR_MAG3`,
            `COMPONENT_AK102VVR_MAG3`,
        },
    },
    ['extendedmag3'] = {
        label = 'Extended Magazine III',
        weight = 100,
        type = 'magazine',
        component = {
            `COMPONENT_APCVVR_MAG4`,
            `COMPONENT_G17VVR_MAG4`,
            `COMPONENT_G17SVVR_MAG4`,
            `COMPONENT_ARPVVR_MAG4`,
            `COMPONENT_AR15TVVR_MAG4`,
            `COMPONENT_AR15CVVR_MAG4`,
            `COMPONENT_G45VVR_MAG4`,
            `COMPONENT_G40VVR_MAG4`,
            `COMPONENT_DRACOVVR_MAG4`,
            `COMPONENT_DEAGLEVVR_MAG4`,
            `COMPONENT_ARP9VVR_MAG4`,
            `COMPONENT_SM17VVR_MAG4`,
            `COMPONENT_M45VVR_MAG4`,
            `COMPONENT_FN5VVR_MAG4`,
        },
    },
    ['grip'] = {
        label = 'Angled Foregrip',
        weight = 280,
        type = 'grip',
        component = {
            `COMPONENT_AR15CVVR_GRIP`,
            `COMPONENT_AR15TVVR_GRIP`,
            `COMPONENT_APCVVR_GRIP`,
        },
    },
    ['laser'] = {
        label = 'Laser',
        weight = 120,
        type = 'flashlight',
        component = {
            `COMPONENT_APCVVR_LASER`,
            `COMPONENT_G17VVR_LASER`,
            `COMPONENT_G17SVVR_LASER`,
            `COMPONENT_AR15TVVR_LASER`,
            `COMPONENT_AR15CVVR_LASER`,
            `COMPONENT_ARPVVR_LASER`,
            `COMPONENT_G45VVR_LASER`,
            `COMPONENT_G40VVR_LASER`,
            `COMPONENT_DRACOVVR_LASER`,
            `COMPONENT_DEAGLEVVR_LASER`,
            `COMPONENT_ARP9VVR_LASER`,
            `COMPONENT_MP7VVR_LASER`,
            `COMPONENT_BRUENVVR_LASER`,
            `COMPONENT_SPAS12VVR_LASER`,
            `COMPONENT_SM17VVR_LASER`,
            `COMPONENT_M45VVR_LASER`,
            `COMPONENT_FN5VVR_LASER`,
            `COMPONENT_P90VVR_LASER`,
            `COMPONENT_AK102VVR_LASER`,
        },
    },
    ['scope'] = {
        label = 'Scope',
        weight = 280,
        type = 'sight',
        component = {
            `COMPONENT_APCVVR_SCOPE`,
            `COMPONENT_G17VVR_SCOPE`,
            `COMPONENT_G17SVVR_SCOPE`,
            `COMPONENT_AR15TVVR_SCOPE`,
            `COMPONENT_AR15CVVR_SCOPE`,
            `COMPONENT_ARPVVR_SCOPE`,
            `COMPONENT_G45VVR_SCOPE`,
            `COMPONENT_G40VVR_SCOPE`,
            `COMPONENT_DRACOVVR_SCOPE`,
            `COMPONENT_DEAGLEVVR_SCOPE`,
            `COMPONENT_ARP9VVR_SCOPE`,
            `COMPONENT_MP7VVR_SCOPE`,
            `COMPONENT_BRUENVVR_SCOPE`,
            `COMPONENT_SM17VVR_SCOPE`,
            `COMPONENT_M45VVR_SCOPE`,
            `COMPONENT_FN5VVR_SCOPE`,
            `COMPONENT_P90VVR_SCOPE`,
            `COMPONENT_AK102VVR_SCOPE`,
        },
    },
    ['suppressor'] = {
        label = 'Suppressor',
        weight = 280,
        type = 'muzzle',
        component = {
            `COMPONENT_APCVVR_SUPP`,
            `COMPONENT_G17VVR_SUPP`,
            `COMPONENT_G17SVVR_SUPP`,
            `COMPONENT_AR15TVVR_SUPP`,
            `COMPONENT_AR15CVVR_SUPP`,
            `COMPONENT_ARPVVR_SUPP`,
            `COMPONENT_G45VVR_SUPP`,
            `COMPONENT_G40VVR_SUPP`,
            `COMPONENT_DRACOVVR_SUPP`,
            `COMPONENT_DEAGLEVVR_SUPP`,
            `COMPONENT_ARP9VVR_SUPP`,
            `COMPONENT_MP7VVR_SUPP`,
            `COMPONENT_THOMPSONVVR_SUPP`,
            `COMPONENT_BRUENVVR_SUPP`,
            `COMPONENT_SPAS12VVR_SUPP`,
            `COMPONENT_SM17VVR_SUPP`,
            `COMPONENT_M45VVR_SUPP`,
            `COMPONENT_FN5VVR_SUPP`,
            `COMPONENT_P90VVR_SUPP`,
            `COMPONENT_AK102VVR_SUPP`,
        },
    },
    ['goldcamo'] = {
        label = 'Gold Camo',
        weight = 50,
        type = 'skin',
        component = {
            `COMPONENT_APCVVR_GOLD`,
            `COMPONENT_G17VVR_GOLD`,
            `COMPONENT_G17SVVR_GOLD`,
            `COMPONENT_ARPVVR_GOLD`,
            `COMPONENT_AR15TVVR_GOLD`,
            `COMPONENT_AR15CVVR_GOLD`,
            `COMPONENT_G45VVR_GOLD`,
            `COMPONENT_G40VVR_GOLD`,
            `COMPONENT_DRACOVVR_GOLD`,
            `COMPONENT_DEAGLEVVR_GOLD`,
            `COMPONENT_ARP9VVR_GOLD`,
            `COMPONENT_MP7VVR_GOLD`,
            `COMPONENT_THOMPSONVVR_GOLD`,
            `COMPONENT_BRUENVVR_GOLD`,
            `COMPONENT_SPAS12VVR_GOLD`,
            `COMPONENT_SM17VVR_GOLD`,
            `COMPONENT_M45VVR_GOLD`,
            `COMPONENT_FN5VVR_GOLD`,
            `COMPONENT_P90VVR_GOLD`,
            `COMPONENT_AK102VVR_GOLD`,
            `COMPONENT_BOWIEVVR_GOLD`,
            `COMPONENT_BUTTERFLYVVR_GOLD`,
            `COMPONENT_DRAGONKATANAVVR_GOLD`,
            `COMPONENT_KARAMBITVVR_GOLD`,
            `COMPONENT_TACTICALAXEVVR_GOLD`,
        },
    },
    ['diamondcamo'] = {
        label = 'Diamond Camo',
        weight = 50,
        type = 'skin',
        component = {
            `COMPONENT_APCVVR_DIAMOND`,
            `COMPONENT_G17VVR_DIAMOND`,
            `COMPONENT_G17SVVR_DIAMOND`,
            `COMPONENT_ARPVVR_DIAMOND`,
            `COMPONENT_AR15TVVR_DIAMOND`,
            `COMPONENT_AR15CVVR_DIAMOND`,
            `COMPONENT_G45VVR_DIAMOND`,
            `COMPONENT_G40VVR_DIAMOND`,
            `COMPONENT_DRACOVVR_DIAMOND`,
            `COMPONENT_DEAGLEVVR_DIAMOND`,
            `COMPONENT_ARP9VVR_DIAMOND`,
            `COMPONENT_MP7VVR_DIAMOND`,
            `COMPONENT_THOMPSONVVR_DIAMOND`,
            `COMPONENT_BRUENVVR_DIAMOND`,
            `COMPONENT_SPAS12VVR_DIAMOND`,
            `COMPONENT_SM17VVR_DIAMOND`,
            `COMPONENT_M45VVR_DIAMOND`,
            `COMPONENT_FN5VVR_DIAMOND`,
            `COMPONENT_P90VVR_DIAMOND`,
            `COMPONENT_AK102VVR_DIAMOND`,
        },
    },

Step 4 - Images

Copy all PNG files from 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 ars_vvsguns_v2/config.lua points to the correct path.

Troubleshooting

Weapons not showing in inventory: Make sure entries are in Config.Shared.Weapons in weapons.lua, not in items.lua.
Items missing: Verify the items are in Config.Shared.Items in items.lua with the correct name field matching the key.
Ammo not working: Confirm the ammoname in each weapon entry matches an ammo type in Config.Shared.Ammo in ammo.lua.
Images not loading: Confirm PNG filenames match item/weapon names exactly and Config.Images path is set correctly.

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.