Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
ToolSwapper
Automatically switches to the right tool when you start mining a block, and the right weapon when you attack a mob. No setup needed.
How it picks tools
A lot of auto-tool mods use a hardcoded list (stone means pickaxe, dirt means shovel, and so on). That list needs updating every time Mojang adds blocks, and it doesn't know about modded blocks at all.
ToolSwapper doesn't use a list. When you start breaking a block, it checks which tool in your inventory breaks it fastest and which one you actually need to get the drop, then uses that. So it works with vanilla blocks, modded blocks, and anything added by datapacks without needing specific support.
Some examples:
| Tool | Used for |
|---|---|
| Pickaxe | Stone, ores, deepslate, obsidian, metal blocks, rails, concrete, terracotta |
| Shovel | Dirt, sand, gravel, clay, snow, soul sand, mud |
| Axe | Logs, planks, chests, barrels, pumpkins, bamboo blocks, beehives |
| Hoe | Hay bales, sponges, nether wart blocks, moss, sculk |
| Shears | Leaves, wool, cobwebs, vines, glow lichen |
| Sword | Cobwebs, bamboo |
It won't swap when there's no point: if the block breaks instantly by hand, can't be broken, or you're already holding the best option.
The details
- Silk Touch gets used for things like glass, ice and spawners, and Fortune for ores and crops. If you have both, it picks whichever suits the block.
- Break speed is actually calculated, including Efficiency, Haste, Mining Fatigue, and the penalties for mining underwater or while in the air.
- If one of your tools can mine the block instantly, that one gets picked.
- Tools that are about to break are left alone, so it won't wear your netherite pickaxe down to its last 5 durability.
Combat
Weapons are ranked by the attack damage and attack speed on the item itself, so modded weapons work fine. Smite, Bane of Arthropods and Impaling are checked against the mob using vanilla entity tags, which means datapacks that change those tags are respected.
You can prioritize burst damage or DPS, skip Knockback weapons (useful for mob farms), prefer axes against mobs with shields, or set overrides for specific mobs.
Config
Most people won't need to touch it. If you want to, there are plenty of options, and you can change any of them in-game with /toolswap set <path> <value> without restarting.
Controls
| Key | Action |
|---|---|
V |
Toggle on/off |
| (unbound) | Cycle profile, suspend while held, force swap, reload config |
There's a small HUD showing the current state. You can hide it with /toolswap global set display.hud false.
Notes
- Client-side only, so nothing needs to be installed on the server.
- Check the server's rules first. Plenty of servers don't allow auto-tool mods, and pulling tools from your main inventory (not just the hotbar) sends container packets that some anticheats flag. Turn on
safety.antiCheatSafeModeto limit it to hotbar switching. - Mod Menu is optional and just adds a config button.


