Bedrock Edition beta item documentation

This is the item documentation for Bedrock Edition beta 1.13.0.4. 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 beta if the add-on isn't working properly. Resource and behavior packs created for the beta are not guaranteed to work on the final release.

minecraft:category

 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * String
 * category this item belongs in
 * }
 * }
 * }
 * }

minecraft:block
What type of block the item will look like in hand


 * {| class="wikitable"

! Type !! Value !! Default Value !! Description
 * String
 * }
 * }
 * }
 * }
 * }

minecraft:camera

 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Decimal
 * black_bars_duration
 * Decimal
 * black_bars_screen_ratio
 * Decimal
 * shutter_duration
 * Decimal
 * picture_duration
 * Decimal
 * slide_away_duration
 * }
 * Decimal
 * shutter_duration
 * Decimal
 * picture_duration
 * Decimal
 * slide_away_duration
 * }
 * Decimal
 * slide_away_duration
 * }
 * Decimal
 * slide_away_duration
 * }
 * }
 * }

minecraft:foil
Make items appear with enchanted glint


 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Boolean
 * True, false
 * false
 * }
 * }
 * }

minecraft:food
Whether the item in hand is edible


 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Integer
 * Nutrition
 * 1
 * How many food points are gained when consumed
 * Boolean
 * can_always_eat
 * false
 * Setting it to true makes it so the food can be eaten even when hunger bar is full
 * String
 * using_converts_to
 * What the item is converted into when eaten, ex.when eating mushroom stew you get a bowl back
 * String
 * saturation_modifier
 * normal
 * how saturated the food is, including "poor", "low", "normal", "good", "high" and "supernatural"
 * List
 * effects
 * status effect given after player eat the food, Include "name", "chance", "duration", and "amplifier"
 * Boolean
 * is_meat
 * Defines if this food is meat
 * String
 * on_use_action
 * List
 * on_use_range
 * String
 * cooldown_type
 * Integer
 * cooldown_time
 * How long the cooldown of this item before can be eaten again
 * }
 * String
 * on_use_action
 * List
 * on_use_range
 * String
 * cooldown_type
 * Integer
 * cooldown_time
 * How long the cooldown of this item before can be eaten again
 * }
 * String
 * cooldown_type
 * Integer
 * cooldown_time
 * How long the cooldown of this item before can be eaten again
 * }
 * cooldown_time
 * How long the cooldown of this item before can be eaten again
 * }
 * }
 * }

minecraft:hand_equipped
How item will look like on hand


 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Boolean
 * True, false
 * false
 * Setting it to true will make it held like a tool
 * }
 * }

minecraft:max_damage

 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Integer
 * value
 * The maximum durability an item can sustain before breaking
 * }
 * The maximum durability an item can sustain before breaking
 * }

minecraft:max_stack_size

 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Integer
 * value
 * 64
 * How much the item can be stacked
 * }
 * }

minecraft:seed

 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * String
 * crop_result
 * Transform this item into crop when planted
 * List
 * plant_at
 * Block where this item can be planted
 * }
 * plant_at
 * Block where this item can be planted
 * }
 * }

minecraft:stacked_by_data
Make items with same identifier but with different data value become unstackable


 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Boolean
 * True, false
 * false
 * Only used to items with multiple data value
 * }
 * }

minecraft:use_duration
The amount of time it takes to use an item


 * {| class="wikitable"

! Type !! Name !! Default Value !! Description
 * Integer
 * value
 * The amount of time from when the item is first used to when it is finished
 * }
 * The amount of time from when the item is first used to when it is finished
 * }


 * Code Example


 * Example for food item

{ "format_version": "1.10", "minecraft:item": { "description": { "identifier": "minecraft:chorus_fruit" },

"components": { "minecraft:use_duration": 32, "minecraft:food": { "nutrition": 4, "saturation_modifier": "low", "on_use_action": "chorus_teleport", "on_use_range": [ 8, 8, 8 ], "cooldown_type": "chorusfruit", "cooldown_time": 20, "can_always_eat": true }   }  } }


 * Another example for food item

{ "format_version": "1.10", "minecraft:item": { "description": { "identifier": "minecraft:appleEnchanted" },   "components": { "minecraft:hand_equipped": false, "minecraft:stacked_by_data": true, "minecraft:use_duration": 32, "minecraft:foil": true, "minecraft:food": { "nutrition": 4, "saturation_modifier": "supernatural", "can_always_eat": true, "effects": [ {           "name": "regeneration", "chance": 1.0, "duration": 30, "amplifier": 4 },         {            "name": "absorption", "chance": 1.0, "duration": 120, // 2 * 60 "amplifier": 3 },         {            "name": "resistance", "chance": 1.0, "duration": 300, "amplifier": 0 },         {            "name": "fire_resistance", "chance": 1.0, "duration": 300, "amplifier": 0 }       ]      }    }  } }
 * Example for seeds item

{ "format_version": "1.10", "minecraft:item": { "description": { "identifier": "minecraft:sweet_berries" },

"components": { "minecraft:use_duration": 32,

"minecraft:food": { "nutrition": 2, "saturation_modifier": "low", "is_meat": false },     "minecraft:seed": { "crop_result": "sweet_berry_bush", "plant_at": [ "grass", "dirt", "podzol" ]     }    }  } }
 * Example of camera item

{ "format_version": "1.10", "minecraft:item": { "description": { "identifier": "minecraft:camera" },   "components": { "minecraft:use_duration": 100000, "minecraft:block": "camera", "minecraft:camera": { "black_bars_duration": 0.2, "black_bars_screen_ratio": 0.08, "shutter_duration": 0.2, "picture_duration": 1.0, "slide_away_duration": 0.2 }   }  } }

基岩版beta物品文档