> For the complete documentation index, see [llms.txt](https://docs.gunchi.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gunchi.dev/scripts/armour-plates-system/installation.md).

# Installation

### **1. Add Items to Core**

Add the following item definitions to your **core item config** (`shared.gta5.lua`):

```lua
["armourplatelevel2"] = {
    ["label"] = "Level 2 Kevlar Plate",
    ["weight"] = 550,
    ["type"] = "item",
    ["image"] = "l2plate.webp",
    ["unique"] = false,
    ["stackable"] = false,
    ["useable"] = true,
    ["shouldClose"] = true,
    ["description"] = "Protects against 9mm and .357 Magnum"
},

["armourplatelevel3a"] = {
    ["label"] = "Level 3A Kevlar Plate",
    ["weight"] = 700,
    ["type"] = "item",
    ["image"] = "l3aplate.webp",
    ["unique"] = false,
    ["stackable"] = false,
    ["useable"] = true,
    ["shouldClose"] = true,
    ["description"] = "Protects against 9mm, .357 SIG, .44 Magnum"
},

["armourplatelevel3"] = {
    ["label"] = "Level 3 Steel Plate",
    ["weight"] = 3600,
    ["type"] = "item",
    ["image"] = "l3plate.webp",
    ["unique"] = false,
    ["stackable"] = false,
    ["useable"] = true,
    ["shouldClose"] = true,
    ["description"] = "Stops 7.62mm NATO FMJ (e.g., AK-47, AR-10)"
},

["armourplatelevel4"] = {
    ["label"] = "Level 4 Steel Plate",
    ["weight"] = 4500,
    ["type"] = "item",
    ["image"] = "l4plate.webp",
    ["unique"] = false,
    ["stackable"] = false,
    ["useable"] = true,
    ["shouldClose"] = true,
    ["description"] = "Stops .30-06 armor-piercing (AP) rounds"
},
```

***

### **2. Add Item Images**

Place the following images into your **inventory image directory**:

* `l2plate.webp`
* `l3aplate.webp`
* `l3plate.webp`
* `l4plate.webp`

Make sure the filenames match the `"image"` values in the item entries.

***

### **3. Run the Resource**

Start or ensure the script in your server’s configuration file (e.g. `resources.cfg`, `server.cfg`).

***

### **4. Use the Items In-Game**

Once everything is added and the server is running, simply **spawn or purchase the plates** and use them to apply the armour.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gunchi.dev/scripts/armour-plates-system/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.