🛡️ ShieldSwap

Automatically swaps your sword to an axe when hitting a blocking enemy

📖 Detailed Description

What does this mod do?

ShieldSwap is a client-side Fabric mod that automatically replaces your sword with an axe the moment you strike an enemy who is blocking with a shield. You no longer need to manually switch hotbar slots in the heat of battle — the mod does it for you instantly and without any delay.

How does this improve the gameplay experience?

In PvP combat, every fraction of a second matters. When you see an opponent raise their shield, you have two options:

Keep hitting with your sword — the shield will absorb most of the damage, wasting your attack cooldown and leaving you vulnerable
Manually switch to an axe — losing precious moments scrolling through your hotbar or pressing the wrong key under pressure

ShieldSwap eliminates this dilemma entirely. The mod automatically detects when an enemy is blocking with a shield and instantly swaps your sword to an axe from anywhere in your inventory. This provides:

· ⚡ Instant reaction time — you deal maximum damage with zero delay · 🎯 Focus on combat — no need to divert attention to switching slots mid-fight · 🏆 Competitive advantage — you always use the right weapon against shielded opponents · 🔄 Seamless integration — the swap happens so smoothly you won't even notice it

How it works (technical details)

The mod uses Mixin injection to hook into the game's combat mechanics:

When you attack an entity with a sword, the mod checks if the target is currently blocking with a shield
If yes, it scans your entire inventory for any axe (wooden, stone, iron, diamond, or netherite)
The first available axe is instantly swapped with your current sword slot
The sword moves to the axe's previous inventory position — nothing is lost or dropped
After combat, you can manually switch back to your sword

Features and capabilities

Feature Description Automatic weapon swap Sword → Axe when hitting a blocking enemy Full inventory scanning Finds axes anywhere in your inventory, not just the hotbar Item preservation Sword and axe swap positions — nothing is deleted or duplicated Zero configuration Works out of the box — no settings to adjust Lightweight Minimal performance impact, runs entirely client-side Server compatible Works on any server that allows client-side mods

Practical examples

Example 1: PvP Duel

You're fighting another player. They pull out a shield and start blocking. You continue attacking with your sword, and ShieldSwap instantly replaces it with your iron axe. You break through their shield in one hit, leaving them stunned and vulnerable.

Example 2: PvE Raid

You're raiding a pillager outpost. A vindicator with a shield charges at you. As you strike, ShieldSwap equips your diamond axe automatically. The vindicator's shield is disabled, and you finish them off quickly.

Example 3: Casual Survival

You're exploring and accidentally aggro a shielded zombie. Without thinking about hotbar management, you attack — ShieldSwap handles the weapon switch, and you dispatch the zombie efficiently.

What makes this mod special?

Unlike other combat mods that add complex mechanics or require configuration, ShieldSwap focuses on one specific problem and solves it perfectly. It doesn't clutter your screen with HUD elements, doesn't require keybinds, and doesn't change any vanilla behavior — it simply makes shield combat fair and responsive.

The mod is also:

· Vanilla-friendly — feels like a natural part of the game · Non-intrusive — no chat spam, no popups, no settings menus · Universally useful — works in singleplayer, multiplayer, PvP, and PvE

Requirements

Requirement Version Minecraft 1.21.4 Fabric Loader 0.15.11 or higher Fabric API Latest for 1.21.4 Java 21 or higher

Installation

Download the .jar file from the Files tab
Press Win + R, type %appdata%.minecraft, and press Enter
Open the mods folder (create it if it doesn't exist)
Drag the downloaded .jar file into the mods folder
Make sure Fabric API is also installed
Launch Minecraft with the Fabric profile

Frequently Asked Questions

Q: Does this mod work on servers? A: Yes! The mod runs entirely on the client side and works on any server that allows client-side mods.

Q: What if I have multiple axes in my inventory? A: The mod will select the first axe it finds (starting from slot 0 and scanning to the end of your inventory).

Q: Does the mod automatically switch back to my sword after combat? A: No, you'll need to manually switch back. This is intentional — you may want to keep using the axe for follow-up attacks.

Q: Will this mod get me banned on servers? A: No, ShieldSwap only automates inventory switching — it doesn't provide any unfair advantages like reach hacks or killaura. However, always check individual server rules.

Q: The mod crashes my game! A: Make sure you have Fabric API installed for Minecraft 1.21.4 and that you're using Java 21 or higher.

Q: Can I use this mod with other combat mods? A: Yes! ShieldSwap is compatible with most client-side mods, including minimaps, HUD mods, and performance optimizers.

Enjoy seamless shield-breaking combat! 🛡️⚔️

shieldswap v1.0.0