Back to mods
Tool Switcher project artwork

CurseForge · Minecraft mod

Tool Switcher

Automatically switches to the correct tool when breaking blocks.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Tool Switcher release matches 26.1?

Updated yesterday
Best match for your filters 3.1.4
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

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.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup. 3 come through another mod in the chain.

2 listed on this file 3 pulled in by those mods
Fabric API Needed by Tool Switcher 3.1.4
required
Matching file found Matched file: 0.155.3+26.1.2
McQoy Optional for Tool Switcher 3.1.4
optional
Matching file found Matched file: 0.4.1+fabric-26.1
Mod Menu Needed by McQoy
pulled in
Matching file found Matched file: 18.0.1

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.

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

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

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

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

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.

<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_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 </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.

32 available setups

Showing 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

4 of 36 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.