⚔️ MaceControl

MaceControl is a lightweight, highly configurable Paper plugin designed to regulate, track, and balance the powerful Mace on your Minecraft server. Perfect for hardcore survival servers, SMP events, and custom balancing!

✨ Features

Server-Wide Crafting Limits: Set a strict maximum limit on how many Maces can ever be crafted on your entire server.

Dramatic Wither Sounds: Optionally trigger the intimidating Wither spawn sound server-wide the exact moment a Mace is crafted.

Flexible Broadcast System: Announce the craft to everyone online! Choose between:

Reveal: Mentions the player's name who crafted it.

Anonymous: Announces the event without leaking the player's identity.

None: Silent crafting.

Smart Inventory & Offline Tracker: Using an intelligent background tracker, the plugin knows who currently holds the Mace—even if they log out! Items stored in chests or dropped are automatically handled.

Glowing Effect: Give players holding a Mace the Glowing status effect to make them targets on the map.

Destruction Detection & Recrafting: Automatically detects if a Mace is destroyed (via lava, void, fire, cactus, explosion, or despawn). If enabled, it frees up the slot so a new Mace can be crafted!

Ender Chest Restriction: Optionally block players from storing the Mace inside an Ender Chest to prevent hiding it safely away.

Custom Attack Cooldowns: Choose between vanilla (DEFAULT) behavior or enforce a custom attack delay (COOLDOWN) with visual item cooldown overlays and warning messages.

Custom Command (/mace): Allows players to check who currently owns the Mace(s), regardless of whether they are online or offline. Fully toggleable via config.

Fully Customizable Messages: Translate or customize every single in-game message directly inside the configuration file with color code support (&).

⚙️ Configuration (config.yml)

# Maximum number of Maces allowed to be crafted on the server
max-maces: 1

# Play the Wither spawn sound across the server when a Mace is crafted
play-wither-sound: true

# Broadcast mode upon crafting: REVEAL, ANONYMOUS, or NONE
broadcast-type: "REVEAL"

# Enable or disable the /mace command
enable-mace-command: true

# Apply the Glowing effect to players holding a Mace in their inventory
glowing-effect: true

# Allow crafting a new Mace if an existing one gets destroyed (lava, void, cactus, despawn, etc.)
allow-recraft-on-destruction: true

# Allow players to store the Mace inside an Ender Chest
allow-enderchest-storage: false

# Mace attack cooldown configuration:
# DEFAULT  = Uses normal vanilla Minecraft Mace attack speed
# COOLDOWN = Enforces a custom delay between hits
attack-cooldown:
  mode: "COOLDOWN" # Options: "DEFAULT" or "COOLDOWN"
  duration-seconds: 3.0 # Cooldown duration in seconds (if mode is set to COOLDOWN)

# Customizable messages (supports '&' color codes)
messages:
  limit-reached: "&cThe maximum limit of Maces for this server has been reached!"
  broadcast-reveal: "&8[&6Server&8] &a%player% &7has crafted a &5Mace&7!"
  broadcast-anonymous: "&8[&6Server&8] &7A &5Mace &7has just been crafted!"
  command-disabled: "&cThis command is currently disabled."
  no-owners: "&eNobody currently holds a Mace in their inventory (or it is stored in a chest)."
  owners-list: "&8[&5Mace&8] &7Current owner(s): &6%owners%"
  enderchest-blocked: "&cYou are not allowed to store the Mace in an Ender Chest!"
  mace-destroyed: "&8[&6Server&8] &cA Mace was destroyed! A new one can now be crafted."
  cooldown-active: "&cYour Mace is still on cooldown! Wait &e%seconds%s&c."

🕹️ Commands

/mace — Displays the current owner(s) of the Mace.