Compatibility
Minecraft: Java Edition
1.21.4–1.21.5
1.21–1.21.1
1.20.6
Platforms
Supported environments
Creators
Details
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.json5
to 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.jar
from 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.