Swap Helper

⚔️ Swap Helper

Swap Helper is a lightweight Minecraft Fabric mod focused on fast and configurable Sword/Axe ↔ Mace swapping.

Made by Zolloww.
https://youtube.com/@zolloww-1m?si=_Cm7PAxfoOsn1n63

✨ Features

• ⚔️ Sword → Mace automatic swapping
• 🪓 Axe → Mace automatic swapping
• 🔄 Automatically returns to your previous weapon
• 🎒 Hotbar-only Mace detection — Maces in your inventory are ignored
• 📌 Leftmost Mace priority when multiple Maces are in the hotbar
• 💥 Shield Stun Slam support
• ⌨️ Fully customizable keybinds
• P as the default Swap Helper toggle key
• 👁️ Visible Swap mode with its own keybind
• ⏱️ Configurable swap delays
• 🔊 Optional toggle ON/OFF sounds
• ⚡ Lightweight and performance-friendly
• 🚫 No HUD or unnecessary screen overlays

⚙️ Configuration

Swap Helper includes a configuration screen for customizing:

• Sword → Mace delay
• Axe → Mace delay
• Mace → Sword delay
• Mace → Axe delay
• Visible Swap
• Shield Slam
• Toggle sound
• Keybinds
• Mod enable/disable state

🛡️ Hotbar Mace Priority

Swap Helper only checks the 9 hotbar slots.

If multiple Maces are available, the leftmost Mace is selected.

For example:

Slot 2 → Normal Mace
Slot 5 → Breach Mace
Slot 7 → Wind Burst Mace

Swap Helper selects Slot 2.

A Mace stored outside the hotbar will not be automatically selected.

🪓 Shield Stun Slam

When using an Axe against a player blocking with a Shield, Swap Helper can detect the required attack sequence and perform the configured Mace follow-up when an eligible Mace is available in the hotbar.

The feature can be disabled from the configuration.

🎮 Default Controls

Swap Helper: P

Both the main toggle and Visible Swap keybind can be changed through Minecraft's Controls menu.

⚡ Performance

Swap Helper is designed to stay lightweight:

• Event-driven logic
• No unnecessary background processing
• No full-inventory scanning
• Hotbar-only Mace detection
• Minimal CPU and memory usage

📦 Installation

1. Install Fabric Loader for your Minecraft version.
2. Install the required Fabric API.
3. Put SwapHelper.jar inside your Minecraft mods folder.
4. Launch Minecraft.
   explain video- https://youtube.com/@zolloww-1m?si=_Cm7PAxfoOsn1n63 (Hindi)

⚠️ Server Rules

Always check the rules of the server you are playing on before using automated combat features. Some servers may restrict or prohibit combat-assistance mods.

Swap Helper
Author: Zolloww
Mod ID: swaphelper

Made for players who want fast, configurable Mace swapping without unnecessary HUD elements or heavy features. ⚔️