Bedrock Wiki
  • Discord
  • Contribute
  • bedrock.dev
  • MS Learn
Beginner's Guide
  • Guide
    • 1. Introduction
      guide
    • 2. Add-Ons Explained
    • 3. Software & Preparation
    • 4. Project Setup
    • 5. Create a Custom Item
    • 6. Create a Custom Entity
    • 7. Blockbench: Modeling, Texturing & Animating
    • 8. Adding a Loot Table, Spawn Rule & Crafting Recipe
  • Extra
    • a. Understanding JSON
    • b. Download Example Packs
    • c. Troubleshooting
      help
    • d. Advanced Manifest
    • e. Format Versions
    • f. Project Setup Android
Animation Controllers
  • Intro to Animation Controllers
    guide
  • Entity Commands
  • AFK Detector
  • Death Commands
  • Molang into Scoreboard
  • Respawn Commands
Blocks
  • General
    • Intro to Blocks
      guide
    • Block Components
    • Block Tags
    • Block States
    • Block Traits
    • Block Permutations
    • Block Events
      Scripts
    • Block Event Migration
      help
    • Blocks as Items
    • Troubleshooting Blocks
      help
  • Visuals
    • Block Culling
    • Block Models
      guide
    • Block Texture Animation
    • Block Texture Variation
    • Block Tinting
  • Tutorials
    • Applying Constant Effects
      Scripts
    • Avoiding State Limit
    • Fake Blocks
    • Ore Loot Tables
      Scripts
    • Precise Interaction
      Scripts
    • Precise Rotation
      Scripts
    • Rotatable Blocks
  • Vanilla Re-Creations
    • Custom Crops
      Scripts
    • Custom Glass
    • Custom Glazed Terracotta
    • Custom Trapdoors
      Scripts
  • Documentation
    • Block Format History
    • Block Shapes
    • Block Sounds
    • Vanilla Block Models
Commands
  • General
    • Intro to Command Blocks
    • Functions
    • Block States
    • Coordinate System
    • NBT Commands
    • Scoreboard Operations
    • Understanding Selectors
  • Commands
    • Damage
    • Execute
    • Playanimation
    • Playsound
  • On Event Systems
    • On Player First Join
    • On Player Join
    • On Player Leave
    • On Player Death
    • On Player Respawn
    • On First World Load
  • Scoreboard Systems
    • Entity Counter
    • Scoreboard Timers
    • Comparing And Retrieving Scores
  • Techniques
    • Execute Logic Gates
    • MBE - Max's Block Entity
    • FMBE - A New Way to Create Display Entities
    • Look Detection
    • Movement Detections
    • Orbital Camera
  • Useful Creations
    • Custom Crafter
    • Multiplayer Position Rearrangement
      function
Concepts
  • contents.json
  • Emojis & Symbols
  • Molang
  • Namespaces
  • Overwriting Assets
  • Raw Text
  • Shaders
  • Sounds
  • Subpacks
  • Text and Localization
  • Texture Atlases
  • textures_list.json
Documentation
  • Shared Constructs
  • Advanced Molang
  • File Types
  • Fog IDs
  • Material Configuration Description
  • Menu Categories
  • Molang Queries
  • Pack Folder Structure
  • Sound Definitions
  • Vanilla Materials
Entities
  • General
    • Intro to Entities BP
      guide
    • Intro to Entities RP
      guide
    • Troubleshooting Entities
      help
    • Entity Events
    • Entity Properties
    • NPC Dialogues
    • Render Controllers
    • Spawn Rules
  • Tutorials
    • Convert Points Between Any Space (World, Entity, Bones)
    • Creating Boats
    • Detecting Other Entities
    • Disabling Team Damage
    • Dummy Entities
    • Entity Attacks
    • Entity Holds Item
    • Entity Movement
    • Entity Timers
    • Flying Entities
    • Introduction to AOE Clouds
    • Invulnerable Entities
    • Look at Entity
    • Sleeping Entities
    • Solid Entities
    • Spawning Tamed Entities
      Scripts
    • Village Mechanic
  • Documentation
    • Dummy Components
    • Non-Mob Runtime Identifiers
    • Projectiles
    • Runtime Identifiers
    • Vanilla Usage Components
    • Vanilla Usage Spawn Rules
