Troubleshooting Items

help


TIP

This page contains troubleshooting information about items. You should read our global troubleshooting document before continuing here.

Start Here

I followed a tutorial or tried to make my own item and something is wrong! Calm down. This page will help debug common issues. Follow the buttons and prompts to learn about possible issues with your item, and tips for fixing.

Continue


1.10 vs 1.16 Items?

Before starting, you need to determine whether you creating an experimental item, or a stable item.

TIP

Versions 1.16.0 and prior are currently stable (Includes versions 1.16, 1.14, 1.13, 1.12, 1.10). These do not require Holiday Creator Features to be enabled.

🔗 Tutorial on stable items. 🔗 Documentation for stable items

TIP

Versions 1.16.100 and onward are experimental. These items will not work unless Holiday Creator Features is enabled in the world.

🔗 Our tutorial on experimental items. 🔗 Documentation for experimental items

Continue

1.10 format (stable)
1.16.100 format (experimental)

Stable Items

This section contains troubleshooting information for stable items. Remember, you are using the 1.10 format, so you need both an RP file and a BP file for your item! If you only have a BP file, you have become confused between format versions. Please start again here.

Find the issue you have, then read the prompts.

I cannot /give myself my custom item!

An issue here will be caused by the item file in the BP.

  • Confirm that your pack is actually applied to your world
  • Confirm that your item is in the folder BP/items/
  • Confirm that your item is valid, according to jsonlint.
  • Confirm that your identifier is all lowercase, and looks similar to this: wiki:my_item

My textures are missing!

Navigate to your item_texture.json file. Ensure that it is properly named, and in the correct folder. Some examples of wrong names:

  • ⚠️ texture/item_texture.json
  • ⚠️ textures/Item_texture.json
  • ⚠️ textures/item_textures.json

Here is an example file to compare against:

RP/textures/item_texture.jsonCopy
{
	"resource_pack_name": "wiki",
	"texture_name": "atlas.items",
	"texture_data": {
		"gem": {
			"textures": "textures/items/gem"
		}
	}
}
1
2
3
4
5
6
7
8
9

Next, navigate to your items RP file. Ensure that it is in the correct folder. Some examples of incorrect paths:

  • ⚠️ item/gem.json

An example file, to compare against:

RP/items/gem.jsonCopy
{
	"format_version": "1.10",
	"minecraft:item": {
		"description": {
			"identifier": "wiki:gem",
			"category": "Nature"
		},
		"components": {
			"minecraft:icon": "gem", //make sure this string matches the string you put in item_texture.json!
			"minecraft:render_offsets": "tools"
		}
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13

If you followed this properly, your item should now have a texture.


Experimental Items

This section contains troubleshooting information for experimental items. Remember, you are using the 1.16 format, so there shouldn't be an RP file for your item! If you have both an RP file and a BP file, you have become confused between format versions. Please start again here.

Find the issue you have, then read the prompts.

I cannot /give myself my custom item!

  • Confirm that your pack is actually applied to your world
  • Confirm that your item is in the folder BP/items/
  • Confirm that your item is valid, according to jsonlint.
  • Confirm that your identifier is all lowercase, and looks similar to this: wiki:my_item

My Textures Are Missing!

Navigate to your item_texture.json file. Ensure that it is properly named, and in the correct folder. Some examples of wrong names:

  • ⚠️ texture/item_texture.json
  • ⚠️ textures/Item_texture.json
  • ⚠️ textures/item_textures.json

Here is an example file to compare against:

RP/textures/item_texture.jsonCopy
{
	"resource_pack_name": "wiki",
	"texture_name": "atlas.items",
	"texture_data": {
		"gem": {
			"textures": "textures/items/gem"
		}
	}
}
1
2
3
4
5
6
7
8
9

Next, navigate to your items BP file. Place the minecraft:icon component in your item file under the components section. Ensure that it is properly named.

BP/items/your_item.jsonCopy
{
  "format_version": "1.16.100",
  "minecraft:item": {
      "description": {
          "identifier": "namespace:your_item",
          "category" : "items"     // This line is required
      },
      "components": {
        "minecraft:icon": {
          "texture": "your_item_name" //make sure this string matches the string you put in item_texture.json
        }
      },
      "events": {...}
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

If you followed this properly, your item should now have a texture.

My item is Huge

To turn it to back into a normal size item (16x16), use the following formula: base value/(res/16)

The base values, [0.075, 0.125, 0.075], seems to be the about the same scale value as normal items.


What now?

You've reached the end of the guide. If you still have any problems, feel free to join the discord server and ask your question there.

Contributors