Smart Mace Swap

⚔️ TOX MACE SWAP

Smart Combat Automation for Minecraft 1.21.11

TOX Mace Swap is an advanced client-side PvP utility mod designed for Minecraft Java Edition 1.21.11 using Fabric.

The mod combines intelligent weapon switching, automatic mace selection, spear-to-mace swapping, shield-breaking assistance, and customizable combat features into one system.

Instead of manually switching between multiple weapons during combat, TOX Mace Swap automatically selects the appropriate weapon based on your movement, available enchantments, target conditions, and combat situation.

🔥 Main Features

1. Smart Mace Swap — Breach & Density

Automatically selects the most suitable mace depending on your falling height and available enchantments.

When standing on the ground or performing normal attacks:

• Automatically selects a mace enchanted with Breach.

• Supports attacks with swords and spears.

• Does not switch to a Density-only mace during regular ground combat.

• Does not switch to an unenchanted mace during normal ground attacks.

When falling from a significant height:

• Prioritizes a mace enchanted with Density.

• Falls back to Breach if Density is unavailable.

• Uses an unenchanted mace if neither enchantment is available.

• If no mace is available, the original weapon remains selected.

Weapon priority:

Combat situation	Mace selection
Ground combat	Breach
Normal jump	Breach
High fall	Density
High fall, no Density	Breach
High fall, no enchanted mace	Unenchanted mace
No suitable mace	No swap

2. Advanced Spear → Mace Swap

A dedicated weapon-switching system designed for Minecraft’s spear combat mechanics.

Features:

• Supports spear-to-mace switching with left-click attacks.

• Checks targets within the configured spear reach.

• Allows swap attempts even when attack cooldown is not completely full.

• Supports spear reach-based targeting up to the configured 4.5-block range.

• Automatically selects Breach or Density according to the combat situation.

• Returns to the original spear after the swap.

• Includes target and obstruction checks.

The mod attempts to coordinate spear attacks with mace switching. Successful extended-reach mace hits depend on server-side mechanics and validation.

3. Auto Spear Hit — Right-Click Combat

An automatic attack assistance feature for spear users.

How it works:

1. Hold a spear.

2. Hold the right mouse button.

3. Aim at an enemy within range.

4. The mod detects an eligible target.

5. It attempts an automatic attack with mace swapping.

6. The original spear is restored afterward.

Additional features include target filtering, configurable activation, and a cooldown between automatic attack attempts.

4. Intelligent Stun Slam

An intelligent shield-breaking combat system.

Sword → Axe Shield Break

• Detects enemies actively blocking with a shield.

• Automatically selects an available axe when attacking a blocking opponent.

• Supports shield-breaking attacks while standing on the ground.

• Restores the previously selected weapon afterward.

Spear → Axe Shield Break

• Supports shield-breaking attempts from spear combat.

• Detects raised enemy shields.

• Switches to an available axe for an appropriate attack.

• Supports grounded combat.

Falling Stun Slam

• Detects shield-blocking opponents during falling attacks.

• Attempts an Axe → Mace combat sequence.

• Selects the appropriate mace according to the current falling conditions.

• Avoids unnecessary shield-breaking actions against enemies who are not blocking.

Actual shield disabling and follow-up attacks depend on Minecraft’s cooldown system and server-side validation.

5. Visible Weapon Swapping

TOX Mace Swap includes visual weapon switching for a more natural combat experience.

Example:

Sword → Mace → Sword

Spear → Mace → Spear

Sword → Axe → Sword

The selected hotbar slot visibly changes during the swap.

Features:

• Visible hotbar selection.

• Weapon switching displayed in the player’s hand.

• Configurable return delay.

• Default visible swap duration of approximately 0.15 seconds.

• Automatic restoration of the previous weapon.

• Protection against overriding deliberate manual slot changes.

6. Smart Target Detection

The mod includes target checks to reduce unnecessary weapon switches.

Depending on the feature, these checks include:

• Whether an eligible enemy is targeted.

• Whether the target is within configured reach.

• Whether an obstruction blocks the attack.

• Whether the required weapon is available.

• Whether the relevant combat feature is enabled.

7. Smart Enchantment Detection

TOX Mace Swap reads the enchantments on available maces rather than relying on item names.

Supported mace categories:

• Breach Mace — preferred for regular ground combat.

• Density Mace — preferred for powerful falling attacks.

• Unenchanted Mace — fallback for falling attacks.

The weapon-selection system avoids unnecessary swapping when no appropriate mace is available.

8. Customizable Controls

Key	Function
V	Enable / Disable TOX Mace Swap
J	Enable / Disable Stun Slam and Shield Break
Left Click	Normal combat and supported automatic weapon swaps
Right Click (Hold Spear)	Automatic spear attack assistance

Status notifications:

• 🟢 Tox Enabled — combat automation enabled.

• 🔴 Tox Disabled — combat automation disabled.

9. Configuration System

The mod includes a configuration file:

config/smartmaceswap.json

Configurable options include:

• Automatic spear attack assistance.

• Spear left-click swapping.

• Target filtering.

• Spear targeting range.

• Visible weapon swap duration.

• Combat behavior and cooldown settings.

Certain settings can be adjusted without modifying the source code.

⚙️ Requirements

Minecraft: Java Edition 1.21.11
Mod Loader: Fabric
Fabric API: Required
Java: 21
Platform: Client-side

🎮 How to Use

1. Install Fabric Loader and Fabric API for Minecraft 1.21.11.

2. Place the TOX Mace Swap .jar inside your Minecraft mods folder.

3. Launch Minecraft.

4. Keep your combat weapons and available maces in the hotbar.

5. Press V to enable the mod.

6. Attack normally with a sword or spear.

7. The mod will attempt to select and restore weapons automatically according to the active combat conditions.

8. Press J to toggle Stun Slam and Shield Break.

🛡️ Multiplayer Compatibility

TOX Mace Swap is designed for client-side use, including multiplayer combat.

However, server performance and compatibility may vary due to:

• Server-side attack validation.

• Inventory and hotbar synchronization.

• Network latency.

• Attack cooldown mechanics.

• Anti-cheat systems.

• Server-specific combat restrictions.

Extended spear reach does not guarantee that a server will accept a mace hit at that distance.

Important: The current release’s automated logic has been tested separately, but full in-game functionality and compatibility with individual PvP servers have not been completely verified.

⭐ Why Choose TOX Mace Swap?

TOX Mace Swap combines multiple combat-assistance features in one customizable mod:

✅ Intelligent Breach and Density selection
✅ Spear-to-Mace swapping
✅ Left-click spear targeting
✅ Right-click automatic spear assistance
✅ Intelligent Stun Slam
✅ Ground-based Shield Break
✅ Sword-to-Axe switching
✅ Spear-to-Axe switching
✅ Visible hotbar swaps
✅ Automatic weapon restoration
✅ Configurable combat settings
✅ Fabric 1.21.11 support target

TOX Mace Swap — Smarter Weapon Switching. Faster Combat Decisions.

Built for Minecraft Java Edition 1.21.11 · Fabric