# items

To create a custom mapping for items you need to know what you are going to use, for example if you item is a Sword you need to know if that sword is using a netherite\_sword as base or a iron\_sword, if you already know what base items you are using put the base item name in the the `"minecraft: " [` like this:

```json
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "some_name",
                "custom_model_data": 10000,
                "display_name": "§eSome description",
                "is_tool": false,
                "is_hat": false,
                "texture_size": 16                
            }
        ]             
    }
}
```

Now to specify what item are you creating you need to specify the indetifier of your item here `"name": ""`, if you don't have the identifier please go to [**custom things**](/custom-resource-pack-geysermc/custom-things/armors.md) category and read the page you are looking for. Now the file should look like this

```json
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "my_amazing_custom_item",
                "custom_model_data": 10000,
                "display_name": "§eI am a sword :)",
                "is_tool": false,
                "is_hat": false,
                "texture_size": 16                
            }
        ]             
    }
}
```

To continue you need to specify the custom model data in `"custom_model_data":` and the custom thing now look like this

```json
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "my_amazing_custom_item",
                "custom_model_data": 10440,
                "display_name": "§eI am a sword :)",
                "is_tool": false,
                "is_hat": false,
                "texture_size": 16                
            }
        ]             
    }
}
```

{% hint style="warning" %}
IMPORTANT: The custom\_model\_data need to be the same as the item in Minecraft Java
{% endhint %}

Now always that you are making a item change the `"is_tool": false` to true like this

```
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "my_amazing_custom_item",
                "custom_model_data": 10440,
                "display_name": "§eI am a sword :)",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            }
        ]             
    }
}
```

To add more items in the same file you can add a coma in the closing bracket **}** like this:

```json
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "my_amazing_custom_item",
                "custom_model_data": 10440,
                "display_name": "§eI am a sword :)",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            },
            {
                "name": "my_other_item",
                "custom_model_data": 10440,
                "display_name": "§eI another sword :)",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            }            
        ]             
    }
}
```

To add other items that use a diferent base item you need to add a coma in the closing square braket **]** like this

```json
{
    "format_version": 1,
    "items": {
        "minecraft:iron_sword": [
            {
                "name": "my_amazing_custom_item",
                "custom_model_data": 10440,
                "display_name": "§eI am a sword :)",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            },
            {
                "name": "my_other_item",
                "custom_model_data": 11440,
                "display_name": "§eI another sword :)",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            }            
        ],    
        "minecraft:diamond_sword": [
            {
                "name": "im_alive",
                "custom_model_data": 10357,
                "display_name": "§eMy dad is a diamond sword uwu",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            },
            {
                "name": "other_new_item",
                "custom_model_data": 32440,
                "display_name": "§eHi :D",
                "is_tool": true,
                "is_hat": false,
                "texture_size": 16                
            }            
        ],          
    }
}
```

When you have the mappings created now you should put them in the custom mappings folders that is located in `my_server/plugins/Geyser-Spigot/custom_mappings/`

To continue go to:

{% content-ref url="/pages/ciNrTQPniRPrn0P8qf4D" %}
[Inventory Texture](/custom-resource-pack-geysermc/last-steps/inventory-texture.md)
{% endcontent-ref %}


---

# 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://jugandomiguel.gitbook.io/custom-resource-pack-geysermc/custom-mappings/create-the-mapping-file/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.