Link Search Menu Expand Document

Items [BETA]

Table of contents
  1. Items [BETA]
    1. Item Events
      1. Using Events
      2. Event Functions
        1. swing
        2. shoot
        3. damage
        4. decrement_stack
        5. add_mob_effect
        6. remove_mob_effect
        7. transform_item
        8. teleport
        9. sequence
        10. randomize
        11. run_command
    2. BP Item Components
      1. Enchant slots
    3. Item Tags
    4. Breaking changes

Better documentation on the new item format introduced in the 1.16.100.56 Minecraft beta

Item Events

Using Events

{
    "format_version": "1.16.100",
    "minecraft:item": {
        "description": {
            "identifier": "example:food_item",
            "category" : "items"
        },
        "components": {
            "minecraft:use_duration": 1.6,
            "minecraft:food": {
                "nutrition": 4,
                "saturation_modifier": "low",
                "can_always_eat": true,
                "on_consume": {
                    "event": "on_consume",
                    "target": "self"
                }      
            }
        },
        "events": {
            "on_consume": {
                "remove_mob_effect": {
                "effect": "nausea",
                "target": "holder"
                }
            }
        }
    }
}

Event Functions

swing

{
    "example:swing_event": {
        "swing": {}
    }
}

shoot

Shoots a projectile when triggered

{
    "example:shoot_event": {
        "shoot": {
            "projectile": "minecraft:snowball",
            "launch_power": 5,
            "angle_offset": 20
        },
    }
}

damage

{
    "example:damage_event": {
        "damage": {
            "type": "magic",
            "amount": 4
        }
    }
}

decrement_stack

Decrements the stack

{
	"example:remove_one": {
		"decrement_stack": {}
	}
}

add_mob_effect

Adds a mob effect when triggered

{
    "example:effect_event": {
        "add_mob_effect": {
            "effect": "poison",
            "target": "holder",
            "duration": 8,
            "amplifier": 3
        }
    }
}

remove_mob_effect

Removes a mob effect when triggered

{
    "example:remove_effect_event": {
        "remove_mob_effect": {
            "effect": "poison",
            "target": "holder"
        }
    }
}

transform_item

Transforms the item into the item specified

{
    "example:transform_event": {
        "transform_item": {
            "transform": "minecraft:apple"
        }
    }
}

teleport

Teleports the target to a random location in the specified range

{
    "example:teleport_event": {
        "teleport": {
            "target": "holder",
            "max_range": [8, 8, 8]
        }
    }
}

sequence

Used to sequence event functions

{
	"example:sequence_event": {
		"sequence": [
			{
				"add_mob_effect": {
                    "effect": "poison",
                    "target": "holder",
                    "duration": 8,
                    "amplifier": 3
                }
			},
			{
				"transform_item": {
                    "transform": "minecraft:apple"
                }
			}
		]
	}
}

randomize

Used to randomize event functions

{
   "example:randomize_events": {
        "randomize": [
            {
                "weight": 1,
				"transform_item": {
                    "transform": "minecraft:apple"
                }
            },
            {
                "weight": 2,
                "add_mob_effect": {
                    "effect": "weakness",
                    "target": "holder",
                    "duration": 8,
                    "amplifier": 3
                }
            },
        ]
    } 
}

run_command

Used to execute commands

{
    "example:execute_command_event": {
        "run_command": {
            "command": ["say hi"],
            "target": "other"
        }
    }
}

BP Item Components

List of all new block components, with usage examples

  • minecraft:ignores_permission
    {
      "minecraft:ignores_permission": true
    }
    
  • minecraft:mining_speed
    {
      "minecraft:mining_speed": 1
    }
    
  • minecraft:damage
    {
      "minecraft:damage": true
    }
    
  • minecraft:can_destroy_in_creative
    {
      "minecraft:can_destroy_in_creative": true
    }
    
  • minecraft:dye_powder
    {
      "minecraft:dye_powder": {
          "color": 4
      }
    }
    
  • minecraft:mirrored_art
    {
      "minecraft:mirrord_art": true
    }
    
  • minecraft:explodable
    {
      "minecraft:explodable": true
    }
    
  • minecraft:should_despawn
    {
      "minecraft:should_despawn": true
    }
    
  • minecraft:liquid_clipped
    {
      "minecraft:liquid_clipped": true
    }
    
  • minecraft:allow_off_hand
    {
      "minecraft:allow_off_hand": true
    }
    
  • minecraft:projectile
    {
      "minecraft:projectile": {
          "projectile_entity": "minecraft:arrow",
          "minimum_critical_power": 0.5
      }
    }
    
  • minecraft:block_placer
    {
      "minecraft:block_placer": {
        "block": "minecraft:grass",
        "use_block_description": true
      }
    }
    
  • minecraft:entity_placer
    {
      "minecraft:entity_placer": {
        "entity": "minecraft:zombie",
        "use_on": [
            "minecraft:grass",
            "minecraft:sand"
          ],
          "dispense_on": [
              "minecraft:stone",
              "minecraft:gold_ore"
          ]
      }
    }
    
  • minecraft:on_use_on
    {
      "minecraft:on_use_on": {
          "on_use_on": {
              "event": "example:block_event",
              "target": "block"
          }
      }
    }
    
  • minecraft:on_use
    {
      "minecraft:on_use": {
          "on_use": {
              "event": "example:item_event",
              "target": "self"
          }
      }
    }
    
  • minecraft:knockback_resistance
    {
      "minecraft:knockback_resistance": {
        "protection": 0.4
      }
    }
    
  • minecraft:enchantable
    {
      "minecraft:enchantable": {
        "slot": "bow",     // Can be any of the enchant slot listed below
        "value": 10
      }
    }
    

