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.
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
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:
{
"resource_pack_name": "wiki",
"texture_name": "atlas.items",
"texture_data": {
"gem": {
"textures": "textures/items/gem"
}
}
}
2
3
4
5
6
7
8
9
Next, navigate to your items RP file. Ensure that it is in the correct folder. Example of incorrect path:
- ⚠️
item/gem.json
An example file, to compare against:
{
"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"
}
}
}
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:
{
"resource_pack_name": "wiki",
"texture_name": "atlas.items",
"texture_data": {
"gem": {
"textures": "textures/items/gem"
}
}
}
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.
{
"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": {...}
}
}
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 render offsets and 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.
"minecraft:render_offsets":{
"main_hand":{
"first_person":{
"scale":[
0,
0,
0
]
},
"third_person":{
"scale":[
0,
0,
0
]
}
},
"off_hand":{
"first_person":{
"scale":[
0,
0,
0
]
},
"third_person":{
"scale":[
0,
0,
0
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
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.