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

# Creating Items

Basics of creating items and other stuff

## Basic Item Example

You can copy and paste this to make multiple items!

```yaml
items:
    example:
        id: DIAMOND_SWORD
        slot: 0
        amount: 1
        durability: 1500
        name: "&7Cool Gamer Sword"
        lore:
        - ' '
        - "&eCute little lore for you =D"
```

## Configuration

### Basics

**ID** <- This will be the item you will receive upon joining, world switch or respawning

**Slot** <-  Slot where the player will receive the item, however if another item is in that slot you will not receive the item except if you add **overwrite** to the item flags

#### When using slots, you are able to use the following to set armor pieces:

```yaml
items:
    helmet:
        id: DIAMOND_HELMET
        slot: "helmet"
        amount: 1
        name: "&7Cool Gamer Helmet"
    chestplate:
        id: DIAMOND_CHESTPLATE
        slot: "chestplate"
        amount: 1
        name: "&7Cool Gamer Chestplate"
    leggings:
        id: DIAMOND_LEGGINGS
        slot: "leggings"
        amount: 1
        name: "&7Cool Gamer Leggings"
    boots:
        id: DIAMOND_BOOTS
        slot: "boots"
        amount: 1
        name: "&7Cool Gamer Boots"
```

**Amount** <- The amount of the items you will receive!

**Durability** <- You can use this to change items durability from default to something else

**Name** <- Custom name of the item you can use, if not set it default to normal (supports either minecraft colors or hex code)

<pre class="language-yaml"><code class="lang-yaml"><strong># EXAMPLE OF HEX COLOR CODES
</strong><strong>name: "&#x3C;#2E4053>Cool hex example"
</strong></code></pre>

**Lore** <- allows you to add description to items (supports either minecraft colors or hex code)

### Extras

**Enchantments** <- allows you to add enchantments to items! If you would like to check out all of the enchantments consider checking this out:

{% embed url="<https://help.minecraft.net/hc/en-us/articles/360058730912-Minecraft-List-of-Enchantments>" %}
Enchantments List
{% endembed %}

**Hide Attributes** <- when this is enabled, this it will hide damage of item and other

**Hide Enchants** <- when this is enabled, it will hide all active enchantments on the lore of item

```yaml
# EXAMPLE OF USING HIDE ATTRIBUTES, HIDE ENCHANTS and ENCHANTMENTS
items:
    example:
        id: DIAMOND_SWORD
        slot: 0
        amount: 1
        durability: 1500
        hide_attributes: true
        hide_enchants: true
        enchantments:
        - "sharpness 5"
        - "unbreaking 3"
```

### Worlds

**Enabled Worlds** <- when you have this added, you will be able to add where you want to allow this item to be received at!

```yaml
# EXAMPLE OF ENABLED WORLDS
items:
    example:
        id: DIAMOND_SWORD
        slot: 0
        amount: 1
        durability: 1500
        name: "&7Cool Gamer Sword"
        lore:
        - ' '
        - "&eCute little lore for you =D"
        enabled_worlds:
        - "world"
        - "world_nether"
        - "world_the_end"
```
