Mace Control

MaceControl

Take back control of mace combat. MaceControl solves the chaos of overpowered maces on modern SMPs. Server owners get four operating modes, a hard damage cap, a craftable mace tracker, server-wide craft announcements, and unique Mythic combat abilities with particle effects, all fully server-side.

Made by by_Fury0 · Minecraft 1.21.11+ · Spigot / Paper · Java 21 · No resource pack required

Key Features

4 Server Modes

Switch instantly with /macecontrol mode :

Mode · What it does
SINGLE · Only 1 mace can exist or be crafted on the entire server at a time.
DOUBLE · Only 2 maces can exist: a Breach mace and a Density mace. The first mace crafted becomes the Breach mace and the second becomes the Density mace. They are mutually exclusive: a Breach mace can never receive Density, and a Density mace can never receive Breach.
MULTI · Unlimited maces for modern SMP economies, but every mace loses all its enchantments on impact.
MYTHIC · Single-mace mode with two high-impact combat abilities, cooldowns, sounds and particles.

Craft Announcements (all modes)

When a mace is crafted, the whole server gets a chat message, title and sound.

• SINGLE / MULTI / MYTHIC: one announcement.
• DOUBLE: two separate announcements, one for the Breach Mace and one for the Density Mace.
• Message format and labels are fully editable in config.yml.

Damage Cap

Set a hard maximum with max_mace_damage to stop game-breaking one-shot hits. Any mace hit above the cap is scaled down to it.

Active Mace Locator (Tracker)

A craftable compass that points to the nearest active mace (a player carrying one, or a dropped mace). Right-click to update it. The action bar shows who or what you're tracking and the distance.

Recipe: 4 Gold Ingots around a Compass

. G .
G C G
. G .
G = Gold Ingot C = Compass

Mythic Mace Abilities (MYTHIC mode)

Ability · Default activation · Effect · Default cooldown
Dash Strike (Ability 1) · F (swap hands) or /mace ability 1 · Launch forward with a lightning flash, a cloud/spark/crit/flame particle trail and a blaze sound. Damages and knocks back anything you plow through. · 15s
Shockwave Slam (Ability 2) · Shift + F or /mace ability 2 · Explosion burst, a rising light column and expanding spark rings. Damages and launches everything in the radius, with explosion and thunder sounds. · 35s

• Remaining cooldown is shown in the action bar.
• The Mythic Mace holder gets a subtle particle aura (can be disabled).
• Abilities can hit players and mobs (configurable). Creative and spectator players are never affected.

Persistent Mace Registry

MaceControl keeps a saved registry (data.yml) of every mace on the server, so limits still hold when holders are offline or after restarts. Untracked maces (loot, creative, pre-plugin maces) are picked up automatically when players join or pick them up. Maces that despawn, burn or fall into the void are removed from the registry on their own.

Player Settings

Each player can choose how to activate abilities with /mace settings:

• Swap-hand key: F = Ability 1, Shift + F = Ability 2
• Commands only: /mace ability 1 and /mace ability 2

Commands

Admin commands: /macecontrol (aliases: /mc, /maces)

Permission: macecontrol.admin (Op only)

Command · Description
/macecontrol · Shows the admin help menu.
/macecontrol mode · Switches the server-wide mace mode and broadcasts the change. Untracked maces held by online players are registered.
/macecontrol tracker · Gives you the Active Mace Locator compass.
/macecontrol status · Shows the current mode, number of registered maces and the damage cap.
/macecontrol list · Lists every registered mace (ID, type, crafter/finder).
/macecontrol scan · Registers any untracked maces in online players' inventories.
/macecontrol forget · Removes one mace (by ID prefix) or all maces from the registry. Use it when a mace was lost or destroyed, for example in a chest that was blown up.
/macecontrol reload · Reloads config.yml and the registry data.

Player commands: /mace

Permission: macecontrol.use (everyone by default)

Command · Description
/mace · Shows the player help menu.
/mace ability 1 · Triggers Dash Strike (MYTHIC mode, Mythic Mace in main hand).
/mace ability 2 · Triggers Shockwave Slam (MYTHIC mode, Mythic Mace in main hand).
/mace settings · Toggles between swap-hand key activation and commands-only.

Permissions

Permission · Default · Description
macecontrol.admin · Op · Access to all /macecontrol commands.
macecontrol.use · Everyone · Access to /mace commands and key-activated abilities.

Configuration (config.yml)

settings:
plugin_enabled: true
active_mode: "SINGLE" # SINGLE, DOUBLE, MULTI, MYTHIC
max_mace_damage: 40.0 # Hard cap on final mace hit damage

Craft announcements (all modes). DOUBLE mode announces the Breach mace

(first one crafted) and the Density mace (second one) separately.

announcements:
enabled: true
title: true
sound: true
format: "&6&l[MACE] &e{player} &7has crafted &f{label}&7!"
labels:
SINGLE: "&6the Mace"
MULTI: "&6a Mace"
MYTHIC: "&6&lthe Mythic Mace"
DOUBLE_BREACH: "&bthe Breach Mace"
DOUBLE_DENSITY: "&ethe Density Mace"

tracker:
craftable: true # needs a server restart to change
cooldown_seconds: 2

mythic:
aura: true # particles around the holder of the Mythic Mace
affect_mobs: true # abilities also hurt mobs, not only players
ability_1: # Dash Strike
cooldown: 15 # seconds
power: 2.2 # dash strength
damage: 6.0
ability_2: # Shockwave Slam
cooldown: 35 # seconds
radius: 6.0
damage: 8.0
knockback: 1.1

Notes

• Shift-click crafting is disabled for maces so every craft is counted and announced.
• The tracker works within the same world and cannot see maces stored in chests or held by offline players.
• In MYTHIC mode, the server's single mace is the Mythic Mace and gets a custom name.
• Fully server-side and lightweight. Works on Spigot and Paper.

Installation

1. Drop MaceControl-1.3.jar into your server's plugins folder.
2. Restart the server.
3. Edit plugins/MaceControl/config.yml if you want, then run /macecontrol reload.
4. Pick your mode with /macecontrol mode .

Support & feedback: use the issues tab or contact by_Fury0.
DC- discord.gg/n8JuR366s