Tool Switcher

Tool Switcher

Automatically switches to the correct tool when breaking blocks.

by
24.8K Downloads
fabricequipmentutility
Rent Server with this Mod

About this Mod

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.
How to Configure Filters

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

Available Versions

Tool Switcher v3.1.5release
MC 26.2-pre-2fabric
May 30, 2026
Tool Switcher v3.1.4release
MC 26.1, 26.1.1, 26.1.2fabric
May 27, 2026
Tool Switcher v3.1.3release
MC 26.1, 26.1.1, 26.1.2fabric
May 12, 2026
Tool Switcher v3.1.2release
MC 26.1, 26.1.1, 26.1.2fabric
March 15, 2026
Tool Switcher v3.1.1release
MC 26.1-snapshot-9fabric
February 23, 2026

How to Install Tool Switcher on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2-pre-2).

3

Install Mod

Open the mod browser in the dashboard and search for "Tool Switcher". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

26.2-pre-2, 26.1.2, 26.1.1 (+22 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Tool Switcher server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2-pre-2). You can switch loaders with one click in the panel.

Is Tool Switcher compatible with fabric?

Tool Switcher officially supports fabric for Minecraft 26.2-pre-2, 26.1.2, 26.1.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Tool Switcher – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Tool Switcher consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Tool Switcher with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

26.2-pre-226.1.226.1.126.126.1-snapshot-926.1-snapshot-71.21.111.21.101.21.91.21.8+15 more