diff --git a/develop/items/first-item.md b/develop/items/first-item.md index 84678c998..8a9dfbfa5 100644 --- a/develop/items/first-item.md +++ b/develop/items/first-item.md @@ -100,6 +100,15 @@ Create the model JSON in the `assets//models/item` folder, with the @[code](@/reference/latest/src/main/resources/assets/fabric-docs-reference/models/item/suspicious_substance.json) +But we're still missing a thing: the item still doesn't load? + +### Adding an Item Description {#adding-an-item-description} + +Since 1.21.4, Minecraft won't try to guess your item model's location anymore, and so, we need to provide an item description. + +Create the item description JSON in the `assets//items`, with the same name as the item; `suspicious_substance.json`. +@[code](@/reference/latest/src/main/resources/assets/fabric-docs-reference/items/suspicious_substance.json) + ### Breaking Down the Model JSON {#breaking-down-the-model-json} - `parent`: This is the parent model that this model will inherit from. In this case, it's the `item/generated` model. @@ -109,6 +118,11 @@ Most items will use the `item/generated` model as their parent, as it's a simple There are alternatives, such as `item/handheld` which is used for items that are held in the player's hand, such as tools. +### Breaking Down the Item Description JSON {#breaking-down-the-item-description-json} +- `model`: This is the property that contains the reference to our model. + - `type`: This is the type of our model. For most items, this should be `minecraft:model` + - `model`: This is the model's identifier. It should have this form: `:item/` + Your item should now look like this in-game: ![Item with correct model](/assets/develop/items/first_item_2.png) diff --git a/reference/1.20.4/src/main/resources/assets/fabric-docs-reference/items/suspicious_substance.json b/reference/1.20.4/src/main/resources/assets/fabric-docs-reference/items/suspicious_substance.json new file mode 100644 index 000000000..6c396054e --- /dev/null +++ b/reference/1.20.4/src/main/resources/assets/fabric-docs-reference/items/suspicious_substance.json @@ -0,0 +1,6 @@ +{ + "model": { + "type": "minecraft:model", + "model": "mod_id:item/suspicious_substance" + } +}