HistoryX | GUI-based punishment history v2.0.0

A GUI based solution to moderation history. Making history viewing a seamless, elegant experience.

New Integrations​

  • BanManager support as a punishment extender
  • PlaceholderAPI expansion (%historyx_total%, %historyx_is_banned%, %historyx_active_ban_remaining%, etc.)

New Features​

  • Staff history GUI — /staffhistory <player> shows punishments issued by a staff member
  • Right-click to revoke — active punishments can be revoked directly from the GUI via AnvilGUI reason input → confirmation screen → console command dispatch
  • Punishment summary — player head item in both GUIs now shows per-type counts and total
  • Granular permissions — each command and action (historyx.history, historyx.staffhistory, historyx.extrainfo, historyx.revoke, historyx.reload) is independently configurable via config.yml

Configuration & Reliability​

  • Centralized message/config handling — all user-facing strings and settings go through a single Messages class with hardcoded fallbacks; no NPEs on missing keys
  • YAML validation on reload — config is validated before being applied; failures are reported without disrupting the running plugin
  • Configurable cache TTL — cache_ttl_seconds controls how long punishment history is cached per player
  • Config migration — old flat-key config format is automatically backed up and replaced with the new structure on startup

Performance & Maintainability​

  • Per-viewer GUI state (filter, sort, extra info) replaces previous global statics, eliminating race conditions between concurrent viewers
  • Countdown timer only updates slots with active temporary punishments rather than rebuilding the full inventory each tick
  • UUID→name resolution in staff history mode uses a per-viewer cache to avoid redundant Bukkit.getOfflinePlayer calls
Additions:
  • Added sorting to the GUI. You are now able to toggle easily between sorting by date ascending, descending, etc.
  • Implemented caching to reduce server strain and prevent lag
  • Added a refresh button to force data to latest available

Fixes & improvements:
  • Fixed multiple menus causing incorrect timings
  • Fixed multiple menus linking filtering and sorting options
  • Made code more efficient and scalable
  • Fixed an issue with update checker errors on start-up.
  • Cleaned-up code formatting and performance.
  • Introduced more documentation.

- Introduced base for future features.
Fixes:
  • Fixed an issue with warnings not filtering properly with LiteBans
  • Fixed an issue when LibertyBans doesn't initialise properly

Configuration updates:
  • Incorrect usage message is now configurable
  • Player head in the inventory is now configurable
  • Add full support for LibertyBans
  • Code optimisations
Version 1.0.7 introduces a few big additions and improvements.

Notes:
- EssentialsX is NOT able to be supported due to their system using vanilla punishments.

Additions:
  • The developer API is now available and ready to use. You can find this here: https://github.com/willrees23/historyx-api
  • An update checker is included in the plugin. You will now be notified if your version is out of date.
  • Lots of fixes, performance improvements, and feature enhancements.
  • Revamped internal system for supported plugins
  • Introduced better structure
  • Prepare for addition of EssentialsX (next update - 1.0.7!)
  • Improved support for LiteBans & AdvancedBan
- Should now experience smoother data fetching.
HistoryX 1.0.5 - Please update!

  • Fixes problem with lag when executing command of offline player
  • Small config changes
  • Message when fetching new player data
Buy a license now
$4.99
EULA
Standard EULA
Use on any projects you own with attribution
Support
Standard
Includes:
Download the resource
Access new updates
Support from the creator
Support duration
Lifetime
Share and earn
Refer this resource and earn a 10% commission.
2,672 Views
10 Purchases
15 Downloads
Feb 13, 2024 Published
Apr 8, 2026 Updated
5.00 star(s)
Average rating (3)
1.4 MB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Protection
  1. Staff
  1. GUI
Game mode
  1. Survival & SMP
  1. Hub & lobby
  1. Minigame
Game mode
  1. Survival
  1. Hub & lobby
  1. Minigame
Game mode (legacy)
  1. Survival
  1. Hub
  1. Minigame
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Sponge
  1. Bungee
Supported versions
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
  1. 1.17
  1. 1.16
  1. 1.15
  1. 1.14
  1. 1.13
  1. 1.12
  1. 1.11
  1. 1.10
  1. 1.9
  1. 1.8
  1. 1.7
Supported languages
  1. English
Includes DRM
No
Source access (legacy)
Closed source & unobfuscated
Creator
Owner
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,242 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,249 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,136 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,824 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,587 purchases
Share and earn
Refer this resource and earn a 10% commission.
2,672 Views
10 Purchases
15 Downloads
Feb 13, 2024 Published
Apr 8, 2026 Updated
5.00 star(s)
Average rating (3)
1.4 MB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Protection
  1. Staff
  1. GUI
Game mode
  1. Survival & SMP
  1. Hub & lobby
  1. Minigame
Game mode
  1. Survival
  1. Hub & lobby
  1. Minigame
Game mode (legacy)
  1. Survival
  1. Hub
  1. Minigame
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Sponge
  1. Bungee
Supported versions
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
  1. 1.17
  1. 1.16
  1. 1.15
  1. 1.14
  1. 1.13
  1. 1.12
  1. 1.11
  1. 1.10
  1. 1.9
  1. 1.8
  1. 1.7
Supported languages
  1. English
Includes DRM
No
Source access (legacy)
Closed source & unobfuscated
Creator
Owner
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,242 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,249 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,136 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,824 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,587 purchases
Top