Custom Tools

A custom tool is a normal EcoItem with the vanilla tool component that controls mining: you set its mining speed, durability cost, and per-block rules. This page covers adding that tool behaviour on top of a standard item.

Quick start

1. Open the /plugins/EcoItems/items/ folder.

2. Copy _example_tool.yml and rename it to your tool's ID, e.g. hardened_netherite_pickaxe.yml.

3. Set up the item: section as you would for any item (see How to make an Item).

4. Add the minecraft:tool component with the mining speed and any block rules.

5. Run /ecoitems reload.

6. Give yourself the item with /ecoitems give <you> hardened_netherite_pickaxe and mine a block to confirm the speed and drops behave as set.

Naming and IDs

Tools live in the same items/ folder as every other EcoItem, so the file name without .yml is the item's ID, used in commands and in the Item Lookup System.

The structure of a tool

# === Item: a normal EcoItem ===
item:
  item: netherite_pickaxe glint max_damage:4096 item_name:"Hardened Netherite Pickaxe" # The base item
  lore: [] # The item lore

  # === The mining behaviour, as a vanilla component ===
  components:
    # Read here: https://minecraft.wiki/w/Data_component_format#tool
    "minecraft:tool":
      default_mining_speed: 1.0 # Mining speed used when no rule matches
      damage_per_block: 1 # Durability removed each time a block is mined
      rules: # Optional; per-block overrides, first match wins
        - blocks: "#minecraft:mineable/pickaxe" # A block, list of blocks, or #tag
          speed: 45.8 # Mining speed for these blocks
          correct_for_drops: true # If these blocks drop items with this tool
        - blocks: "#minecraft:incorrect_for_netherite_tool"
          speed: 1.0
          correct_for_drops: false

  recipes:
    recipe:
      - netherite_ingot
      - netherite_ingot
      - netherite_ingot
      - netherite_ingot
      - netherite_pickaxe
      - netherite_ingot
      - netherite_ingot
      - netherite_ingot
      - netherite_ingot

Item

The item: section is exactly the same as any other EcoItem. See How to make an Item for the full breakdown of the base item, display, and recipe fields. A tool is still a full EcoItem, so the top-level effects: and conditions: work too, e.g. running an effect on a mine_block trigger alongside the mining rules.

The component

minecraft:tool is the vanilla component that controls mining - the same one vanilla tools use, with every field documented in the Data component format. Block lists accept block IDs or block tags; tags start with # and use vanilla tag names like #minecraft:mineable/pickaxe.

Where to go next

• The base item: How to make an Item for the shared item, display, and recipe fields.

• Custom foods: Custom Foods for eating behaviour instead of mining.