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

ITEM DOCUMENTATION
Version: 1.19.40.2

Index

Items

To define an item, the item definition must be defined in the behavior pack in a JSON file.
All attributes, including item names, must be defined using item components.

Item Components

Below are the various components for item functionality.

Name	Type	Description
minecraft:armor	JSON Object	The armor item component determines the amount of protection you have in your armor item. Experimental toggles required: Holiday Creator Features protection How much protection does the armor item have. Type: integer texture_type Texture Type to apply for the armor. Note that Horse armor is restricted to leather, iron, gold, or diamond. Accepted values: "leather", "none", "chain", "iron", "diamond", "gold", "elytra", "turtle", "netherite"
minecraft:block_placer	JSON Object	Planter item component. planter items are items that can be planted. Experimental toggles required: Holiday Creator Features block block: Set the placement block name for the planter item. Type: block use_on List of block descriptors that contain blocks that this item can be used on. If left empty, all blocks will be allowed. Type: array of use_on
minecraft:chargeable	JSON Object	Allows an item to be used over a duration. Experimental toggles required: Holiday Creator Features movement_modifier Modifier value to scale the players movement speed when item is in use. Type: float on_complete Event trigger for when the item has completed its use duration. Type: on_complete
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. Experimental toggles required: Holiday Creator Features category The type of cool down for this item. Type: category duration The duration of time this item will spend cooling down before becoming usable again. Type: float
minecraft:digger	JSON Object	Digger item. Component put on items that dig. Experimental toggles required: Holiday Creator Features destroy_speeds Destroy speed per block. Type: array of destroy_speeds on_dig Trigger for when you dig a block that isn't listed in destroy_speeds Type: on_dig use_efficiency Use efficiency? Default is set to false. Type: boolean
minecraft:display_name	JSON Object	Display Name item component. Display Names set the name to display when an item is in use or hovered over. Experimental toggles required: Holiday Creator Features value The display name for an item. Type: string
minecraft:durability	JSON Object	A property that determines when an item will break from use. The durability of an item is potentially depleted upon use based on the damage chance. Experimental toggles required: Holiday Creator Features damage_chance Damage chance is the percentage chance of this item losing durability. Default is set to 100. Defined as an int range with min and max value. Type: damage_chance max_durability Max durability is the amount of damage that this item can take before breaking. Type: integer
minecraft:dye_powder	JSON Object	Dye powder, there are 16 kinds of dye. Experimental toggles required: Holiday Creator Features color Defines what color the dye is. Accepted values: "black", "red", "green", "brown", "blue", "purple", "cyan", "silver", "gray", "pink", "lime", "yellow", "lightblue", "magenta", "orange", "white"
minecraft:entity_placer	JSON Object	Entity placer item component. You can specifiy allowed blocks that the item is restricted to. Experimental toggles required: Holiday Creator Features dispense_on List of block descriptors that contain blocks that this item can be dispensed on. If left empty, all blocks will be allowed. Type: array of dispense_on entity The entity to be placed in the world. Type: entity use_on List of block descriptors that contain blocks that this item can be used on. If left empty, all blocks will be allowed. Type: array of use_on
minecraft:food	JSON Object	When an item has a food component, it becomes edible to the player. Experimental toggles required: Holiday Creator Features can_always_eat If true you can always eat this item (even when not hungry). Default is set to false. Type: boolean nutrition The value that is added to the actor's nutrition when the item is used. Default is set to 0. Type: integer on_consume Event trigger for when the item is consumed. Type: on_consume saturation_modifier Saturation Modifier is used in this formula: (nutrition * saturation_modifier * 2) when applying the saturation buff. Default is set to 0.6. Type: float using_converts_to When used, converts to the item specified by the string in this field. Default does not convert item. Type: using_converts_to
minecraft:fuel	JSON Object	Allows this item to be used as fuel in a furnace to 'cook' other items. Experimental toggles required: Holiday Creator Features duration How long in seconds will this fuel cook items for. Type: float
minecraft:icon	JSON Object	The icon item component determines the icon to represent the item. Experimental toggles required: Holiday Creator Features legacy_id Legacy texture string id for older item icons. Legacy ID list can be found here under 'Namespaced ID': https://minecraft.fandom.com/wiki/Bedrock_Edition_data_values Type: string texture The key for the object contain the expected textures, from file 'resource_pack/textures/item_texture.json'. Type: string
minecraft:item_storage	JSON Object	The Storage Item Component is used for storing Items within an Item's User Data Experimental toggles required: Holiday Creator Features or Vanilla Experiments Internal (NON_LOC) capacity The max capacity of the item, default is 64 Type: integer
minecraft:knockback_resistance	JSON Object	Knockback Resistance Item. Component put on items that provide knockback resistance. Experimental toggles required: Holiday Creator Features protection Amount of knockback resistance provided with the total maximum protection being 1.0 Type: float
minecraft:on_use	JSON Object	The on_use item component allows you to receive an event when the item is used. Experimental toggles required: Holiday Creator Features on_use Event trigger for when the item is used. Type: on_use
minecraft:on_use_on	JSON Object	The on_use_on item component allows you to receive an event when the item is used on a block in the world. Experimental toggles required: Holiday Creator Features on_use_on Event trigger for when the item is used. Type: on_use_on
minecraft:projectile	JSON Object	Projectile item component. projectile items shoot out, like an arrow. Experimental toggles required: Holiday Creator Features minimum_critical_power How long you must charge a projectile for it to critically hit. Type: float projectile_entity The entity to be fired as a projectile. Type: projectile_entity
minecraft:record	JSON Object	Record Item Component. Used by record items to play music. Experimental toggles required: Holiday Creator Features comparator_signal Signal strength for comparator blocks to use, from 1 - 13. Type: integer duration Duration of sound event in seconds, float value. Type: float sound_event Sound event type: 13, cat, blocks, chirp, far, mall, mellohi, stal, strad, ward, 11, wait, pigstep, otherside, 5. Accepted values: "death.to.zombie", "jump.prevent", "item.use.on", "hit", "step", "break", "swim", "mob.player.hurt_drown", "step.baby", "fly", "horn_call4", "jump", "place", "heavy.step", "gallop", "fall", "hurt", "fizz", "ambient.screamer", "hurt.baby", "hurt.in.water", "death", "flap", "death.baby", "death.in.water", "ambient", "ambient.baby", "ambient.in.water", "ignite", "ambient.tame", "thunder", "random.anvil_use", "ambient.pollinate", "breathe", "mad", "boost", "bow", "squish.big", "squish.small", "fall.big", "fall.small", "splash", "drink", "shear", "block.end_portal_frame.fill", "drink.honey", "drink.milk", "pick_berries.cave_vines", "born", "eat", "reappeared", "takeoff", "shake", "plop", "land", "saddle", "armor", "item_taken", "mob.armor_stand.place", "add.chest", "record.5", "throw", "attack", "block.frog_spawn.hatch", "attack.nodamage", "attack.strong", "listening_angry", "warn", "sonic_charge", "milk", "bundle.remove_one", "explode", "fire", "fuse", "block.frog_spawn.break", "stare", "spawn", "bundle.drop_contents", "shoot", "break.block", "launch", "blast", "horn_call2", "large.blast", "twinkle", "remedy", "unfect", "copper.wax.off", "convert_to_drowned", "horn_call6", "levelup", "bow.hit", "bullet.hit", "extinguish.fire", "item.fizz", "chest.open", "chest.closed", "shulkerbox.open", "shulkerbox.closed", "enderchest.open", "enderchest.closed", "power.on", "power.off", "attach", "detach", "deny", "tripod", "pop", "drop.slot", "note", "thorns", "piston.in", "piston.out", "portal", "water", "lava.pop", "lava", "celebrate", "beacon.activate", "beacon.ambient", "block.smithing_table.use", "beacon.deactivate", "beacon.power", "pre_ram.screamer", "conduit.activate", "conduit.ambient", "block.click.fail", "conduit.attack", "conduit.deactivate", "glow_squid.ink_squirt", "conduit.short", "bubble.pop", "bubble.up", "tilt_up.big_dripleaf", "bubble.upinside", "power.on.sculk_sensor", "bubble.down", "bubble.downinside", "burp", "bucket.fill.water", "bucket.empty.water", "bucket.fill.lava", "bucket.empty.lava", "bucket.fill.fish", "drip.water.pointed_dripstone", "bucket.empty.fish", "armor.equip_chain", "armor.equip_diamond", "armor.equip_elytra", "armor.equip_generic", "armor.equip_gold", "armor.equip_iron", "armor.equip_leather", "armor.equip_netherite", "record.13", "record.cat", "record.blocks", "record.chirp", "record.far", "record.mall", "record.mellohi", "record.stal", "record.strad", "record.ward", "record.11", "record.wait", "cast.spell", "record.pigstep", "record.otherside", "flop", "elderguardian.curse", "teleport", "shulker.open", "shulker.close", "mob.warning", "mob.warning.baby", "haggle", "haggle.yes", "haggle.no", "haggle.idle", "disappeared", "chorusgrow", "chorusdeath", "glass", "potion.brewed", "prepare.attack", "roar", "prepare.summon", "prepare.wololo", "ambient.warped_forest.loop", "fang", "charge", "particle.soul_escape.quiet", "camera.take_picture", "block.bell.hit", "leashknot.break", "leashknot.place", "growl", "block.composter.fill_success", "whine", "pant", "block.sweet_berry_bush.hurt", "purr", "purreow", "item.book.put", "death.min.volume", "death.mid.volume", "block.composter.empty", "imitate.blaze", "imitate.cave_spider", "ui.stonecutter.take_result", "imitate.creeper", "imitate.elder_guardian", "block.barrel.open", "imitate.ender_dragon", "imitate.enderman", "imitate.evocation_illager", "ambient.in.raid", "imitate.ghast", "imitate.husk", "convert_mooshroom", "imitate.illusion_illager", "imitate.magma_cube", "block.smoker.smoke", "imitate.polar_bear", "imitate.shulker", "raid.horn", "imitate.silverfish", "imitate.skeleton", "imitate.slime", "imitate.spider", "block.beehive.work", "imitate.stray", "imitate.vex", "imitate.vindication_illager", "imitate.witch", "imitate.wither", "imitate.wither_skeleton", "block.beehive.enter", "imitate.wolf", "imitate.zombie", "tempt", "imitate.zombie_pigman", "imitate.zombie_villager", "block.end_portal.spawn", "bottle.dragonbreath", "balloonpop", "sparkler.active", "item.trident.hit", "respawn_anchor.basalt_deltas.mood", "item.trident.hit_ground", "respawn_anchor.charge", "item.trident.return", "item.trident.riptide_1", "angry", "item.trident.riptide_2", "item.trident.riptide_3", "retreat", "item.trident.throw", "item.trident.thunder", "smithing_table.use", "block.fletching_table.use", "elemconstruct.open", "respawn_anchor.set_spawn", "icebomb.hit", "ambient.soulsand_valley.mood", "lt.reaction.icebomb", "lt.reaction.bleach", "lt.reaction.epaste", "lt.reaction.epaste2", "heartbeat", "lt.reaction.fertilizer", "lt.reaction.fireball", "ambient.crimson_forest.loop", "lt.reaction.mgsalt", "lt.reaction.miscfire", "cauldron_drip.water.pointed_dripstone", "lt.reaction.fire", "lt.reaction.miscexplosion", "ambient.basalt_deltas.additions", "lt.reaction.miscmystical", "lt.reaction.miscmystical2", "ambient.nether_wastes.loop", "lt.reaction.product", "sparkler.use", "bucket.fill.powder_snow", "glowstick.use", "block.turtle_egg.break", "sleep", "block.turtle_egg.crack", "block.turtle_egg.hatch", "block.turtle_egg.attack", "swoop", "presneeze", "ambient.candle", "sneeze", "tongue", "scared", "ambient.aggressive", "irongolem.repair", "ambient.worried", "cant_breed", "block.scaffolding.climb", "jump_to_block", "block.bamboo_sapling.place", "block.sculk_shrieker.shriek", "crossbow.loading.start", "crossbow.loading.middle", "cake.add_candle", "crossbow.loading.end", "crossbow.shoot", "agitated", "crossbow.quick_charge.start", "crossbow.quick_charge.middle", "charge.sculk", "crossbow.quick_charge.end", "nearby_closer", "item.shield.block", "admire", "portal.travel", "block.grindstone.use", "block.campfire.crackle", "block.sweet_berry_bush.pick", "block.stonecutter.use", "block.cartography_table.use", "block.composter.fill", "block.composter.ready", "stun", "block.barrel.close", "ui.cartography_table.take_result", "ui.loom.take_result", "block.blastfurnace.fire_crackle", "block.loom.use", "screech", "block.furnace.lit", "milk_suspiciously", "block.beehive.exit", "block.beehive.shear", "block.beehive.drip", "ambient.cave", "converted_to_zombified", "step_lava", "panic", "particle.soul_escape.loud", "respawn_anchor.deplete", "respawn_anchor.ambient", "ambient.crimson_forest.mood", "ambient.warped_forest.mood", "ambient.nether_wastes.mood", "ambient.crimson_forest.additions", "ambient.warped_forest.additions", "ambient.soulsand_valley.additions", "ambient.nether_wastes.additions", "ambient.soulsand_valley.loop", "ambient.basalt_deltas.loop", "lodestone_compass.link_compass_to_lodestone", "power.off.sculk_sensor", "default", "ram_impact.screamer", "lay_egg", "lay_spawn", "bucket.empty.powder_snow", "cauldron_drip.lava.pointed_dripstone", "tilt_down.big_dripleaf", "drip.lava.pointed_dripstone", "copper.wax.on", "scrape", "item.spyglass.use", "item.spyglass.stop_using", "chime.amethyst_block", "mob.player.hurt_on_fire", "mob.player.hurt_freeze", "hurt.screamer", "death.screamer", "milk.screamer", "pre_ram", "ram_impact", "squid.ink_squirt", "convert_to_stray", "extinguish.candle", "block.click", "block.sculk_catalyst.bloom", "nearby_close", "nearby_closest", "listening", "item_given", "item_thrown", "irongolem.crack", "horn_break", "horn_call0", "horn_call1", "horn_call3", "horn_call5", "horn_call7", "imitate.warden", "sonic_boom", "convert_to_frog", "block.sculk.spread", "block.sculk_sensor.place", "block.sculk_shrieker.place", "block.enchanting_table.use", "bundle.insert", "undefined"
minecraft:render_offsets	JSON Object	Render offsets component: optional values can be given to offset the way the item is rendered. Experimental toggles required: Holiday Creator Features main_hand Main hand transform data. Type: main_hand off_hand Offhand hand transform data. Type: off_hand
minecraft:repairable	JSON Object	Repairable item component: how much damage can this item repair, what items can repair it. Experimental toggles required: Holiday Creator Features on_repaired Event that is called when this item has been repaired. Type: on_repaired repair_items Repair item entries. Type: array of repair_items
minecraft:shooter	JSON Object	Shooter Item Component. Experimental toggles required: Holiday Creator Features ammunition Ammunition. Type: array of ammunition charge_on_draw Charge on draw? Default is set to false. Type: boolean launch_power_scale Launch power scale. Default is set to 1.0. Type: float max_draw_duration Draw Duration. Default is set to 0. Type: max_draw_duration max_launch_power Launch power. Default is set to 1.0. Type: float scale_power_by_draw_duration Scale power by draw duration? Default is set to false. Type: boolean
minecraft:throwable	JSON Object	Throwable item component. Throwable items, such as a snowball. Experimental toggles required: Holiday Creator Features do_swing_animation Whether the item should use the swing animation when thrown. Default is set to false. Type: boolean launch_power_scale The scale at which the power of the throw increases. Default is set to 1.0. Type: float max_draw_duration The maximum duration to draw a throwable item. Default is set to 0.0. Type: float max_launch_power The maximum power to launch the throwable item. Default is set to 1.0. Type: float min_draw_duration The minimum duration to draw a throwable item. Default is set to 0.0. Type: float scale_power_by_draw_duration Whether or not the power of the throw increases with duration charged. Default is set to false. Type: boolean
minecraft:weapon	JSON Object	Weapon Item Component. Added to every weapon item such as axe, sword, trident, bow, crossbow. Experimental toggles required: Holiday Creator Features on_hit_block Trigger for letting you know when this item is used to hit a block Type: on_hit_block on_hurt_entity Trigger for letting you know when this item is used to hurt another mob Type: on_hurt_entity on_not_hurt_entity Trigger for letting you know when this item hit another actor, but didn't do damage Type: on_not_hurt_entity
minecraft:wearable	JSON Object	Wearable item component. Experimental toggles required: Holiday Creator Features 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, slot.equippable Accepted values: "slot.weapon.mainhand", "none", "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", "slot.equippable"

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

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.