Items
  • General
    • Intro to Items
      guide
    • Item Components
    • Item Tags
    • Item Events
      Scripts
    • Item Event Migration
      help
    • Troubleshooting Items
      help
  • Tutorials
    • Custom Armor
    • Custom Food
      Scripts
    • Custom Pottery Sherds
    • Custom Weapons
    • Equipment-Based Commands
    • High Resolution Items
    • Spawning Items
    • Throwable Items
  • Documentation
    • Enchantments
    • Attachables
    • Item Format History
    • Numerical Item IDs
    • Vanilla Item Identifiers
    • Vanilla Usage Components
JSON UI
  • General
    • Intro to JSON UI
      guide
    • Best Practices
      guide
  • Tutorials
    • Adding HUD Elements
    • Aseprite Animations
    • Buttons and Toggles
    • Modifying Server Forms
    • Preserve Title Texts
    • String to Number
  • Documentation
    • JSON UI Documentation
Loot, Recipes & Trading
  • General
    • Trading Behavior
  • Documentation
    • Loot Tables
    • Trade Tables
    • Recipes
    • Item Functions
  • Tutorials
    • Randomized Structure Loot
Meta
  • Add-On Performance
  • Style Guide
  • Useful Links
  • Using Schemas
  • Version Control
  • Q&A
    • Blocks and Items Q&A 2024/08/30
    • Deferred Technical Preview Q&A 2024/02/23
    • GameTest Q&A 2021/08/06
    • Scripting and Editor Q&A 2023/09/22
    • World Generation Q&A 2024/11/15
NBT
  • General
    • .mcstructure
  • Tutorials
    • Experiments in Education Edition
    • Extending Structure Limits
  • NBT in Depth
    • About NBT (Named Binary Tag)
    • NBT Libraries
    • Reading NBT Example
Particles
  • General
    • Intro to Particles
      guide
  • Tutorials
    • Disabling Particles
  • Documentation
    • Vanilla Particles
Scripting
  • General
    • Intro to Scripting
    • What is Script API?
    • API Modules
  • Tutorials
    • Block Placement Prevention
    • GameTests
    • Script Core Features
    • Script Forms
    • Script Requests API
    • Simple Chat Commands
  • Documentation
    • Engine Environment
    • Script Resources
    • Script Watchdog
    • Troubleshooting JavaScript
    • TypeScript
Servers
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet Protocol
    • RakNet Protocol
Visuals
  • General
    • Introduction to Entity Visuals
      guide
    • Bedrock Modeling
    • Custom Death Animations
    • Effects in Animations
    • Material Creations
    • Materials
    • Math-Based Animations
    • Skin Packs
  • Tutorials
    • Entity Texture Animation
    • Glowing Entity Texture
    • Hurt Animations
    • Leash Position
    • Player Geometry
    • Remove Entity Shadows
    • Retexturing Spawn Eggs
  • Ideas
    • Structure Presentation
World Generation
  • General
    • Intro to World Generation
      guide
    • Biomes
      guide
    • Feature Types
  • Tutorials
    • Block Conditions for Features
    • Generating Custom Ores
    • Generating Custom Structures
    • Generating Patches
    • Heightmap Noise
  • Documentation
    • Biome Tags

Item Format History

Contents
Item Format History
  • 1.21.90
  • 1.21.80
  • 1.21.60
  • 1.21.50
  • 1.21.40
  • 1.21.30
  • 1.21.20
  • 1.21.10
  • 1.21.0
  • 1.20.60
  • 1.20.50
  • 1.20.40
  • 1.20.30
  • 1.20.10
  • 1.20.0

Versioned
CHANGES

The file's format_version field must be updated for versioned changes to take effect.

experimental
CHANGES

An experiment must be enabled in your world for experimental changes to take effect.

1.21.90 ​

Components ​

