UltimateMaceControl

** 📖 **Description** **MaceLimiter** is a powerful and highly configurable Minecraft plugin designed to balance the **Mace** weapon introduced in Minecraft 1.21. The Mace's devastating smash attack and unique mechanics can break PvP balance on competitive servers, especially LifeSteal, Factions, and hardcore PvP environments. This plugin offers **two distinct balancing modes** to fit your server's playstyle: 🗡️ **Mode 1: SINGLE_MACE (The Highlander Rule)** > *"There can be only one."* Only **ONE Mace** can exist on the entire server at any time. This creates an intense dynamic where the Mace becomes a legendary trophy that players fight over. When destroyed, the recipe becomes available again for a new challenger to claim. ⚔️ **Mode 2: UNLIMITED_NO_ENCHANT (The Nerf)** > *"Power without enhancement."* Players can craft **unlimited Maces**, but they **cannot be enchanted**. No Density, no Breach, no Mending. This keeps the Mace usable but prevents it from becoming an unstoppable force when combined with powerful enchantments. --- ✨ **Key Features** 🎯 **Core Features** | Feature | Description | |---------|-------------| | **Dual Mode System** | Choose between Single Mace or Unlimited No-Enchant modes | | **Persistent State** | Mace ownership and state survive server restarts | | **Offline Tracking** | Tracks Mace when owner logs out, prevents crafting exploits | | **Destruction Detection** | Detects Mace loss via Lava, Void, Fire, Cactus, Despawn, Explosions | | **Auto Recipe Toggle** | Recipe auto-enables when Mace is destroyed (Mode 1) | | **13 Languages** | Full localization support with customizable messages | --- 🔒 **Mode 1: SINGLE_MACE Features** | Feature | Description | |---------|-------------| | **One Mace Limit** | Only one Mace can exist server-wide | | **Crafting Control** | Recipe disabled when Mace exists | | **Ownership Tracking** | Tracks current Mace holder with UUID | | **Container Restrictions** | Mace cannot be stored in chests, barrels, shulkers, hoppers | | **Allowed Containers** | Configurable exceptions (Anvil, Smithing Table, Grindstone) | | **Item Frame Block** | Prevents displaying Mace in item frames | | **Armor Stand Block** | Prevents placing Mace on armor stands | | **Hopper Protection** | Blocks hopper/dropper movement of Mace | | **Colored Name** | Mace holder gets colored display name | | **Locate Command** | Find current Mace holder or location | | **Death Drop Alerts** | Broadcasts when Mace holder dies | | **Transfer Tracking** | Announces ownership changes | --- ⚔️ **Mode 2: UNLIMITED_NO_ENCHANT Features** | Feature | Description | |---------|-------------| | **Unlimited Crafting** | No restrictions on Mace crafting | | **Enchanting Blocked** | Cannot enchant at Enchanting Table | | **Anvil Blocked** | Cannot add enchanted books via Anvil | | **Combining Blocked** | Cannot combine enchanted items with Mace | | **Smithing Allowed** | Can still upgrade to Netherite (if applicable) | | **Free Storage** | No container restrictions in this mode | | **Enchant Removal** | Auto-strips enchants if Mace somehow gets enchanted | --- 🎮 **Use Cases** **1. LifeSteal Servers** The Mace's massive damage output can one-shot players, stealing hearts instantly. MaceLimiter prevents this from becoming server-breaking: - **Mode 1**: Only one player can wield this power at a time - **Mode 2**: Mace stays useful but not OP without enchants **2. Factions / Raiding Servers** Prevent faction leaders from hoarding multiple enchanted Maces: - Container restrictions prevent vault storage - Single Mace creates faction wars over the weapon - Destruction detection resets the playing field **3. Hardcore PvP Servers** Balance competitive PvP without removing the Mace entirely: - Keep the unique smash attack mechanic - Remove enchantment stacking abuse - Create legendary weapon dynamics **4. SMP / Semi-Vanilla Servers** Add excitement without heavy modification: - Single Mace becomes a server-wide event - Players hunt for the Mace holder - Natural balancing through scarcity **5. Event Servers** Perfect for special events and competitions: - "Hunt the Mace Holder" events - Last player standing with Mace wins - Timed Mace challenges --- 📊 **Mode Comparison Chart** | Feature | Mode 1: SINGLE_MACE | Mode 2: UNLIMITED_NO_ENCHANT | |---------|:-------------------:|:----------------------------:| | Maces Allowed | 1 | ∞ Unlimited | | Crafting Limit | ✅ Yes | ❌ No | | Enchanting | ✅ Allowed | ❌ Blocked | | Anvil Use | ✅ Allowed | ⚠️ Repair Only | | Chest Storage | ❌ Blocked | ✅ Allowed | | Shulker Storage | ❌ Blocked | ✅ Allowed | | Hopper Movement | ❌ Blocked | ✅ Allowed | | Item Frames | ❌ Blocked | ✅ Allowed | | Ownership Tracking | ✅ Yes | ❌ No | | Offline Protection | ✅ Yes | ❌ No | | Colored Names | ✅ Optional | ❌ N/A | | Locate Command | ✅ Full | ❌ N/A | | Destruction Alerts | ✅ Yes | ❌ No | | Death Broadcasts | ✅ Yes | ❌ No | --- 🛠️ **Commands** | Comma