Code Example

Example

{
  "format_version": "1.16.1",
  "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"
      }
    }
  }
}

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

ITEM DOCUMENTATION Version: 1.19.40.2

Index#

Items#

Item Components#

protection#

texture_type#

block#

use_on#

movement_modifier#

on_complete#

category#

duration#

destroy_speeds#

on_dig#

use_efficiency#

value#

damage_chance#

max_durability#

color#

dispense_on#

entity#

use_on#

can_always_eat#

nutrition#

on_consume#

saturation_modifier#

using_converts_to#

duration#

legacy_id#

texture#

capacity#

protection#

on_use#

on_use_on#

minimum_critical_power#

projectile_entity#

comparator_signal#

duration#

sound_event#

main_hand#

off_hand#

on_repaired#

repair_items#

ammunition#

charge_on_draw#

launch_power_scale#

max_draw_duration#

max_launch_power#

scale_power_by_draw_duration#

do_swing_animation#

launch_power_scale#

max_draw_duration#

max_launch_power#

min_draw_duration#

scale_power_by_draw_duration#

on_hit_block#

on_hurt_entity#

on_not_hurt_entity#

slot#

Item Definition Properties#

format_version#

Code Example

Item Description Properties#

ITEM DOCUMENTATION
Version: 1.19.40.2

Index

Items

Item Components

protection

texture_type

block

use_on

movement_modifier

on_complete

category

duration

destroy_speeds

on_dig

use_efficiency

value

damage_chance

max_durability

color

dispense_on

entity

use_on

can_always_eat

nutrition

on_consume

saturation_modifier

using_converts_to

duration

legacy_id

texture

capacity

protection

on_use

on_use_on

minimum_critical_power

projectile_entity

comparator_signal

duration

sound_event

main_hand

off_hand

on_repaired

repair_items

ammunition

charge_on_draw

launch_power_scale

max_draw_duration

max_launch_power

scale_power_by_draw_duration

do_swing_animation

launch_power_scale

max_draw_duration

max_launch_power

min_draw_duration

scale_power_by_draw_duration

on_hit_block

on_hurt_entity

on_not_hurt_entity

slot

Item Definition Properties

format_version

Item Description Properties