HotSwap
Auto swap to the right tool, with blazing speed.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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
- Lightweight & Non-Invasive 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. - Lightweight & Non-Invasive Define your own tag priorities and blacklists in `hotswap.json5` to fine-tune which tools should be preferred or skipped. - Lightweight & Non-Invasive 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
1. Install Fabric (or Forge, depending on build) for Minecraft 1.20+ 2. Download the latest `HotSwap-x.y.z.jar` from Install Fabric. 3. Copy the jar into your Minecraft `mods/` folder. 4. Launch Minecraft with the Fabric (or Forge) profile.
---
Usage
1. Return — press your configured toggle key (default `;`) to enable or disable HotSwap. 2. Return — break a block; HotSwap will swap in your best pickaxe/axe/shovel according to the tags in your hotbar. 3. Return — left-click a mob; HotSwap will switch to the highest-damage sword or tool. 4. 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 |
> Options → Controls 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.