HotSwap
ModMIT

HotSwap

Auto swap to the right tool

1.8K
Downloads
5
Followers
11 months ago
Updated
📦
7
Versions

📖About HotSwap

Modrinth Game Versions
Modrinth Version

Demo GIF

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: 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

  1. Install Fabric (or Forge, depending on build) for Minecraft 1.20+
  2. Download the latest HotSwap-x.y.z.jar from Modrinth.
  3. Copy the jar into your Minecraft mods/ folder.
  4. Launch Minecraft with the Fabric (or Forge) profile.

🎮 Usage

  1. Toggle — press your configured toggle key (default ;) to enable or disable HotSwap.
  2. Mine or Chop — break a block; HotSwap will swap in your best pickaxe/axe/shovel according to the tags in your hotbar.
  3. Fight — 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

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.