# Item Format

### Default Item Options:

| Key               | Description                                                                                                                                                                                                                                                                                                                 |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| material          | Specify the material name. Refer to the original materials list [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html), or explore additional XMaterial options [here](https://github.com/CryptoMorin/XSeries/blob/master/src/main/java/com/cryptomorin/xseries/XMaterial.java).                         |
| name              | Specify the display name for the item.                                                                                                                                                                                                                                                                                      |
| lore              | Define the lore for the item.                                                                                                                                                                                                                                                                                               |
| glow              | Enable item glow when set to true.                                                                                                                                                                                                                                                                                          |
| amount            | Specify the quantity of the item.                                                                                                                                                                                                                                                                                           |
| damage            | Adjust the damage (durability) of the item.                                                                                                                                                                                                                                                                                 |
| custom-model-data | Set the custom model data for the item. (Server version 1.14+ required)                                                                                                                                                                                                                                                     |
| unbreakable       | Render the item unbreakable. (Server version 1.9+ required)                                                                                                                                                                                                                                                                 |
| texture           | Utilize this feature to add a texture to player heads, supporting custom textures found [here](https://minecraft-heads.com/). It accommodates full URLs or signature-only options.                                                                                                                                          |
| owner             | This is utilized to assign an owner to a player head, supporting either the player's name or their full UUID.                                                                                                                                                                                                               |
| color             | This applies to firework stars, potions, leather armor, and tipped arrows. Find custom item colors below.                                                                                                                                                                                                                   |
| item-flags        | Set item flags on items. By default, it employs a few flags to streamline items, but you have the flexibility to override the default item flags. Find item flags [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html).                                                                      |
| patterns          | Employ patterns to create custom designs for banners and shields. This is a list and the format is `DyeColor;BannerType`. Find DyeColor [here](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/DyeColor.html) and BannerType [here](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/banner/PatternType.html). |
| trim-material     | Specify the trim material for your armor. Refer to the available values [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimMaterial.html). (Server version 1.20+ and trim-pattern required)                                                                                                 |
| trim-pattern      | Define the trim pattern for your armor. Explore available values [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimPattern.html). (Server version 1.20+ and trim-material required)                                                                                                        |

{% hint style="info" %}
You can employ placeholders for name, lore, and owner values.
{% endhint %}

### Hook Item Options:

You can employ only a single-item plugin hook option per item.

<table><thead><tr><th>Key</th><th width="214">Description</th><th>Plugin</th></tr></thead><tbody><tr><td>itemedit</td><td>Modify and save custom in-game items with ease.</td><td>ItemEdit</td></tr><tr><td>headdatabase</td><td>Utilize head textures simply by employing the ID.</td><td>HeadDatabase</td></tr><tr><td>itemsadder</td><td>Use custom items with textures (e.g. z_iainternal:icon_left_blue).</td><td>ItemsAdder</td></tr><tr><td>oraxen</td><td>Use custom items with textures</td><td>Oraxen</td></tr><tr><td>headdb</td><td>Utilize head textures simply by employing the ID.</td><td>HeadDB</td></tr><tr><td>mythicmobs</td><td>Use custom items.</td><td>MythicMobs</td></tr><tr><td>skulls</td><td>Utilize head textures simply by employing the ID.</td><td>Skulls</td></tr></tbody></table>

{% hint style="info" %}
You can supersede item hook options by employing alternative default settings.
{% endhint %}

### Custom Item Colors:

* RANDOM (RGB)
* R G B (e.g 255 0 0)
* \#RRGGBB (e.g #ff0099)
* COLOR (e.g WHITE)

{% hint style="info" %}
Find the default Bukkit colors [here](https://extremall.gitbook.io/advancedkits/information/custom-display-items#supported-colors).
{% endhint %}


---

# Agent Instructions: 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://extremall.gitbook.io/advancedkits/configurations/item-format.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.