Appeal System

QuantumPunish features a centralized Appeal Management System, allowing staff to review and resolve player requests through a streamlined, real-time Graphical User Interface (GUI).

📋 Overview

Command: /quantumpunish appeals Permission: quantumpunish.staff (or quantumpunish.admin)

This system bridges the gap between staff and penalized players, providing a professional way to handle "unmute" or "unban" requests without messy manual database lookups.

✨ Key Features

• Real-Time GUI Updates: The interface uses an "Instant-Refresh" logic. Once an appeal is approved or rejected, the item is immediately removed from the view to prevent double-processing.

• Player Head Identification: Each request is displayed as the player's head, making it intuitive for staff to identify the appellant at a glance.

• Smart Tooltips: Hover over any request to view the appellant's reason and the exact timestamp of their submission.

• One-Click Actions: * Left-Click: Approve the appeal (Auto-unmute/unban the player).

  • Right-Click: Reject the appeal (Decline the request).

• Empty State Handling: If no appeals are pending, a central Barrier icon appears with the message "No Pending Appeals," letting staff know the queue is clear.

🎨 Configuration (appeals.yml)

You can fully customize the appearance of the appeals menu. Below are the key placeholders available for the lore:

• %player%: The name of the appellant.

• %date%: The timestamp of the appeal submission.

• %reason%: The reason provided by the player.

• %total%: Total number of pending requests (used in stats-item).

Default Stats Item: By default, a BOOK is placed at the bottom-center (Slot 49) to display live appeal statistics.