Skip to content

Tool Switcher

Automatically switches to the correct tool when breaking blocks.

Fabric
Loaders
Fabric
Downloads on Modrinth
44.1K
Followers on Modrinth
40
versions
38
Updated
October 30, 2026Oct 30
Published
in 2025

At a glance

Runs on Fabric
For Minecraft 1.20–26.3
Client only — no need to install it on the server
Latest version — 3.2.6 from October 30, 2026
Requires Fabric API
License MIT — free
Where it's needed
In gamerequiredOn servernot needed

Install in the game only; not needed on the server

Game versions1.20–26.3

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 customisable list of disabled blocks and tools.
  • Server-side disabling, just install the mod onto the server to stop clients from using it on your server.

Config

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

General Settings
OptionTypeDefaultDescription
enabledtrue/falsetrueEnable/disable the mod. Can be toggled with a keybind (default: Period).
showMessagetrue/falsetrueWhether to show a message on the screen when keybind is pressed.
Behaviour Settings
OptionTypeDefaultDescription
sneakingtrue/falsetrueWhether Tool Switcher turns off while sneaking.
goBacktrue/falsetrueWhether to restore the previous tool/slot after releasing the attack key.
respectSilkFortunetrue/falsetrueWhether to not switch tools if you are holding a silk touch/fortune tool.
ignoreInventorytrue/falsefalseWhether to ignore tools in the inventory and only swap with hotbar ones.
delayInteger0Delay before swapping back or again after the block is finished breaking.
Filter Settings
OptionTypeDefaultDescription
disabledToolsModeString"BLACKLIST"How disabledTools is applied: BLACKLIST, WHITELIST, or DISABLED.
disabledToolsString Array[]Tools that don't get switched to. Supports tags prefixed with #.
disabledBlocksModeString"BLACKLIST"How disabledBlocks is applied: BLACKLIST, WHITELIST, or DISABLED.
disabledBlocksString Array[]Blocks that don't trigger a switch. Supports tags prefixed with #.
customBindingsTable{}Maps block IDs or tags to item IDs or tags to select a specific tool for a specific block.
How to Configure Filters

Tools and blocks must be specified using Minecraft's identifier 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 switch back to the slot you were on before mining
goBack = true
# Whether to not switch tools if you are holding a Silk Touch or Fortune Tool
respectSilkFortune = true
# Whether to ignore tools in the inventory and only swap with hotbar ones.
ignoreInventory = false
# Delay before swapping back/again after block break finished (in ticks (seconds*20))
delay = 0
# How the disabledTools field should function: BLACKLIST, WHITELIST, or DISABLED
disabledToolsMode = "BLACKLIST"
# Tools that don't get switched to
disabledTools = ["minecraft:diamond_pickaxe"]
# How the disabledBlocks field should function: BLACKLIST, WHITELIST, or DISABLED
disabledBlocksMode = "BLACKLIST"
# Blocks that don't trigger a switch
disabledBlocks = ["minecraft:dirt"]

# Optional custom block-to-tool mappings; IDs and tags are supported
[customBindings]
  "#minecraft:planks" = "minecraft:diamond_hoe"

Format:

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

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).

FAQ

How to install Tool Switcher?

Install Fabric for your Minecraft version, download Tool Switcher for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Tool Switcher support?

Tool Switcher has builds for Minecraft 1.20–26.3.

Is Tool Switcher needed on the server?

Client only — no need to install it on the server

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More