mcutils:tool

Deals damage to the item when you break a block or hit an entity.

Registering

Before you can use this component you need to register it.

import { system } from "@minecraft/server";
import { ToolComponent } from "@lpsmods/mc-utils";

system.beforeEvents.startup.subscribe((event) => {
  event.blockComponentRegistry.registerCustomComponent(ToolComponent.typeId, new ToolComponent());
});

Component

Options

Name	Type	Default	Description
damage_when_mined	boolean	false
damage_when_hit	boolean	false

Examples

Pickaxe

{
  "format_version": "1.21.100",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:custom_pickaxe"
    },
    "components": {
      "mcutils:tool": {
        "damage_when_mined": true
      }
    }
  }
}

Sword

{
  "format_version": "1.21.100",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:custom_sword"
    },
    "components": {
      "mcutils:tool": {
        "damage_when_hit": true
      }
    }
  }
}