Description
MX Tool Swapper puts the right item in your hand for you: the best tool when mining, the best weapon when fighting and your elytra when you take off. It is fully client-side and works on vanilla servers.
Features
Tool swapping
When you start mining a block, the mod searches your inventory for the fastest tool that still gets the block's drops and puts it in your hand.
- Efficiency enchantments are taken into account.
- Blocks that need a certain tool (like obsidian) only get a tool that can actually harvest them.
- If the tool in your hand already works for the block type you keep mining, nothing is swapped.
- If the best tool is in your hotbar, its slot is selected. Otherwise it is swapped into the current slot.
Weapon swapping
When you attack a mob, the mod swaps to your strongest sword, or to your best axe if you have no sword.
Elytra swapping
- Press jump in mid-air and an elytra from your inventory goes into your chest slot, so you start gliding right away.
- After you land, your chestplate goes back on.
- The elytra with the most durability left is used.
Client-side only
All swaps are made with regular inventory clicks, so the mod doesn't need to be installed on the server.
Some servers consider automatic item swapping a utility mod. Check the server rules before using it.
Configuration
Every option can be changed in game through Mod Menu (Mods → MX Tool Swapper → Configure) or in config/mxtoolswapper.json:
- Tool Swap Mode: Any, Only Tools (never swap away from a held sword) or No Swap
- Swap Weapon, Swap From Any Item (also swap from a non-tool or an empty hand)
- Search Hotbar, Select Hotbar Slot
- Minimum Remaining Durability: skip tools that are about to break
- Auto-Equip Elytra, Swap Armor Back After Landing
- Filter: allowlist or blocklist of item ids (
minecraft:diamond_pickaxe) or item tags (#minecraft:axes)
The key Toggle MX Tool Swapper turns the whole mod on and off. It is unbound by default; set it under Options → Controls → Key Binds.
Requirements
- Minecraft 26.3, Fabric Loader 0.19.0 or newer
- Fabric API and Cloth Config API
- Mod Menu (optional, for the settings screen)
Links
- Source code and issues: GitHub
- The idea of tool and weapon swapping comes from the Tool Swapper upgrade in Sophisticated Backpacks by P3pp3rF1y. MX Tool Swapper is an independent implementation. Elytra swapping is inspired by Auto Swap.

