MaceControl

MaceControl

Advanced Mace Management & Tracking System

Version 0.9.2 | MC Version 1.21+ | Platform: Paper

Overview

Limit the max number of maces on the server, prevent the mace from being placed into containers and much more.

Key Features:

• Mace Limits: Configurable mace count limits (default: 5 total server-wide)
• Storage Prevention: Prevents placing maces into chests, bundles, and item frames
• Placement Blocking: Blocks mace storage via armor stands or item display entities
• Player Tracking: Monitors maces across online/offline players and dropped items
• Auto-Cleanup: Automatically frees slots when maces are destroyed or lost to void
• Heavy Core Control: Prevents automation abuse by blocking heavy cores in auto-crafters
• World Restrictions: Configure crafting permissions per world
• Permission System: Full admin bypass and control permissions
• Auto-Save: Configurable automatic data saving
• Notifications: Optional server broadcast messages for mace events

Commands & Permissions

Commands

• /mace - View current mace holders (Available to all players)
• /droppedmace - View all dropped maces on the server (Admin only)
• /macereload - Reload plugin configuration (Admin only)

Permissions

• macecontrol.bypass - Bypass all mace restrictions and limits
• macecontrol.admin - Access to admin commands and dropped mace viewing

Configuration

# ========================================
#          MACECONTROL CONFIG
# ========================================

# === CORE SETTINGS ===
max-mace-count: 5
mace-command-cooldown: 5 # in seconds

# === PERMISSIONS ===
# Who can bypass mace limits and restrictions
bypass-permission: "macecontrol.bypass"
admin-permission: "macecontrol.admin"

# === RESTRICTIONS ===
restrictions:
  # Prevent maces from being put in containers
  block-containers: true
 
  # Prevent maces from being put on armor stands
  block-armor-stands: true
 
  # Prevent maces from being put in item frames
  block-item-frames: true
 
  # Prevent maces from being put in bundles
  block-bundles: true
 
  # Prevent heavy cores from being put in auto crafters
  block-heavy-core-autocrafter: true
 
  # Allow maces in ender chests (since they're player-specific)
  allow-ender-chest: false
 
  # Allow maces in shulker boxes
  allow-shulker-boxes: false

# === WORLD SETTINGS ===
worlds:
  # Worlds where mace crafting is allowed (empty = all worlds)
  allowed-craft-worlds: []
 
  # Worlds where mace restrictions apply (empty = all worlds)
  restricted-worlds: []

# === NOTIFICATIONS ===
messages:
  # Broadcast when a mace is destroyed/lost
  broadcast-destruction: true
 
  # Notify when someone crafts a mace
  broadcast-craft: true

# === AUTO-SAVE ===
auto-save:
  enabled: true
  interval: 300 # seconds (5 minutes)

Server Requirements

• Minecraft 1.21 or higher
• Paper server software (Bukkit and Spigot also supported)
• Java 17 or higher

Installation

Download the plugin, drop it in your plugins folder, and restart your server. The plugin will automatically generate its configuration file at plugins/MaceControl/config.yml which you can customize as needed. Use /macereload to apply config changes without restarting.

⚠️ Plugin in BETA ⚠️

Report bugs or suggestions to help improve MaceControl!

Perfect for servers wanting to keep maces rare and valuable!