History / Logs
QuantumPunish features a Dual-Layer History System, allowing staff to review player records via a sleek Graphical User Interface (GUI) or a fast, interactive Chat-based list.
1. Paginated History GUI
Command: /history gui <player>
The GUI provides a visual overview of a player's past behavior. It is highly customizable via history.yml.
Dynamic Icons: Each punishment type uses a specific material defined in the config (e.g.,
RED_WOOLfor Bans,ORANGE_WOOLfor Mutes).Detailed Lore: Hover over any item to see the Staff member, Reason, Date, and the Initial Duration (the original timeframe set by the moderator).
Center Stats (Info Item): The bottom-center item displays the player's UUID, total punishment count, and current active warning points.
Smart Navigation: Navigation arrows (
previous-page&next-page) automatically appear if a player has more than 45 records.
2. Interactive Chat History
Command: /history <player> [page]
Designed for speed, the chat-based history provides a "clickable" experience managed via messages.yml.
Hover Tooltips: Hover your cursor over any punishment line to reveal detailed info (Type, Staff, Date, Duration, and Reason).
Smart Pagination: Use clickable
[PREV]and[NEXT]buttons at the bottom of the chat to flip through pages without re-typing commands.Initial Duration Tracking: Displays the original duration (e.g.,
10m,1d,Permanent) so admins can review past sentencing.
🎨 Configuration (history.yml)
history.yml)You can fully customize the GUI's appearance. Below are the key sections you can modify:
Punishment Item Lore
You can use the following placeholders in the punishment-item lore:
%type%: Punishment type (BAN, MUTE, etc.)%player%: The target player name.%staff%: The moderator who issued the punishment.%reason%: The reason for the punishment.%date%: Timestamp of the event.%duration%: The original duration (e.g.,1h 30m).
Custom Materials
Map specific Minecraft materials to punishment types to make the GUI intuitive:
Last updated