Versioned
  • Removed minecraft:custom_components

    • Custom components should now be applied in the same way as vanilla components, as entries in the components object:

      minecraft:block
      json
      "components": {
          "minecraft:glint": true,
          "wiki:custom_component": {
              "parameter": "value"
          }
      }
      1
      2
      3
      4
      5
      6

1.21.80 ​

Components ​

experimental
Custom Components V2
Versioned
  • Removed minecraft:custom_components
    • Custom components should now be applied in the same way as vanilla components, as entries in the components object.

1.21.60 ​

Description ​

Versioned
  • Updated menu_category
    • Updated group parameter to require a namespace e.g. minecraft:itemGroup.name.concrete

Components ​

Versioned
  • Added minecraft:storage_weight_limit
    • Determines the maximum allowed total weight of all items in the storage item container.
    • Replaces the max_weight_limit storage item parameter.
  • Added minecraft:storage_weight_modifier
    • Determines the additional weight the item adds when inside a storage item.
    • A value of 0 means that this item is not allowed inside a storage item.
    • Replaces the weight_in_storage_item storage item parameter.
  • Released minecraft:compostable from experimental
  • Updated minecraft:block_placer
    • Released replace_block_item parameter from experimental
  • Updated minecraft:storage_item
    • Removed max_weight_limit parameter
    • Removed weight_in_storage_item parameter

1.21.50 ​

Components ​

experimental
Upcoming Creator Features
  • Added minecraft:compostable
    • Allows this item to be used in a composter.
    • Contains composting_chance which determines how likely the compost level is to increase as a percentage (0-100).

1.21.40 ​

Versioned
  • Numbers can no longer be used to represent boolean values.
  • Floats can no longer be used to represent integer values.

Components ​

Versioned
  • Released minecraft:bundle_interaction from experimental
  • Released minecraft:storage_item from experimental
experimental
Upcoming Creator Features
  • Updated minecraft:block_placer
    • The specified block will now be used as the item's icon if the minecraft:icon component is not applied.
    • Added replace_block_item parameter which replaces the default item for the specified block with this item.
      • For this to function, the item and block identifiers must be the same.
      • Learn more about replacing block items here!

1.21.30 ​

Components ​

Versioned
  • Added minecraft:dyeable
    • Allows the item to be dyed by cauldron water.
    • Contains default_color which determines an optional color to use before the item is dyed.
    • Once dyed, the item will display the dyed texture defined in the minecraft:icon component rather than default.
  • Added minecraft:rarity
    • Defines the base rarity of the item (displayed by the color of the item name).
    • Accepts the following rarity levels: common, uncommon,rare and epic.
    • When an item is enchanted, its rarity will increase to the next level if possible.
    • This component has no functional effect and can be overrided with minecraft:hover_text_color.
experimental
Bundles
  • Added minecraft:bundle_interaction
    • Enables the bundle interface and functionality on the item.
    • Contains num_viewable_slots which
    • Requires the minecraft:storage_item component to be applied.
  • Added minecraft:storage_item
    • Allows this item to contain other items.
    • Contains allow_nesed_storage_items which determines whether other storage items can be placed into the container.
    • Contains allowed_items which defines the items that are exclusively allowed in the container.
      • If empty all items are allowed in the container.
    • Contains banned_items which defines the items that are not allowed in the container.
    • Contains max_slots which defines the number of slots in the container.
    • Contains max_weight_limit which defines the maximum allowed total weight of all items in the container.
    • Contains weight_in_storage_item which defines the additional weight the item adds when inside another storage item.
      • A value of 0 means that this item is not allowed inside another storage item.

1.21.20 ​

Components ​

Versioned
  • Added minecraft:damage_absorption
    • Causes the item to absorb damage that would otherwise be dealt to its wearer.
    • Contains absorbable_causes which determines a list of damage causes (such as entity_attack and magma) that can be absorbed by the item.
    • Requires the minecraft:durabilityandminecraft:wearable components.
  • Added minecraft:durability_sensor
    • Enables an item to emit effects when it receives damage.
    • Contains durability_thresholds which determines both the durability thresholds, and the effects emitted when each threshold is met.

1.21.10 ​

