CurseForge · Minecraft mod
Tool Switcher
Automatically switches to the correct tool when breaking blocks.
Quick answer
Which Tool Switcher release matches 26.1?
Tool Switcher 3.1.4 targets 26.1, 26.1.1, 26.1.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.
Where it goes
Is Tool Switcher required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does Tool Switcher 3.1.4 need?
3.1.4 on 26.1. Every mod below is checked against that same setup.
Install Fabric API first. We found matching files for this game-version and loader setup. 3 come through another mod in the chain.
3 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Tool Switcher without breaking your instance.
Built for Tool Switcher 3.1.4 on 26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 3.1.4. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup. 3 come through another mod in the chain.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 3.1.4. It opens that exact file at the source.
About this project
What does Tool Switcher add?
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. |
<details> <summary>How to Configure Filters</summary>
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</details>
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).
Project description from CurseForge.
Pick your setup
Tool Switcher by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3-snapshot
1 loader build26.3-rc-3
1 loader build26.3-rc-2
1 loader build26.3-rc-1
1 loader build26.3
1 loader build26.2-pre-2
1 loader build26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1-snapshot-9
1 loader build26.1-snapshot-7
1 loader build26.1-snapshot
1 loader buildShowing the newest 12 of 32 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Tool Switcher versions and loaders
3.1.4
tool-switcher-3.1.4.jar
27 May 2026
Tool Switcher v3.1.4
tool-switcher-3.1.4.jar
27 May 2026
Tool Switcher v3.1.3
tool-switcher-3.1.3.jar
12 May 2026
Tool Switcher v3.1.2
tool-switcher-3.1.2.jar
15 Mar 2026
Looking for an older file? The official CurseForge project page is in Resources.