🌟 Key Features

A streamlined overview designed to show players exactly why they need your mod:

• 🪓 Instant Shield Breaker: Automatically detects when an opponent is blocking with a shield. The moment you strike, it instantly swaps to the nearest axe in your hotbar to disable their defense, then seamlessly switches back to your weapon.
• 💥 Stun Slam: Enable Stun Slam in the Shield Breaker GUI to chain a shield-breaking axe hit into a mace smash while falling. Keep both an axe and a mace in your hotbar.
• 🎨 Modern GUI: Press Right CTRL (Default) to open a clean, intuitive interface to easily manage your settings and toggle features without typing complex commands.
• ⚡ PvP-Optimized Response: Built with client-side efficiency in mind, ensuring split-second weapon switches mid-combat with zero input lag or FPS drops.

🛡️ Multiplayer & Server Opt-In

Modrinth Rule 3.3d: Automatic shield-breaking is a server-side opt-in feature. By default it is disabled on dedicated servers.

• Singleplayer / LAN: Always works, no setup needed.
• Dedicated server: Works only if the server operator installs the mod and sets allow_shield_breaker=true in config/shieldbreaker-server.properties (default: false). If not allowed, you will see in chat: Disabled on this server. Server opt-in required. and Blocked... with a 3s anti-spam cooldown - the mod will not swap or attack.

📖 How to Use

💡 Quick Tip: It is highly recommended to restart your game after the initial setup for all configurations to sync properly.

1. Launch Minecraft and press Right CTRL to bring up the main mod menu.
2. Toggle Shield Breaker on, then enable Stun Slam in the GUI if you want aerial axe-to-mace combos.
3. Bind a custom hotkey (e.g., the G key) to quickly toggle the mod on and off mid-combat without opening the menu.