Configures an item as a digging tool, allowing it to break specific blocks faster than normal. Define which blocks are affected and the speed multiplier for each.
Item Digger Properties
| Name | Default Value | Type | Description |
|---|---|---|---|
| destroy_speeds | [] | Array of Destroy Speeds items | An array of objects that define which blocks this item can dig and at what speed. Each entry specifies a block (by ID or tag query) and a speed multiplier. |
| use_efficiency | false | Boolean true/false | When true, the Efficiency enchantment will increase the dig speed of this item. Default is false. |
Item BlockInfo
Associates a block type with a custom digging speed multiplier for the minecraft:digger component. Map blocks to speed values so pickaxes mine stone quickly, axes chop wood faster, and custom tools excel at specific materials. Enables tool specialization matching vanilla Minecraft conventions.
Item BlockInfo Properties
JSON path: destroy_speeds
| Name | Default Value | Type | Description |
|---|---|---|---|
| block (Block) | not set | Block item | Block to be dug. |
| block (as String) | not set | String | |
| block (Alternate 2) | not set | Object | |
| speed | not set | Integer number | Digging speed for the correlating block(s). |
Block
Block Properties
JSON path: destroy_speeds > block
| Name | Default Value | Type | Description |
|---|---|---|---|
| name | String | ||
| states | {} | Integer number | |
| states (as String) | not set | String | |
| states (as Boolean true/false) | not set | Boolean true/false | |
| tags | String |
Samples
"minecraft:digger": {
"minecraft:digger": {
"use_efficiency": true,
"destroy_speeds": [
{
"speed": 6,
"block": {
"tags": "query.any_tag( 'wood' )"
}
},
{
"block": "minecraft:coal_ore",
"speed": 2
}
]
}
}