
Tool Switcher
Automatically switches to the correct tool when breaking blocks.
About this Mod
Tool Switcher
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_pickaxeminecraft:wooden_shovel,minecraft:stone_shovel,minecraft:iron_shovelminecraft:wooden_axe,minecraft:stone_axe,minecraft:iron_axeminecraft:golden_pickaxe,minecraft:golden_shovel,minecraft:golden_axe
Common Block IDs:
minecraft:diamond_ore,minecraft:deepslate_diamond_oreminecraft:ancient_debris,minecraft:gilded_blackstoneminecraft: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
How to Install Tool Switcher on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2-pre-2).
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
Minecraft Versions
26.2-pre-2, 26.1.2, 26.1.1 (+22 more)
Server-side
✗ UnsupportedRecommended 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.
Similar Mods
Rent Modded Server
Install Tool Switcher with just one click on your server.