> For the complete documentation index, see [llms.txt](https://polars-armoury.gitbook.io/polars-armoury-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polars-armoury.gitbook.io/polars-armoury-docs/zombie-melee-pack/qs-esx-inventory-guide.md).

# QS/ESX Inventory Guide

### <mark style="color:red;">**STEP 1 - Install the weapon file**</mark>

* Download the weapon file from your <mark style="color:green;">**CFX KEY**</mark>
* Then place it into your server folder (e.g resources) or  your preferred directory
* Make sure to <mark style="color:green;">**ENSURE**</mark> the weapon pack and <mark style="color:green;">**RESTART**</mark> your server

### <mark style="color:red;">**STEP 2 - Place the images**</mark>&#x20;

Place the images found in the "images" folder  in **\[/**<mark style="color:green;">**qs-inventory/html/images**</mark>**]**

### <mark style="color:red;">**STEP 3 - Add Items**</mark>

<mark style="color:$info;">**Copy and paste this code in**</mark> <mark style="color:green;">**\[/qs-inventory/shared/items.lua]**</mark>

```lua
    -- Polars Armoury Zombie V1 Weapons

    ['weapon_bladedbat'] = {
        ['name'] = 'weapon_bladedbat',
        ['label'] = 'bladedbat',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_bladedbat.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_bladehatchet'] = {
        ['name'] = 'weapon_bladehatchet',
        ['label'] = 'bladehatchet',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_bladehatchet.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_brakediscaxe'] = {
        ['name'] = 'weapon_brakediscaxe',
        ['label'] = 'brakediscaxe',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_brakediscaxe.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_clawaxe'] = {
        ['name'] = 'weapon_clawaxe',
        ['label'] = 'clawaxe',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_clawaxe.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_crossbow'] = {
        ['name'] = 'weapon_crossbow',
        ['label'] = 'crossbow',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_ARROW',
        ['image'] = 'weapon_crossbow.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_customaxe'] = {
        ['name'] = 'weapon_customaxe',
        ['label'] = 'customaxe',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_customaxe.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_enhancedbat'] = {
        ['name'] = 'weapon_enhancedbat',
        ['label'] = 'enhancedbat',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_enhancedbat.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_givewaysign'] = {
        ['name'] = 'weapon_givewaysign',
        ['label'] = 'givewaysign',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_givewaysign.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_grinderbat'] = {
        ['name'] = 'weapon_grinderbat',
        ['label'] = 'grinderbat',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_grinderbat.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_hunterhatchet'] = {
        ['name'] = 'weapon_hunterhatchet',
        ['label'] = 'hunterhatchet',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_hunterhatchet.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_huntershotgun'] = {
        ['name'] = 'weapon_huntershotgun',
        ['label'] = 'huntershotgun',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_SHOTGUN',
        ['image'] = 'weapon_huntershotgun.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_lucille'] = {
        ['name'] = 'weapon_lucille',
        ['label'] = 'lucille',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_lucille.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_machette'] = {
        ['name'] = 'weapon_machette',
        ['label'] = 'machette',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_machette.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_python'] = {
        ['name'] = 'weapon_python',
        ['label'] = 'python',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = 'AMMO_PISTOL',
        ['image'] = 'weapon_python.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_sickle'] = {
        ['name'] = 'weapon_sickle',
        ['label'] = 'sickle',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_sickle.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_smallaxe'] = {
        ['name'] = 'weapon_smallaxe',
        ['label'] = 'smallaxe',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_smallaxe.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_spikeysickle'] = {
        ['name'] = 'weapon_spikeysickle',
        ['label'] = 'spikeysickle',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_spikeysickle.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_wrenchknife'] = {
        ['name'] = 'weapon_wrenchknife',
        ['label'] = 'wrenchknife',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_wrenchknife.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_zhalberd'] = {
        ['name'] = 'weapon_zhalberd',
        ['label'] = 'zhalberd',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_zhalberd.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_zhammer'] = {
        ['name'] = 'weapon_zhammer',
        ['label'] = 'zhammer',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_zhammer.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_zkatana'] = {
        ['name'] = 'weapon_zkatana',
        ['label'] = 'zkatana',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_zkatana.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_zombiefireaxe'] = {
        ['name'] = 'weapon_zombiefireaxe',
        ['label'] = 'zombiefireaxe',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_zombiefireaxe.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },

    ['weapon_zombiehatchet'] = {
        ['name'] = 'weapon_zombiehatchet',
        ['label'] = 'zombiehatchet',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_zombiehatchet.png',
        ['unique'] = true,
        ['useable'] = false,
        ['description'] = 'It does not contain a description.'
    },
    ['arrow_ammo'] = {
        ['name'] = 'arrow_ammo',
        ['label'] = 'arrow ammo',
        ['weight'] = 200,
        ['type'] = 'item',
        ['image'] = 'arrow_ammo.png',
        ['unique'] = false,
        ['useable'] = true,
        ['shouldClose'] = true,
        ['combinable'] = nil,
        ['object'] = 'prop_ld_ammo_pack_01',
        ['description'] = 'Ammo for crossbow'
    },

```

### <mark style="color:red;">**STEP 4 - Config weapons**</mark>

<mark style="color:$info;">**Copy and paste this code in**</mark> <mark style="color:green;">**\[\qs-inventory\shared\weapons.lua]**</mark>**&#x20;**<mark style="color:$info;">**where the configuration weapons is**</mark>

```lua
    -- Polars Armoury Zombie V1 Weapons

    [`weapon_bladedbat`] = {
        name = 'weapon_bladedbat',
        label = 'Bladed Bat',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_bladehatchet`] = {
        name = 'weapon_bladehatchet',
        label = 'Blade Hatchet',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_brakediscaxe`] = {
        name = 'weapon_brakediscaxe',
        label = 'Brake Disc Axe',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },

    [`weapon_clawaxe`] = {
        name = 'weapon_clawaxe',
        label = 'Claw Axe',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_crossbow`] = {
        name = 'weapon_crossbow',
        label = 'Crossbow',
        weapontype = 'Projectile',
        ammotype = 'AMMO_ARROW',
        damagereason = 'Pierced'
    },

    [`weapon_customaxe`] = {
        name = 'weapon_customaxe',
        label = 'Custom Axe',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },

    [`weapon_enhancedbat`] = {
        name = 'weapon_enhancedbat',
        label = 'Enhanced Bat',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_givewaysign`] = {
        name = 'weapon_givewaysign',
        label = 'Give Way Sign',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_grinderbat`] = {
        name = 'weapon_grinderbat',
        label = 'Grinder Bat',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_hunterhatchet`] = {
        name = 'weapon_hunterhatchet',
        label = 'Hunter Hatchet',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },

    [`weapon_huntershotgun`] = {
        name = 'weapon_huntershotgun',
        label = 'Hunter Shotgun',
        weapontype = 'Shotgun',
        ammotype = 'AMMO_SHOTGUN',
        damagereason = 'Shot'
    },

    [`weapon_lucille`] = {
        name = 'weapon_lucille',
        label = 'Lucille',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_machette`] = {
        name = 'weapon_machette',
        label = 'Machette',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_python`] = {
        name = 'weapon_python',
        label = 'Python',
        weapontype = 'Pistol',
        ammotype = 'AMMO_PISTOL',
        damagereason = 'Shot'
    },

    [`weapon_sickle`] = {
        name = 'weapon_sickle',
        label = 'Sickle',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_smallaxe`] = {
        name = 'weapon_smallaxe',
        label = 'Small Axe',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },

    [`weapon_spikeysickle`] = {
        name = 'weapon_spikeysickle',
        label = 'Spikey Sickle',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_wrenchknife`] = {
        name = 'weapon_wrenchknife',
        label = 'Wrench Knife',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Stabbed'
    },

    [`weapon_zhalberd`] = {
        name = 'weapon_zhalberd',
        label = 'Zhalberd',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_zhammer`] = {
        name = 'weapon_zhammer',
        label = 'Zhammer',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

    [`weapon_zkatana`] = {
        name = 'weapon_zkatana',
        label = 'Zkatana',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Slashed'
    },

    [`weapon_zombiefireaxe`] = {
        name = 'weapon_zombiefireaxe',
        label = 'Zombie Fire Axe',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },

    [`weapon_zombiehatchet`] = {
        name = 'weapon_zombiehatchet',
        label = 'Zombie Hatchet',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Chopped'
    },
```

### <mark style="color:red;">**STEP 5 - Config durability**</mark>

<mark style="color:$info;">**Copy and paste this code in**</mark> <mark style="color:green;">**\[\qs-inventory\config\weapons.lua]**</mark>**&#x20;**<mark style="color:$info;">**where the durability configuration is**</mark>

```lua
    -- Polars Armoury Zombie V1 Weapons

    weapon_bladedbat = 0.10,
    weapon_bladehatchet = 0.10,
    weapon_brakediscaxe = 0.10,
    weapon_clawaxe = 0.10,
    weapon_crossbow = 0.10,
    weapon_customaxe = 0.10,
    weapon_enhancedbat = 0.10,
    weapon_givewaysign = 0.10,
    weapon_grinderbat = 0.10,
    weapon_hunterhatchet = 0.10,
    weapon_huntershotgun = 0.10,
    weapon_lucille = 0.10,
    weapon_machette = 0.10,
    weapon_python = 0.10,
    weapon_sickle = 0.10,
    weapon_smallaxe = 0.10,
    weapon_spikeysickle = 0.10,
    weapon_wrenchknife = 0.10,
    weapon_zhalberd = 0.10,
    weapon_zhammer = 0.10,
    weapon_zkatana = 0.10,
    weapon_zombiefireaxe = 0.10,
    weapon_zombiehatchet = 0.10,

```

### <mark style="color:red;">**STEP 6 - Ammo config**</mark>

<mark style="color:$info;">**Copy and paste this code in**</mark> <mark style="color:green;">**\[\qs-inventory\config\weapons.lua]**</mark>**&#x20;**<mark style="color:$info;">**where the ammo configuration is**</mark>

```lua
    {
        item = 'arrow_ammo',
        type = 'AMMO_ARROW'
    },
```