# Items Tutorial
{% hint style="info" %}
There are just a few places where you need to configure items in MineChess. For now, just in the `inventory.yml` file and in the `game_items` section in the `config.yml` file.
{% endhint %}
Items on MineChess follow the same format, here you can find information of the properties of items.
An example of an item on the `config.yml` file:
```yaml
select_item:
item:
id: NAME_TAG
name: "&7[&b&lSelect Piece&7]"
lore:
- "&eLeft Click &7to select piece"
- "&eRight Click &7to move piece"
```
## Id
The id/material of the item. Latest Versions Material:
```yaml
id: LIME_TERRACOTTA
```
## Durability
Durability or data value of the item.
```yaml
durability: 5
```
## Name
Custom name of the item.
```yaml
name: "&7[&b&lSelect Piece&7]"
```
## Lore
Custom lore/description of the item.
```yaml
lore:
- "&eLeft Click &7to select piece"
- "&eRight Click &7to move piece"
```
## Amount
The number of items.
```yaml
amount: 16
```
## Custom Model Data
Custom model data value of the item. Only works on 1.16.5-1.21.3.
```yaml
custom_model_data: 5
```
## Custom Model Component Data
The new 1.21.4 custom model data. The flags, floats, colors and strings properties consist of a list of elements. \
More info here:
```yaml
custom_model_component_data:
strings:
- "string1"
flags:
- "flag1"
- "flag2"
floats: []
colors: []
```
## Enchants
Enchantments of the item. Use the following format: `;` \
You can find all enchantment names here:
```yaml
enchants:
- "DAMAGE_ALL;5"
```
## Item Flags
Item flags of this item. \
You can find all item flag names here:
```yaml
item_flags:
- HIDE_ATTRIBUTES
```
## Attributes
Attribute modifiers of this item. This is difficult to implement manually, so I suggest you not to modify this option unless you know what you are doing. Format: `;;;;` \
Attribute names: Operation names: \
Slot names: Generate a random uuid here:
```yaml
attributes:
- GENERIC_MAX_HEALTH;ADD_SCALAR;0.1;1ab87334-7a32-4307-b783-c5519f735260;HAND
- GENERIC_MOVEMENT_SPEED;ADD_SCALAR;0.35;766d5332-e2b1-493d-af98-5d3046da3f0a;HAND
```
## Color
Color of a leather armor.
```yaml
color: 8439583
```
## Hide Tooltip
Whether the tooltip should be hidden or not. 1.20.6+
```yaml
hide_tooltip: true
```
## Tooltip Style
Style of the tooltip background for the item. 1.21.2+ \
More info here: \
Format: "\:\"
```yaml
tooltip_style: "custom:ajneb"
```
## Model
Model of the item. 1.21.4+ \
More info here: \
Format: "\:\"
```yaml
model: "custom:model_1"
```
## Skull Data
Information of a player head with texture. \
You can find heads with textures and their properties here: .
```yaml
skull_data:
texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTA4Yjc3MmVjYWVlNzA2MjM1ZDFhZGJmMGI5YTI5YjU4YmE5YzBlZDYwZGU2ZjEwZWZiMWE3Zjg2ZDllIn19fQ=="
```
```yaml
skull_data:
owner: Ajneb
```
## Potion Data
Information of a potion item. Works for these items IDs: POTION, SPLASH\_POTION*,* LINGERING\_POTION, TIPPED\_ARROW. \
Potion Types: \
Potion Effects:
```yaml
potion_data:
# Format for potion effects:
# ;;
effects:
- INCREASE_DAMAGE;1;4800
- WATER_BREATHING;0;12000
extended: false
upgraded: false
type: UNCRAFTABLE
# Color only works on 1.9+, you can get the Minecraft color value here:
# https://minecraftcommand.science/armor-color
color: 6196631
```
## Banner Data
Information of a banner or shield item. \
Use the following format for patterns: `;` \
Colors: \
Pattern Types:
```yaml
banner_data:
patterns:
- BLUE;SQUARE_BOTTOM_LEFT
- BLUE;SQUARE_TOP_RIGHT
- LIME;STRAIGHT_CROSS
```
## Firework Data
Information of a firework rocket or a firework star. \
Format for firework effects: `;,,...;,,...;;` \
Firework types: \
Colors:
```yaml
# For firework rocket item
firework_data:
rocket_effects:
- BALL_LARGE;11743532,2437522;1973019,15790320;false;true
power: 1
```
```yaml
# For firework star item
firework_data:
star_effect: BALL;16777215;14188952,4312372;false;false
```
## Book Data
Information of a written book. Pages are stored in JSON format so I suggest you not to modify this manually. Hover and click events are stored, but only on 1.12+.
```yaml
book_data:
title: "Rules Book"
generation: ORIGINAL
author: "Ajneb97"
pages: []
```
## Armor Trim Data
Information of armor trim smithing templates. Works only for armor items. Only works on 1.20+. Patterns: Materials:
```yaml
trim_data:
pattern: ward
material: redstone
```
---
# 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://ajneb97.gitbook.io/minechess/items-tutorial.md?ask=
```
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.