
ModMIT
HotSwap
Auto swap to the right tool
1.8K
Downloads
5
Followers
11 months ago
Updated
📦
7
Versions
📖About HotSwap

HotSwap
HotSwap is a lightweight, client-side Minecraft mod that automatically selects the optimal tool or weapon in your hotbar based on what you’re doing—be it mining,
chopping, fighting, or digging. By leveraging Minecraft’s built-in item tags,
HotSwap ensures you always have the right tool in hand without manual inventory juggling.
🚀 Features
- Context-Aware Swapping
Automatically switches to the “best” tool in your hotbar for the block you’re breaking or mob you’re hitting, based on enchantments and material tiers. - Customizable Priority
Define your own tag priorities and blacklists inhotswap.json5to fine-tune which tools should be preferred or skipped. - On-the-Fly Enable/Disable
Toggle HotSwap with a single keybind (default:H). When disabled, your hotbar remains unchanged. - Lightweight & Non-Invasive
No extra GUIs or big configuration menus—just an easy-to-edit JSON5 file and a small, performant mod jar.
🎯 Installation
- Install Fabric (or Forge, depending on build) for Minecraft 1.20+
- Download the latest
HotSwap-x.y.z.jarfrom Modrinth. - Copy the jar into your Minecraft
mods/folder. - Launch Minecraft with the Fabric (or Forge) profile.
🎮 Usage
- Toggle — press your configured toggle key (default
;) to enable or disable HotSwap. - Mine or Chop — break a block; HotSwap will swap in your best pickaxe/axe/shovel according to the tags in your hotbar.
- Fight — left-click a mob; HotSwap will switch to the highest-damage sword or tool.
- Return — once the action ends (block broken or mob dead), your previous hotbar slot is restored automatically.
🛠️ Keybinds & Commands
| Action | Default Key | Description |
|---|---|---|
| Toggle HotSwap | ; |
Enable or disable the auto-swap |
| Hold Off | Left Alt |
Temporarily disable auto-swapping |
Tip: You can change or assign these in Minecraft’s Options → Controls menu under “HotSwap.”
📜 Changelog
See the changelog for a full history of changes and releases.
📄 License
HotSwap is released under the MIT License.