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 `. 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 ` → 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.