Swap Helper
by Zolloww
Swap Helper is a Fabric client mod that automates swapping to a Sword or Axe when a Mace attack is set up, so the mace follow-up can land in sequence.
What it does
When a player attacks with a Sword or an Axe, the mod can switch to a Mace from the hotbar for the follow-up, then return to the previous weapon. It covers Sword Mace and Axe Mace sequences, and its breach swap is meant to make mace combat feel smoother and faster. Only the nine hotbar slots are checked, so a Mace kept in the inventory is ignored. When several Maces sit in the hotbar, the leftmost one is selected.
Timing is handled through configurable swap delays, and a toggle key is bound to P by default. Shield stun slams are supported, and an axe used against a player blocking with a shield is detected as the attack that starts the sequence. A configuration screen lets the player adjust the options, and any feature can be disabled there. The mod is built to stay lightweight, with no extra HUD elements.
The mod is client-side only, so only the player's game needs it and servers run without it. It is published for Fabric alone, which requires Fabric API, for game versions 1.21 – 26.1.2 across 15 release versions, and the latest file is 1.1.0 for 26.1.2. The code is under All rights reserved and is not open source. Players should check a server's rules before using automated combat features, since some servers restrict combat-assistance mods.
Key features
Sword and Axe Mace swapping
Automatic switching is available from both a Sword and an Axe into a Mace for the follow-up attack.
Return to previous weapon
After the swap, the mod switches back to the weapon the player was holding.
Hotbar-only Mace detection
Only the nine hotbar slots are searched, and Maces stored in the inventory are ignored.
Configurable delays and toggle key
Swap delays can be set in the configuration screen, and the default P key turns the feature on or off.
Gallery
Compatibility
Latest build for each game version and loader.
26.x3 of 3 versions with builds
1.21.x12 of 12 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
AutoBreachSwap is another Fabric option for breach swapping, client-side only, with files for 1.21 – 1.21.11 under All rights reserved and no open source code. Mace No More is a Fabric mod for 1.21 – 1.21.5 that is server required and client optional, released under the MIT License and not open source. Attribute Swapping Fix runs on Fabric for 1.21.1 – 26.3 and is server-side only, released under the CC0 1.0 Universal license and open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Swap Helper | Fabric | 1.21 – 26.1.2 | Client-side only | 2026-10-11 |
| AutoBreachSwap | Fabric | 1.21 – 1.21.11 | Client-side only | 2026-03-20 |
| Mace No More | Fabric | 1.21 – 1.21.5 | Server required, client optional | 2025-04-11 |
| Attribute Swapping Fix | Fabric | 1.21.1 – 26.3 | Server-side only | 2026-10-04 |
Questions
Does Swap Helper need Fabric API?
Does a server need Swap Helper installed?
Which Mace is used when several are in the hotbar?
In the catalog
Swap Helper 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 Zolloww
Similar mods
What the author says
Swap Helper is a lightweight Minecraft Fabric mod focused on fast and configurable Sword/Axe ↔ Mace swapping. Swap Helper only checks the 9 hotbar slots.
Official listing
- Modrinth page
- modrinth.com/mod/swap-helper
- Owner
- Zolloww
- Published
- 2026-02-11
- Updated on Modrinth
- 2026-10-11
- Facts verified
- 2026-10-15
