# Introduction

![](/files/-M-kwgdYVBexDNkqZShD)

### About custom items

For every mob, you can define custom items. Custom items can have custom data, including display names with colors, but also enchanted items are possible.

### How to define custom items

Custom items are defined in the "items.yml" file. Below you can seen an example of the items.yml config

```yaml
items:
  helmet: "DIAMOND_HELMET:0 1 protection:4 thorns:3"
  chestplate: "DIAMOND_CHESTPLATE:0 1 protection:4 thorns:3"
  leggings: "DIAMOND_LEGGINGS:0 1 protection:4 thorns:3"
  boots: "DIAMOND_BOOTS:0 1 protection:4 thorns:3"
  zombie-sword: "DIAMOND_SWORD:0 1 sharpness:5 fire_aspect:2"
  bow: "BOW:0 1 power:5"
  skelly-chestplate: "GOLDEN_CHESTPLATE:0 1 protection:4 thorns:3"
  wither-sword: "GOLDEN_SWORD:0 1 sharpness:2"
  super-stick: "STICK:0 sharpness:5"
```

Every item has a very static way of storing its data.

```
{item}:{damage} {amount} [name:{}, lore:{}, owner:{}, rgb:{}] [{enchantment}:{level}]
```

### Configuring a custom item

the easiest way to configure a custom item is by using the commands. Start by getting the item you want to store in your hand. This item may contain custom lores, names, colors, etc ...

Use the following command to add the item:

```
/bloodmoon item set <name>
```

If you want to get an item instead of setting it, you can use the following command:

```
/bloodmoon item get <name>
```

{% hint style="info" %}
If you need more information about item commands, click [here](/items/commands.md)
{% endhint %}


---

# 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://bloodmoon.pseudonova.com/items/introduction.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.
