> 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/christmas-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 Christmas V1 Weapons

    ['weapon_antler'] = {
        ['name'] = 'weapon_antler',
        ['label'] = 'Antler',
        ['weight'] = 200,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_antler.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A sturdy antler, ideal for creative close-range combat.'
    },
    ['weapon_candycane'] = {
        ['name'] = 'weapon_candycane',
        ['label'] = 'Candy Cane',
        ['weight'] = 100,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_candycane.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A festive candy cane, sharp enough to double as a weapon.'
    },
    ['weapon_christbat'] = {
        ['name'] = 'weapon_christbat',
        ['label'] = 'Christmas Bat',
        ['weight'] = 300,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_christbat.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A baseball bat with Christmas decorations, packing a festive punch.'
    },
    ['weapon_christchair'] = {
        ['name'] = 'weapon_christchair',
        ['label'] = 'Christmas Chair',
        ['weight'] = 500,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_christchair.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A robust chair decorated for Christmas, perfect for improvised combat.'
    },
    ['weapon_christhammer'] = {
        ['name'] = 'weapon_christhammer',
        ['label'] = 'Christmas Hammer',
        ['weight'] = 400,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_christhammer.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A heavy hammer adorned with festive details, ideal for smashing things with holiday cheer.'
    },
    ['weapon_christmug'] = {
        ['name'] = 'weapon_christmug',
        ['label'] = 'Christmas Mug',
        ['weight'] = 150,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_christmug.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A solid mug perfect for enjoying cocoa—or breaking things.'
    },
    ['weapon_christree'] = {
        ['name'] = 'weapon_christree',
        ['label'] = 'Christmas Tree',
        ['weight'] = 800,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_christree.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A small, sturdy Christmas tree for spreading holiday fear.'
    },
    ['weapon_sleigh'] = {
        ['name'] = 'weapon_sleigh',
        ['label'] = 'Sleigh',
        ['weight'] = 1000,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_sleigh.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'Santa’s sleigh turned into a powerful weapon for epic battles.'
    },
    ['weapon_snowman'] = {
        ['name'] = 'weapon_snowman',
        ['label'] = 'Snowman',
        ['weight'] = 700,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_snowman.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A cheerful snowman to knock your foes down with wintery force.'
    },
    ['weapon_snowmannose'] = {
        ['name'] = 'weapon_snowmannose',
        ['label'] = 'Snowman Nose',
        ['weight'] = 50,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_snowmannose.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A sharp carrot nose from a snowman, surprisingly effective as a weapon.'
    },
    ['weapon_snowshovel'] = {
        ['name'] = 'weapon_snowshovel',
        ['label'] = 'Snow Shovel',
        ['weight'] = 400,
        ['type'] = 'weapon',
        ['ammotype'] = nil,
        ['image'] = 'weapon_snowshovel.png',
        ['unique'] = false,
        ['useable'] = true,
        ['description'] = 'A sturdy shovel designed for snow, perfect for digging out enemies.'
    },

```

### <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 Christmas V1 Weapons

    [`weapon_antler`] = {
        name = 'weapon_antler',
        label = 'Antler',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Impaled/ Bludgeoned'
    },
    [`weapon_candycane`] = {
        name = 'weapon_candycane',
        label = 'Candy Cane',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Pierced/ Bludgeoned'
    },
    [`weapon_christbat`] = {
        name = 'weapon_christbat',
        label = 'Christmas Bat',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },
    [`weapon_christchair`] = {
        name = 'weapon_christchair',
        label = 'Christmas Chair',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned/ Crushed'
    },
    [`weapon_christhammer`] = {
        name = 'weapon_christhammer',
        label = 'Christmas Hammer',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned/ Smashed'
    },
    [`weapon_christmug`] = {
        name = 'weapon_christmug',
        label = 'Christmas Mug',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned/ Struck'
    },
    [`weapon_christree`] = {
        name = 'weapon_christree',
        label = 'Christmas Tree',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned/ Struck'
    },
    [`weapon_sleigh`] = {
        name = 'weapon_sleigh',
        label = 'Sleigh',
        weapontype = 'Heavy',
        ammotype = nil,
        damagereason = 'Crushed'
    },
    [`weapon_snowman`] = {
        name = 'weapon_snowman',
        label = 'Snowman',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned/ Crushed'
    },
    [`weapon_snowmannose`] = {
        name = 'weapon_snowmannose',
        label = 'Snowman Nose',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Pierced'
    },
    [`weapon_snowshovel`] = {
        name = 'weapon_snowshovel',
        label = 'Snow Shovel',
        weapontype = 'Melee',
        ammotype = nil,
        damagereason = 'Bludgeoned'
    },

```

### <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 Christmas V1 Weapons
    
    weapon_antler = 0.10,
    weapon_candycane = 0.10,
    weapon_christbat = 0.10,
    weapon_christchair = 0.10,
    weapon_christhammer = 0.10,
    weapon_christmug = 0.10,
    weapon_christree = 0.10,
    weapon_sleigh = 0.10,
    weapon_snowman = 0.10,
    weapon_snowmannose = 0.10,
    weapon_snowshovel = 0.10,

```