Data-driven durability consumption for custom items

Custom items with the minecraft:durability component should have a data-driven way to specify when durability is consumed.

Currently, custom tools can define durability, mining speed, damage, tags, and other properties, but reproducing the basic durability behavior of vanilla tools often requires Script API.

It would be useful to support durability consumption for actions such as:

• Successfully breaking a block
• Successfully hitting an entity
• Performing a tool interaction, such as tilling soil, creating a dirt path, stripping a log, scraping a block, or similar vanilla tool actions

For example, a component could allow creators to define something conceptually like:

"minecraft:durability_usage": {
  "block_break": 1,
  "entity_hit": 1,
  "tool_action": 1
}

The exact schema does not need to look like this, but the important part is allowing these standard tool behaviors to be defined entirely through item JSON.

This would make custom tools behave much more consistently with vanilla tools, reduce unnecessary Script API usage, and make simple Add-Ons easier to create and maintain.This post was generated with the help of AI. Please forgive any awkward wording or phrasing.