Enchant slots

Slot Name
bow
armor_feet
armor_torso
armor_head
armor_legs
hoe
axe
pickaxe
shovel
sword
elytra
fishing_rod
flintsteel
shears
cosmetic_head
  • minecraft:shooter
    {
      "minecraft:shooter": {
          "max_draw_duration": 1,
          "charge_on_draw": false,
          "scale_power_by_draw_duration": true,
          "ammunition": [
              {
                  "item": "minecraft:arrow",
                  "use_offhand": true,
                  "search_inventory": true,
                  "use_in_creative": true
              }
          ]
      }
    }
    
  • minecraft:durability
    {
      "minecraft:durability": {
          "max_durability": 100,
          "damage_chance": {
              "min": 5,
              "max": 10
          }
      }
    }
    
  • minecraft:armor
    {
      "minecraft:armor": {
          "protection": 4
      }
    }
    
  • minecraft:wearable
    {
      "minecraft:wearable": {
          "slot": "slot.armor.feet"
      }
    }
    
  • minecraft:weapon
    {
      "minecraft:weapon": {
          "on_hurt_entity": {
              "event": "example_event",
              "target": "holder"      // Can also be 'self' to trigger an item event"
          }
      }
    }
    
  • minecraft:record
    {
      "minecraft:record": {
          "sound_event": "cat",
          "duration": 120,
          "comparator_signal": 8
      }
    }
    
  • minecraft:repairable
    {
      "minecraft:repairable": {
          "repair_items": [
              {
                  "items":[
                      "minecraft:iron_ingot",
                      "minecraft:gold_ingot"
                  ],
                  "repair_amount": 10,  // Can also be molang expression
                  "on_repaired": {
                      "event": "example_event",
                      "target": "holder"    // Can also be 'self' to trigger an item event"
                  }
              }
          ]
      }
    }
    
  • minecraft:cooldown
    {
      "minecraft:cooldown": {
          "category": "ender_pearl",
          "duration": 1
      }
    }
    
  • minecraft:digger
    {
      "minecraft:digger": {
          "use_efficiency": true,
          "destroy_speeds": [
              {
                  "block": {
                      "tags": "query.any_tag('stone', 'metal')"
                  },
                  "speed": 6
              }
          ]
      }
    }
    
  • minecraft:fertilizer
    {
      "minecraft:fertilizer": {
          "type": "bonemeal" // Can also be "rapid"
      }
    }
    
  • minecraft:fuel
    {
      "minecraft:fuel": {
          "duration": 20
      }
    }
    
  • minecraft:throwable
    {
      "minecraft:throwable": {
          "do_swing_animation": true,
          "max_draw_duration": 2,
          "scale_power_by_draw_duration": true
      }
    }
    
  • minecraft:creative_category
    {
      "minecraft:creative_category": {
          "parent": "itemGroup.name.nature"
      }
    }
    
  • minecraft:food New Syntax
    {
      "minecraft:food": {
          "on_consume": {
              "event": "example_event",
              "target": "holder"  // Can also be 'self' to trigger an item event"
          },
          "nurtition": 3,
          "can_always_eat": true,
          "saturation_modifier": "normal"
      }
    }
    

Item Tags

Item tags work the same as block tags and can be applied like this:

{
  	"format_version": "1.16.100",
  	"minecraft:item": {
		"description": {
	  		"identifier": "example:my_item",
		},
		"components": {
	  		"tag:example:my_tag": {}
		}
  	}
}

They can then be queried with:

  • query.any_tag
  • query.all_tags
  • query.equipped_item_all_tags
  • query.equipped_item_any_tag

Breaking changes

If your item isn’t showing up in the beta, these changes might have broken your item.

  • Item behavior files now require a “category” to show up in the /give command and creative inventory. Example:
    {
      "format_version": "1.16.100",
      "minecraft:item": {
          "description": {
              "identifier": "example:item",
              "category" : "items"     // This line is required
          },
          "components": {...},
          "events": {...}
      }
    }
    
  • RP item files are no longer used, minecraft:icon and all other RP components should be used in the BP item file.