VkMaceControl – Advanced Mace Craft Limit, Lock & Anti-Dupe (1.21+)

VkMaceControl – Advanced Mace Crafting Control & Anti-Exploit Plugin
VkMaceControl is a powerful and exploit-proof Paper plugin designed to give server owners full control over Mace crafting in Minecraft 1.21+.
It is built specifically to prevent abuse, duplication, and unfair progression while providing clear player feedback, live tracking, and administrative control.

This plugin is ideal for SMPs, events, hardcore worlds, and competitive servers where Mace crafting must be limited, monitored, or temporarily disabled.

✨ Key Features
Global Mace Craft Limit

• Set a global maximum number of Maces that can ever be crafted.
  
  
• Once the limit is reached, Mace crafting is completely blocked for all players.
  
  
• Players with a bypass permission can still craft if required

Timed & Manual Craft Locks

• Lock Mace crafting using /vkmace lock <time> <reason>.
  
  
• Supports timed locks (minutes / hours).
  
  
• Lock reason is stored and displayed.
  
  
• When the timer ends, Mace crafting is automatically unlocked with a server-wide title announcement.
  

Full Exploit Protection (Zero Bypasses)
VkMaceControl blocks Mace crafting from ALL methods:

• Crafting Table
  
  
• Inventory (2×2 crafting grid)
  
  
• Recipe Book
  
  
• Crafter block (auto-crafting)
  

Shift-click crafting is explicitly disabled to prevent infinite crafting exploits.

Live BossBar Tracking

• When a Mace is crafted, a BossBar appears for all players.
  
  
• Displays:
  
  • Player name
    
    
  • Real-time coordinates
    
• Coordinates update every 30–40 seconds.
  
  
• Tracking automatically ends after a configurable duration.
  

Titles, Sounds & Feedback

• Title & subtitle announcements on:
  
  • Successful Mace craft
    
    
  • Blocked crafting attempts
    
• Separate messages for:
  
  • Crafting locked
    
    
  • Crafting maxed
    
    
  • Shift-click crafting disabled
    
• Optional sound effects for clear player feedback.
  

All messages are fully configurable via config.yml.

Anti-Dupe & Abuse Logging

• Logs every blocked or suspicious craft attempt.
  
  
• Shows the real reason (LOCKED / MAXED / SHIFT DISABLED).
  
  
• Logs are sent to:
  
  • Server console
    
    
  • Online OP players
    
    
  • Discord (via webhook)
    

Discord Webhook Integration

• Optional Discord alerts for:
  
  • Blocked Mace crafting
    
    
  • Auto-Crafter abuse attempts
    
• Runs asynchronously (no server lag).
  
  
• No external libraries required.

Persistent & Restart-Safe

• Uses SQLite for data storage.
  
  
• Saves:
  
  • Total Maces crafted
    
    
  • Lock status
    
    
  • Lock reason
    
    
  • Lock timer
    
• Data persists across server restarts and crashes.
  

⚙ Admin Commands

• /vkmace – Interactive help menu (clickable & hoverable)
  
  
• /vkmace help – Show help
  
  
• /vkmace status – View current crafting status
  
  
• /vkmace lock <time> <reason> – Lock Mace crafting
  
  
• /vkmace unlock – Unlock crafting
  
  
• /vkmace reset – Reset craft counter
  
  
• /vkmace reload – Reload configuration

Permissions

• vkmace.admin – Full admin access
  
  
• vkmace.bypass – Bypass all crafting restrictions

⚙ Configuration

• BossBar text
  
  
• Titles & subtitles
  
  
• Sounds
  
  
• Lock & block messages
  
  
• Help menu text
  
  
• Anti-dupe behavior
  
  
• Discord integration
  

Everything is configurable via config.yml — no recompiling needed.

✅ Compatibility

• Minecraft: Java Edition 1.21+
  
  
• Server: Paper, Purpur, Pufferfish
  
  
• Java: Java 21
  
  
• Dependencies: ❌ None required

Why Use VkMaceControl?

• Prevents Mace duplication exploits
  
  
• Ensures fair progression
  
  
• Provides clear player feedback
  
  
• Gives admins full control
  
  
• Lightweight, stable, and production-ready

VkMaceControl gives you absolute authority over Mace crafting while keeping gameplay fair, transparent, and exploit-free.