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 in hotswap.json5 to fine-tune which tools should be preferred or skipped.
- On-the-Fly Enable/Disable
Toggle HotSwap with a single keybind (default: ;). 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 CurseForge.
- 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.
Changelog
See the changelog for a full history of changes and releases.
