ModsFinder

HotSwap

by iso2t

HotSwap selects the right tool from the hotbar as the player switches between mining, chopping, digging and fighting, and it is a client-side mod.

FabricNeoForgeClient-side onlyMIT LicenseOpen source1.20.6 – 26.1.2

What it does

When the player picks up a block or targets an entity, HotSwap moves the matching item into the hand without any manual inventory work. It relies on the item tags built into Minecraft to decide which tool fits the current action, so the choice follows what the player is doing at that moment.

A toggle key, bound to a default key that can be changed, turns the swapping on and off during play. Priority rules can be adjusted in the settings, which lets a player decide which tools should win when several fit the same action. The mod is lightweight and does not change how the world or other players behave.

Installation needs the loader build that matches the game version, copied into the mods folder and launched with a Fabric or NeoForge profile. HotSwap is client-side only, so servers do not need it. It is released under the MIT License and is open source. Files cover 1.20.6, 1.21, 1.21.1, 1.21.4, 1.21.5, 26.1, 26.1.1 and 26.1.2, with 1.4.2 for 26.1.2 as the latest file for both loaders.

Key features

  1. Automatic tool selection

    The right tool moves into the hand as the player mines, chops, digs or fights, with no extra clicks.

  2. Context-aware swapping

    The swap depends on the target in front of the player, so a sword is chosen for a mob and a pickaxe for stone.

  3. Customizable priority

    The order in which tools are preferred can be set, so a favored weapon or tool is picked first when several match.

  4. On-the-fly toggle

    A configurable key turns the swapping on or off during play without restarting the game.

  5. Built-in item tags

    Matching relies on Minecraft's own item tags, so modded tools that follow those tags are handled as well.

Compatibility

Latest build for each game version and loader.

26.1.21.4.21.4.2
26.1.11.4.11.4.1
26.11.4.0.rc11.4.0.rc1
1.21.51.3.01.3.0
1.21.4Not available1.2.1_alpha
1.21.1Not available1.2.0-1.21.1
1.21Not available1.1.2.1-NeoForge
1.20.6Not available1.1.0-1.20.6
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Required by 1 mod

Use cases

Who it’s for: Players who spend long sessions switching between many tools and want the hotbar managed for them. The mod is for single-player and multiplayer clients, and it changes nothing on the server.

How it compares

Full comparison

Context Tool Swapping runs on Fabric and NeoForge, is client-side only and covers 1.20 – 26.3, and its license is the MIT License. Swap Helper is client-side only on Fabric, covers 1.21 – 26.1.2 and is released under All rights reserved. Auto Totem Swaper is for Fabric under the MIT License, but it is client and server, so servers need it too.

ModLoadersGame versionsEnvironmentUpdated
HotSwapFabric and NeoForge1.20.6 – 26.1.2Client-side only2026-04-16
Context Tool SwappingFabric and NeoForge1.20 – 26.3Client-side only2026-05-17
Swap HelperFabric1.21 – 26.1.2Client-side only2026-10-11
Auto Totem SwaperFabric1.21 – 1.21.11Client and server2026-03-18

Questions

Does HotSwap need to be installed on the server?

No. Only the player's game needs it, and servers run without it.

Which loaders does HotSwap support?

Fabric and NeoForge. Files for both loaders exist for 26.1.2, with 1.4.2 as the latest version.

Is HotSwap required by any other mod?

Yes. HotSwap Fix requires HotSwap, so the fix must be installed alongside it.

In the catalog

HotSwap is one of 17,631 Equipment mods on ModsFinder, and one of 8,894 Equipment mods for Fabric. 15,189 mods support Minecraft 26.1.2.

More from iso2t

All projects

Similar mods

What the author says

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…
iso2t, on the Modrinth page

Official listing

Owner
iso2t
Published
2024-06-06
Updated on Modrinth
2026-04-16
Facts verified
2026-10-15

Tags