VkMaceControl

🔨 VkMaceControl – Advanced Mace Crafting Control & Anti-Abuse System

VkMaceControl is a powerful and production-ready Paper plugin designed to fully control, monitor, and restrict Mace crafting on Minecraft servers running Paper 1.21+.
It is built for SMPs, competitive servers, events, and custom gameplay modes where Mace crafting must be limited, tracked, or completely locked to prevent abuse, duplication, or unfair advantages.

This plugin ensures zero exploits, blocks all crafting methods (crafting table, player inventory crafting, and the new auto-Crafter block), and provides real-time tracking with boss bars, titles, logs, and Discord alerts.

✨ Core Features

🪓 Mace Craft Limiting

• Set a global maximum number of Maces that can ever be crafted.
• Once the limit is reached, crafting is permanently blocked for all players.
• Only players with a bypass permission can continue crafting after the limit.

🔒 Timed & Manual Craft Lock

• Lock Mace crafting at any time using /vkmace lock <time> <reason>.

• Supports timed locks (minutes, hours, days).

• Lock reason is shown:

  • In BossBar
  • In status command

• Crafting is instantly blocked during a lock.

📊 Real-Time Tracking System

• When a Mace is crafted:

  • A BossBar shows the player’s name and coordinates.
  • Coordinates update every 30–40 seconds.
  • Tracking lasts up to 5 minutes per craft.

• All text is fully configurable in config.yml.

🏷 Titles & Chat Announcements

• Global Title & Subtitle alerts when a Mace is crafted.

• Displays:

  • Player name
  • Coordinates
  • Crafted count
  • Remaining Maces

• Messages are 100% editable from config.

🧱 Full Crafting Protection (No Exploits)

VkMaceControl blocks Mace crafting from:

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

There is no way to bypass the system without permission.

🛡 Anti-Dupe & Abuse Detection

• Logs every blocked or suspicious craft attempt.

• Anti-dupe logs include:

  • Player / source
  • World & coordinates
  • Reason (locked, max limit reached, auto-crafter attempt)

Logging Destinations:

• Server console
• Online OP players (live alerts)
• Discord webhook (optional)

🌐 Discord Webhook Integration

• Send real-time alerts to Discord for:

  • Blocked crafting attempts
  • Auto-crafter abuse

• Fully configurable and async (no server lag).

📂 Persistent Data Storage

• Uses SQLite database.

• Saves:

  • Total Maces crafted
  • Lock state
  • Lock reason
  • Lock expiry time

• Data survives server restarts & crashes.

⚙ Powerful Command System

Main Commands

• /vkmace → Shows help
• /vkmace help → Configurable help menu
• /vkmace status → View current craft & lock status
• /vkmace lock <time> <reason> → Lock crafting
• /vkmace unlock → Unlock crafting
• /vkmace reset → Reset mace craft counter
• /vkmace reload → Reload config

Permissions

• vkmace.admin → Full access
• vkmace.bypass → Ignore all restrictions

🧾 Fully Configurable

• BossBar text
• Title & subtitle
• Help menu
• Status messages
• Anti-dupe settings
• Discord alerts
  All configurable via config.yml — no recompiling needed.

🚀 Technical Details

• ✔ Paper 1.21+
• ✔ Java 21
• ✔ Maven-based
• ✔ Async Discord handling
• ✔ No deprecated APIs
• ✔ Optimized & lightweight

🎯 Ideal Use Cases

• SMP servers
• Event-based servers
• Hardcore worlds
• Competitive gameplay
• Custom progression systems
• Anti-exploit environments

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