Active Punishment

The Active Punishment Oversight is a powerful management tool that gives staff a "Live Feed" of every active sanction currently enforced on the server.

📋 Overview

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

Unlike the History system which shows all past records, this GUI filters out everything except currently active bans and mutes.

✨ Key Features

  • Focused Monitoring: Displays only sanctions that are still in effect. Once a punishment expires or is removed, it automatically disappears from this list.

  • Dynamic Information: Shows critical data such as the issuing Staff, the Reason, and a live countdown of the Remaining Time.

  • Quick Management: Staff can Right-Click any active punishment item to instantly "Unpunish" (pardon) the player directly from the menu.

  • Automatic Pagination: If your server has a large number of active punishments (45+), the system generates navigation arrows automatically.

  • Status Tracking: The GUI uses a BEACON icon at the bottom-center to show the total count of active punishments and the current server time.

🎨 Configuration (active.yml)

The Active GUI is highly customizable to fit your server's theme.

Available Placeholders:

  • %player%: The punished player's name.

  • %type%: The type of punishment (BAN, MUTE, etc.).

  • %staff%: The moderator who issued the sanction.

  • %reason%: The reason for the punishment.

  • %remaining%: Dynamic countdown of the remaining duration.

  • %time%: Current server system time.

Default Visuals: The GUI uses Player Heads for each entry to ensure staff can quickly identify active cases.

Last updated