Modscraper Modscraper Minecraft
Tool Switcher logo

Tool Switcher

Mod

Automatically switches to the correct tool when breaking blocks.

Type

Mod

Modrinth Downloads

23,118

Modrinth ID

3CTNwVgW

Last Updated

May 27, 2026

Description

Tool Switcher

modrinth curseforge codeberg

Tool Switcher is a simple utility mod that enables you to automatically switch tools depending on what block you are trying to break.

Features

  • Automatically selects the optimal tool for mining, taking into account factors such as efficiency.
  • Switches to tools outside the hotbar by temporarily swapping them into your current slot.
  • Disables itself while you are sneaking, if enabled.
  • Optionally prevents switching if the current tool has Silk Touch or Fortune.
  • Fully customizable list of disabled blocks and tools.

Config

All configuration options can be edited in the config file at config/tool-switcher.toml or through Mod Menu & McQoy (recommended).

General Settings

Option Type Default Description enabled true/false true Enable/disable the mod. Can be toggled with a keybind (default: Period). showMessage true/false true Whether to show a message on the screen when keybind is pressed.

Behavior Settings

Option Type Default Description sneaking true/false true Whether Tool Switcher turns off while sneaking. goBack true/false true Whether to restore the previous tool/slot after releasing the attack key. respectSilkFortune true/false true Whether to not switch tools if you are holding a silk touch/fortune tool.

Filter Settings

Option Type Default Description disabledTools String Array [] Tools that don't get switched to. disabledBlocks String Array [] Blocks that don't trigger tool switching.

Tools and blocks must be specified using Minecraft's resource location format in the TOML array syntax.

Example config file (config/tool-switcher.toml):

# Enable or disable the mod. Can be toggled with a keybind. enabled = true # Whether Tool Switcher turns off while sneaking sneaking = true # Whether to show a message on the screen when keybind is pressed showMessage = true # Whether to restore the previous tool/slot after releasing the attack key goBack = true # Whether to not switch tools if you are holding a Silk Touch or Fortune Tool respectSilkFortune = true # Tools that don't get switched to disabledTools = [ "minecraft:wooden_pickaxe", "minecraft:wooden_shovel", "minecraft:golden_pickaxe" ] # Blocks that don't trigger tool switcher disabledBlocks = [ "minecraft:diamond_block", "minecraft:emerald_ore", "minecraft:ancient_debris" ]

Format:

  • Each entry must be in quotes
  • Entries are separated by commas
  • Use Minecraft's resource location format: "namespace:id"
  • Works with modded items: "create:wrench", "botania:mana_tablet"

Common Tool IDs:

  • minecraft:wooden_pickaxe, minecraft:stone_pickaxe, minecraft:iron_pickaxe
  • minecraft:wooden_shovel, minecraft:stone_shovel, minecraft:iron_shovel
  • minecraft:wooden_axe, minecraft:stone_axe, minecraft:iron_axe
  • minecraft:golden_pickaxe, minecraft:golden_shovel, minecraft:golden_axe

Common Block IDs:

  • minecraft:diamond_ore, minecraft:deepslate_diamond_ore
  • minecraft:ancient_debris, minecraft:gilded_blackstone
  • minecraft:spawner, minecraft:end_portal_frame

How It Works

Hotbar Tools: If the best tool is in your hotbar, Tool Switcher selects that slot.

Inventory Tools: If the best tool is outside your hotbar, Tool Switcher temporarily swaps it into your current slot. When you release the attack key (or finish mining), it swaps back automatically (if goBack is enabled).

Compatibility

Mod Loaders

Fabric

Game Versions

1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 +14 more

Similar Mods

External Resources