> For the complete documentation index, see [llms.txt](https://docs.rytrak.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rytrak.fr/scripts/advanced-shields-system/create-the-shield-item-for-qbcore.md).

# Create the Shield Item for QBCore

This guide explains how to create and configure the **Shield item** for **QBCore**.

***

### **1. Get the name of the shield item**

In **r\_shields**, open:

* `r_shields/config.lua`

Retrieve each name one by one from the shields listed in the script's configuration, by default, there will be three models:

* **ballistic\_shield**
* **prop\_ballistic\_shield**
* **wheel\_shield**

In our example, we'll use the first one (ballistic\_shield) but you'll need to repeat this process for all the shields on your list.

***

### **2. Create the Shield item in QBCore inventory**

#### If you use **qb-inventory**

Open:

```
qb-inventory/shared/items.lua
```

Add:

```lua
ballistic_shield = {
    name = 'ballistic_shield',
    label = 'Ballistic Shield',
    weight = 10000,
    type = 'item',
    image = 'ballistic_shield.png',
    unique = true,
    useable = true,
    shouldClose = true,
    description = 'Ballistic Shield',
},
```

#### **Field meaning (quick)**

* **name**: internal item id
* **label**: display name
* **weight**: item weight
* **image**: icon file name
* **unique = true**: prevents stacking
* **useable = true**: allows using the item

> If your inventory structure is slightly different, keep the same idea.

***

### **3. Add the Shield image**

Most QBCore inventories load images from:

```
qb-inventory/html/images/
```

You already have the icon here:

```
r_shields/ballistic_shield.png
```

Copy it to:

```
qb-inventory/html/images/ballistic_shield.png
```

The image filename must match with your item name.
