bedrock.dev

Info: Items are experimental and may change in the future.

ITEM DOCUMENTATION
Version: 1.16.100.56

This is documentation for a beta 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 beta if your add-on isn't working properly. Resource and Behavior Packs created for the beta are not guaranteed to work on the final release.

Index

Items

Item Components

Below are the various components for item functionality.

Name Type Default Value Description
minecraft:armor JSON Object The armor item componenent determines the amount of protection you have in your armor item.

protection

How much protection does the armor item have.

texture_type

Texture Type to apply for the armor. Note that Horse armor is restricted to leather, iron, gold, or diamond.
minecraft:block_placer JSON Object Planter item component. planter items are items that can be planted.

block

block: Set the placement block name for the planter item.

use_on

List of block descriptors that contain blocks that this item can be used on. If left empty, all blocks will be allowed.
minecraft:camera JSON Object The camera is a special item that can be used to take a picture or placed in the world as a camera tripod with a timer that takes your picture.

black_bars_duration

How long in ticks, does it take for black bars to slide into view when holding down the use button. Default is 5.0.

black_bars_screen_ratio

How much screen space should the black bars take up in a 0-0.5 ratio. Default is 0.08.

picture_duration

How long in ticks to show the picture. Default 20.0.

shutter_duration

How long in ticks to show the shutter. Default 3.33.

shutter_screen_ratio

How much screen space should the shutter take up in a 0-0.5 ratio. Default is 0.5.

slide_away_duration

How much time in ticks it takes for the picture to slide away. Default is 5.0.
minecraft:cooldown JSON Object Cool down time for a component. After you use an item it becomes unusable for the duration specified by the 'cool down time' setting in this component.

category

The type of cool down for this item.

duration

The duration of time this item will spend cooling down before becoming usable again.
minecraft:damageable JSON Object Damageable item component: how much damage can this item take before breaking.

damage_chance

Damage chance.

max_damage

Max damage is the amount of damage that this item can take before breaking.
minecraft:digger JSON Object Digger item. Component put on items that dig.

destroy_speeds

Destroy speed per block.

use_efficiency

Use efficiency? Default is set to false.
minecraft:display_name JSON Object Display Name item component. Display Names display the name of an item.

value

Set the display name for an item.
minecraft:dye_powder JSON Object Dye powder, there are 16 kinds of dye.

color

Defines what color the dye is.
minecraft:entity_placer JSON Object Entity placer item component. You can specifiy allowed blocks that the item is restricted to.

dispense_on

List of block descriptors that contain blocks that this item can be dispensed on. If left empty, all blocks will be allowed.

entity

The entity to be placed in the world.

use_on

List of block descriptors that contain blocks that this item can be used on. If left empty, all blocks will be allowed.
minecraft:food JSON Object When an item has a food component, it becomes edible to the player.

can_always_eat

If true you can always eat this item (even when not hungry), defaults to false.

nutrition

How much nutrition does this food item give the player when eaten.

on_consume


saturation_modifier

Saturation Modifier is used in this formula: (nutrition * saturation_modifier * 2) when appling the saturation buff. Which happens when you eat the item.

using_converts_to

When used, convert the *this* item to the one specified by 'using_converts_to'.
minecraft:fuel JSON Object Fuel component. Allows this item to be used as fuel in a furnace to 'cook' other items.

duration

How long in seconds will this fuel cook items for.
minecraft:knockback_resistance JSON Object Knockback Resistance Item. Component put on items that provide knockback resistance.

protection

Amount of knockback resistance provided with the total maximum protection being 1.0
minecraft:on_use JSON Object The on_use item component allows you to receive an event when the item is used.

on_use

Event trigger for when the item is used.
minecraft:projectile JSON Object Projectile item component. projectile items shoot out, like an arrow.

minimum_critical_power

How long you must charge a projectile for it to critically hit.

projectile_entity

The entity to be fired as a projectile.
minecraft:repairable JSON Object Repairable item component: how much damage can this item repair, what items can repair it.

repair_items

Repair item entries.
minecraft:shooter JSON Object Shooter Item Component.

ammunition

Ammunition.

charge_on_draw

Charge on draw? Default is set to false.

launch_power_scale

Launch power scale. Default is set to 1.0.

max_draw_duration

Draw Duration. Default is set to 0.

max_launch_power

Launch power. Default is set to 1.0.

scale_power_by_draw_duration

Scale power by draw duration? Default is set to false.
minecraft:throwable JSON Object Throwable item component. Throwable items, such as a snowball.

do_swing_animation

Whether the item should use the swing animation when thrown. Default is set to false.

launch_power_scale

The scale at which the power of the throw increases. Default is set to 1.0.

max_draw_duration

The maximum duration to draw a throwable item. Default is set to 0.0.

max_launch_power

The maximum power to launch the throwable item. Default is set to 1.0.

min_draw_duration

The minimum duration to draw a throwable item. Default is set to 0.0.

scale_power_by_draw_duration

Whether or not the power of the throw increases with duration charged. Default is set to false.
minecraft:weapon JSON Object Weapon Item Component. Added to every weapon item such as axe, sword, trident, bow, crossbow.

on_hurt

Trigger for letting you know when this item is used to hurt another mob
minecraft:wearable JSON Object Wearable item component.

dispensable


slot

equipment_slot: slot.weapon.mainhand, slot.weapon.offhand, slot.armor.head, slot.armor.chest, slot.armor.legs, slot.armor.feet, slot.hotbar, slot.inventory, slot.enderchest, slot.saddle, slot.armor, slot.chest

Item Definition Properties

The properties are part of the Item Definition. This helps the system determine how to parse and initialize this item.

format_version


Code Example

Example

{
  "format_version": "1.16.0",
 "minecraft:item": {
    "description": {
      "identifier": "minecraft:blaze_rod"
    },
    "components": {
      "minecraft:fuel": {
        "duration": 120.0
      },
      "minecraft:hand_equipped": true
    }
  }
}



Item Description Properties

Name Type Default Value Description
category String The category for this item. Categories are used to control high level properties of how the item is integrated into the bedrock engine, such as whether it can be used in slash commands.
identifier String The identifier for this item. The name must include a namespace and must not use the Minecraft namespace unless overriding a Vanilla item.
is_experimental Boolean false If this item is experimental, it will only be registered if the world is marked as experimental.



Website by destruc7i0n
Donate
GitHub

This website is not affiliated with Mojang Studios or Microsoft