> For the complete documentation index, see [llms.txt](https://groupmoro.gitbook.io/groupmoro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://groupmoro.gitbook.io/groupmoro/smartitemcreator/create-items/items.md).

# Items

This page describes how to create custom items

### items.yml

```
items:

  magic_sword:
    material: DIAMOND_SWORD
    amount: 1
    display_name: "&bMagic Sword"
    lore:
      - "&eThe legendary sword"
      - "&eForge of the Ancients"
    enchantments:
      DAMAGE_ALL: 5
      FIRE_ASPECT: 2
    hide-enchants: false
    
```

The things strictly necessary to create a simple item would be:

```
  magic_sword:
    material: DIAMOND_SWORD
```

All other entries are optional.

***

Description of the entries

<table><thead><tr><th>Entries</th><th>Descriptions</th></tr></thead><tbody><tr><td><pre><code>magic_sword:
</code></pre></td><td>It is the name we give to the object, which can then be called with the command: /smartitemcreator &#x3C;item><br>&#x3C;item> = magic_sword</td></tr><tr><td><pre><code>material: DIAMOND_SWORD
</code></pre></td><td>In this section you should enter the material you want to use from those in the game.<br>If no material is entered, it takes the default one
<br>(default: STONE)</td></tr><tr><td><pre><code>amount: 1
</code></pre></td><td>OPTIONAL<br>Amount of items that will be given to the player (default: 1)</td></tr><tr><td><pre><code>display_name: "&#x26;bMagic Sword"
</code></pre></td><td>OPTIONAL<br>In this section you can enter a name to give to the item that will then be visible in the game. It supports classic minecraft text formatting: style and color</td></tr><tr><td><pre><code>  lore:
      - "&#x26;eThe legendary sword"
      - "&#x26;eForge of the Ancients"
</code></pre></td><td>OPTIONAL<br>It is possible to insert a lore of one or more visible lines into the in-game item. It supports classic minecraft text formatting: style and color</td></tr><tr><td><pre><code>    enchantments:
      DAMAGE_ALL: 5
      FIRE_ASPECT: 2
    hide-enchants: false
</code></pre></td><td>OPTIONAL<br>It is possible to assign one or more enchantments to the object, choosing whether to make them visible or not.</td></tr></tbody></table>