> For the complete documentation index, see [llms.txt](https://gstudios.gitbook.io/gslibrary/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gstudios.gitbook.io/gslibrary/gui-api/gui-normal-item.md).

# GUI Normal item

A tutorial how to create a normal static item to the gui

{% code title="syntax" overflow="wrap" lineNumbers="true" %}

```yaml
item:
  #data
  material: string
  amount: number
  player: string
  base64: string
  name: string
  lore: string list
  custommodeldata: number
  update: boolean
  enchants: string list
  itemflags: string list
  actions: action data
```

{% endcode %}

### - Material

The item material you want to use. It will be displayed in the menu and you can expand it further.\
All materials can be found here: [click here!](https://github.com/CryptoMorin/XSeries/blob/master/src/main/java/com/cryptomorin/xseries/XMaterial.java)

{% code overflow="wrap" lineNumbers="true" %}

```yaml
material: 'your material' # example: STONE
```

{% endcode %}

### - Item amount

The amount of the item that will be showed

{% code overflow="wrap" lineNumbers="true" %}

```yaml
amount: 'number' # example: 10
```

{% endcode %}

### - Player head

In case you use the **PLAYER\_HEAD** material, you can add a player skin to this head according to his name.

{% code overflow="wrap" lineNumbers="true" %}

```yaml
player: 'player name' # example: Gennario
```

{% endcode %}

### - Base64 head

In case you use the **PLAYER\_HEAD** material, you can add a base64 skin to this head with base64 string. [Heads can be found here...](https://minecraft-heads.com/custom-heads)

This is head base64 string (at the bottom of the selected head page)

![](https://4132704493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8nCQMPdPy7uiPgCET2S%2Fuploads%2Fi7KHBnS8QOtQZfVtdDPp%2Fobrazek.png?alt=media\&token=b8946d24-bd1f-4861-b768-8a66d7bc7e1f)

{% code overflow="wrap" lineNumbers="true" %}

```yaml
base64: 'base64 value'
```

{% endcode %}

### - Item name

Item can have a display name. Name supports [colors](/gslibrary/color-api/colors-in-configurations.md) and PlaceholderAPI.

{% code overflow="wrap" lineNumbers="true" %}

```yaml
name: 'text here' # example: '&cHello &aworld'
```

{% endcode %}

### - Item lore

Item can have a lore that contains multiple lines without any langth and size limit. Lore supports [colors](/gslibrary/color-api/colors-in-configurations.md) and PlaceholderAPI.

{% code overflow="wrap" lineNumbers="true" %}

```yaml
lore: 
  - 'text here' # example: '&cHello &aworld'
  - 'text here' # example: '&cHello &aworld'
  ...
```

{% endcode %}

### - CustomModelData

If you want to use a resourcepack item, you can set it with item custom model data

{% code overflow="wrap" lineNumbers="true" %}

```yaml
custommodeldata: 'model number' # example: 1002
```

{% endcode %}

### - Update

If you want to be your item in the GUI live updated, just add update line to your item and your item will be updated in specified interval for the gui.

{% code overflow="wrap" lineNumbers="true" %}

```yaml
update: 'boolean' # example: true
```

{% endcode %}

### - Item enchants

If you want to add enchants to your item, you can do it this way.\
Format: **ENCHANT;LEVEL**\
All enchant types can by found [`here`](https://github.com/CryptoMorin/XSeries/blob/master/src/main/java/com/cryptomorin/xseries/XEnchantment.java)!

{% code overflow="wrap" lineNumbers="true" %}

```yaml
enchants: 
  - 'enchant;level' # example: 'DAMAGE_ALL;1'
```

{% endcode %}

### - Item itemflags

If you want to hide some things from the item, you can use itemflags.\
All itemflags can be found [`here`](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html)!

{% code overflow="wrap" lineNumbers="true" %}

```yaml
itemflags: 
  - 'flag' # example: 'HIDE_ENCHANTS'
```

{% endcode %}
