Minecraft Commands Guide: How to use damage and unbreakable components for durability

     Minecraft gear just got smarter. In Minecraft 1.21+, you can fine-tune how long your items last and how they behave through a set of powerful item components. Want to give a tool some wear and tear straight out of the box? Or create legendary weapons that never break no matter how hard you swing them? With components like damage, max_damage, and unbreakable, you can precisely define an item’s lifespan - or make it eternal.

 

 

 

How item durability works in Minecraft

 

Durability is how Minecraft measures an item’s lifespan. When you swing a sword, mine a block, or take damage in armor, the item loses durability. Once it reaches its limit, the item breaks. With components, you can now directly control that system  -  not just through gameplay, but through commands and item design.

 

 

Using the damage component

 

     The damage component tells the game how used an item already is. The value is how many points of durability have already been lost, not how many are left. It must be a non-negative integer.

 

     Want a sword that’s seen better days? Give it some damage!

 

     /give @p diamond_sword[damage=500]

 

     This gives you a diamond sword with 500 durability lost. If it reaches the item’s max durability, it breaks just like normal.

 

 

     Pseudo-format:

 

 

- <item>  -  any item that supports durability (tools, weapons, armor)

 

- <int>  -  non-negative number (e.g. 0, 10, 500)

 

 

Using the max_damage component

 

     The max_damage component sets how many times the item can be used before breaking. This value must be a positive integer. It defines the maximum durability. Combined with damage, this shows a visible durability bar.

 

     Want a fragile pickaxe that only lasts four uses?

 

     /give @p diamond_pickaxe[max_damage=4]

 

     Now every swing counts. You can also combine it with damage=0 to show the durability bar even when the item is new.

 

     Pseudo-format:

 

 

- <int>  -  positive integer

 

     - Cannot be used together with max_stack_size unless it's 1

 

 

Using the unbreakable component

 

     The unbreakable component makes an item completely immune to durability loss. No matter how much you use it, it never breaks. This is great for special weapons, story items, or challenge rewards that should last forever.

 

     /give @p netherite_sword[unbreakable={}]

 

This sword will never wear down. It still works like a normal sword  -  it just doesn’t take damage.

 

 

     Pseudo-format:

 

 

- No values are needed inside the braces -  the presence of the tag is enough

 

 

Combining components for full control

 

     You can use all three components together to make unique durability behavior. For example, a sword that’s almost broken but can never break completely:

 

     /give @p iron_sword[damage=113, max_damage=115, unbreakable={}]

 

     The sword shows as almost broken, but it will never disappear. Great for cursed weapons or dramatic visuals.

 

 

     With the damage, max_damage, and unbreakable components, you can shape your gear’s lifespan in powerful new ways. Make items fragile, eternal, worn-in, or pristine — it’s all in your hands. These tools let you balance survival, storytelling, and strategy with precision, giving Minecraft items real personality and purpose.