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.