物品问题排查指南

help

物品问题排查指南

从这里开始
- 物品不存在
- 材质丢失问题
后续步骤

TIP

本页面包含关于_物品_的故障排除信息。在继续阅读前，建议先查看我们的全局问题排查指南。

从这里开始

"我按照教程操作/尝试自己制作物品时出了问题！"

别担心！本页面将帮助您解决常见问题。

物品不存在

确认您的资源包已正确应用到当前世界
确认物品文件位于BP/items/文件夹内
使用jsonlint验证物品JSON文件的有效性
确保物品标识符全部为小写字母，格式类似：wiki:my_item

材质丢失问题

检查您的item_texture.json文件：

确保文件名拼写正确且位于正确路径
常见错误命名示例：
- ⚠️ texture/item_texture.json
- ⚠️ textures/Item_texture.json
- ⚠️ textures/item_textures.json

参考示例文件：

RP/textures/item_texture.json

json

{
    "resource_pack_name": "wiki",
    "texture_name": "atlas.items",
    "texture_data": {
        "wiki:your_item_icon": {
            "textures": "textures/items/your_item_icon"
        }
    }
}

接着检查物品行为包文件：

在components部分添加minecraft:icon组件
确保命名一致

BP/items/your_item.json

json

{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:your_item",
            "menu_category": {
                "category": "items"
            }
        },
        "components": {
            "minecraft:icon": "wiki:your_item_icon" // 确保此处的字符串与item_texture.json中定义的短名称一致
        }
    }
}