> 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

## 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"
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://uziplexs-docs.gitbook.io/itemjoin-documenattion/basics/creating-items.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.