Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Mining Levels ======

==== Introduction ====
The way mining levels and preferred tools are assigned has changed significantly in 1.17. Making your tools and blocks interact properly now requires adding them to specific tags.

==== Setting the preferred tool for your block ====

To define what tool is used to harvest your block, you need to add the block's identifier to a tag inside of ''tags/blocks/mineable'' that corresponds to your tool ("''pickaxe.json''","''axe.json''", etc.):
<code JavaScript /src/main/resources/data/minecraft/tags/blocks/mineable/pickaxe.json>
{
  "replace": false,
  "values": [
    "tutorial:example_ore_block",
    "tutorial:example_cobblestone_block"
  ]
}
</code>

Fabric API also provides two additional tags ''fabric:mineable/sword'' and ''fabric:mineable/shears'' for blocks that can be harvested with a sword or shears. You put these tags in ''resources/data/fabric/tags/blocks/mineable/''.

==== Setting the block's mining level ====

To add a mining level requirement to your block that is under netherite, you'll need to add it to one of these three tags inside tags/blocks:
<code>
Stone or higher -> needs_stone_tool.json
Iron or higher -> needs_iron_tool.json
Diamond or higher -> needs_diamond_tool.json
</code>

Here we make our late-game ore variants require a diamond tool to harvest:
<code JavaScript /src/main/resources/data/minecraft/tags/blocks/needs_diamond_tool.json>
{
  "replace": false,
  "values": [
    "tutorial:example_late_game_ore",
    "tutorial:example_late_game_deepslate_ore"
  ]
}
</code>

Fabric API provides dynamic tags for mining levels above diamond, as well as for wood (mining level 0). Dynamic mining level tags are in the format ''fabric:needs_tool_level_N'', where ''N'' is the wanted tool level as an integer. For example, a mining level tag for netherite (mining level 4) would be ''fabric:needs_tool_level_4''. Dynamic tags are checked automatically. You put these tags in ''resources/fabric/tags/blocks/''.
<code JavaScript /src/main/resources/data/fabric/tags/blocks/needs_tool_level_4.json>
{
  "replace": false,
  "values": [
    "tutorial:example_tough_block",
    "tutorial:example_netherite_anvil_block"
  ]
}
</code>

The default mining level of blocks not modified with mining level tags is -1 (the hand mining level).

==== Tool Tags ====
You will need to add your tool into the fabric tool tags to support modded blocks.

Example of adding a pickaxe to the ''pickaxes'' tag:

<code javascript /src/main/resources/data/fabric/tags/items/pickaxes.json>
{
  "replace": false,
  "values": [
    "tutorial:example_pickaxe"
  ]
}
</code>