ITEM DOCUMENTATION
Version: 1.21.0.24

This is documentation for a preview release of Minecraft. New features, components, and capabilities in this release are not final and might change without notice before the final release.
Be sure to check the documentation once the release is out of preview if your add-on isn't working properly. Resource and Behavior Packs created for the preview are not guaranteed to work on the final release.

Index#

Items#

Items are defined in a JSON file inside a behavior pack.
All attributes, including item names, must be defined using item components.

Item Definition Properties#

Properties are part of the Item Definition. They help the system determine how to parse and initialize the item.

Name	Type	Default Value	Description
format_version			Specifies the version of the game this entity was made in. If the version is lower than the current version, any changes made to the entity in the vanilla version will be applied to it.
minecraft:item			Item definition includes the "description" and "components" sections.

Code Example

Example

{
  "format_version": "1.20.20",
  "minecraft:item": {
    "description": {
      "identifier": "minecraft:blaze_rod"
    },
    "components": {
      "minecraft:fuel": {
        "duration": 120.0
      },
      "minecraft:max_stack_size": 64,
      "minecraft:icon": {
        "texture": "blaze_rod"
      },
      "minecraft:hand_equipped": true,
      "minecraft:display_name": {
        "value": "Blaze Rod"
      }
    }
  }
}