Components ​

Versioned
  • Released minecraft:custom_components from experimental

1.21.0 ​

experimental
Holiday Creator Features
Versioned
  • Removed events

Components ​

experimental
Beta APIs
  • Added minecraft:custom_components
    • Lists all the custom components that should be applied to this block.

Events ​

experimental
Holiday Creator Features
Versioned
  • Removed add_mob_effect response
  • Removed damage response
  • Removed decrement_stack response
  • Removed remove_mob_effect response
  • Removed run_command response
  • Removed teleport response
  • Removed transform_item response

1.20.60 ​

Components ​

Versioned
  • Updated minecraft:icon
    • Removed texture parameter
    • Added textures parameter which lists the different textures the item can use in its icon, including armor trims.
      • Contains default which replaces the texture parameter.

1.20.50 ​

Components ​

Versioned
  • Added minecraft:tags
    • Lists the tags applied to this item.
    • Replaces tag:* components.
  • Added minecraft:use_modifiers
    • Contains use_duration which determines the length (in seconds) of a complete item use.
      • Replaces the minecraft:use_duration component.
    • Contains movement_modifier which applies a multiplier to the holder's speed when the item is being used.
  • Removed minecraft:use_duration
  • Removed the ability to apply tags using tag:*
experimental
Holiday Creator Features
Versioned
  • Removed minecraft:chargeable
  • Updated minecraft:digger
    • Removed on_dig trigger parameter

1.20.40 ​

Components ​

Versioned
  • Updated minecraft:icon
    • Single string values can now be used once again e.g. "minecraft:icon": "stick".
experimental
Holiday Creator Features
Versioned
  • Removed minecraft:on_use trigger
  • Removed minecraft:on_use_on trigger
  • Removed minecraft:weapon

1.20.30 ​

Components ​

Versioned
  • Added minecraft:interact_button
    • Enable and set text on a button that is displayed when using touch controls.
    • If set to true, the button displays "Use Item".
  • Released minecraft:allow_off_hand from experimental
  • Released minecraft:damage from experimental
  • Released minecraft:digger from experimental
  • Released minecraft:enchantable from experimental
  • Released minecraft:food from experimental
  • Released minecraft:hand_equipped from experimental
  • Released minecraft:liquid_clipped from experimental
  • Released minecraft:should_despawn from experimental
  • Released minecraft:stacked_by_data from experimental
  • Released minecraft:use_animation from experimental
  • Released minecraft:use_duration from experimental

1.20.10 ​

Components ​

Versioned
  • Released minecraft:block_placer from experimental
  • Released minecraft:can_destroy_in_creative from experimental
  • Released minecraft:cooldown from experimental
  • Released minecraft:hover_text_color from experimental
  • Released minecraft:max_stack_size from experimental
  • Released minecraft:projectile from experimental
  • Released minecraft:record from experimental
  • Released minecraft:repairable from experimental
  • Released minecraft:shooter from experimental
  • Released minecraft:throwable from experimental
experimental
Holiday Creator Features
Versioned
  • Removed minecraft:render_offsets

1.20.0 ​

Components ​

Versioned
  • Released minecraft:display_name from experimental
  • Released minecraft:durability from experimental
  • Released minecraft:fuel from experimental
  • Released minecraft:entity_placer from experimental
  • Released minecraft:icon from experimental
experimental
Holiday Creator Features
Versioned
  • Removed minecraft:dye_powder
  • Updated minecraft:repairable
    • Removed on_repaired trigger parameter

UNDOCUMENTED

Format changes in versions prior to 1.20.0 haven't been listed yet.

Contributors

Edit Item Format History on GitHub

Text and image content on this page is licensed under the Creative Commons Attribution 4.0 International License

Code samples on this page are licensed under the MIT License

Bedrock Wiki by Bedrock OSS

"Minecraft" is a trademark of Mojang AB.

Bedrock OSS, Bedrock Wiki and bedrock.dev are not affiliated in any way with Microsoft or Mojang AB.

  • Privacy Policy
  • Join our Discord
  • Learn how to Contribute
  • Visit our Repository