StatsPlugin v2.0.0

A major update from v1.0 with significant improvements to accuracy, security, performance, GUI/UX, and functionality.

This update fixes several important bugs and security-related issues while completely redesigning the statistics GUI and adding leaderboards, permissions, PlaceholderAPI support, and bStats integration.

Bug Fixes & Security

Fixed statistics being one update behind

Fixed an issue where Database.add() inserted new player statistics with a value of 0 on the first increment.

As a result, the player's first block placement, block break, or other tracked action was not counted.

The UPSERT logic has been fixed so the first action is now recorded correctly.

Fixed cancelled actions being counted

BlockBreakEvent and BlockPlaceEvent did not check whether the event had been cancelled.

This caused actions cancelled by plugins such as WorldGuard to still be counted in statistics.

The listeners now use ignoreCancelled = true, so cancelled events are ignored.

Fixed possible main-thread freezes

/stats <name> previously used Bukkit.getOfflinePlayer(String) synchronously.

For uncached player names, this could trigger communication with the Mojang API on the main server thread, potentially causing a temporary server freeze.

Player name resolution has been moved to an asynchronous process.

Improved SQL query safety

Several database operations previously concatenated column names directly into SQL strings.

This has been replaced with a StatColumn enum whitelist system, ensuring that user input can never be directly inserted into SQL column names.

This significantly improves the overall safety of the database layer.

Fixed database resource leaks

Connection, PreparedStatement, and ResultSet objects were not being properly closed in v1.0.

The database implementation now uses try-with-resources, and database connections are properly closed when the plugin is disabled.

Fixed offline player statistics

Although v1.0 advertised offline player support, Kills, Deaths, Playtime, and Mob Kills were only displayed when the target player was online.

The plugin now uses OfflinePlayer.getStatistic() so statistics can be displayed even when the player is offline.

Fixed non-functional money statistics

Money Spent on Shop and Money Made on /sell were previously displayed as 0 because the functionality was never actually implemented.

This has been replaced with a real system that periodically tracks Vault balance changes using StatSyncTask.

The statistics are now:

• Money Earned
• Money Spent

Improved GUI event handling

The GUI previously identified itself by checking whether the inventory title contained "Stats".

This could potentially cause inventories from other plugins with similar titles to be intercepted.

The plugin now uses a dedicated InventoryHolder implementation to reliably identify its own GUI.

Inventory dragging is also prevented inside the statistics GUI.

UI / UX Improvements

Completely redesigned statistics GUI

The old 27-slot GUI has been replaced with a new 45-slot decorated interface.

The new GUI includes:

• Decorative borders
• Player head display
• Refresh button
• Close button
• Leaderboard button

The statistics interface is now much more polished and easier to navigate.

Migrated to Adventure Component API

The legacy ChatColor API has been removed.

The plugin now uses Paper's recommended Adventure Component API for modern text and formatting support.

New Features

Server-wide leaderboards

Added:

/stats top [stat]

This opens a server-wide leaderboard GUI.

Features include:

• Statistics category switching
• Player ranking display
• Click a player to view their statistics
• Server-wide rankings

Permission system

Added permission nodes:

• statsplugin.use
• statsplugin.others
• statsplugin.top
• statsplugin.reload

These allow server administrators to control access to different parts of the plugin.

Command tab completion

Added tab completion for the /stats command.

PlaceholderAPI support

Added optional PlaceholderAPI integration.

Example:

%statsplugin_kills%

Additional statistics are also available through PlaceholderAPI.

bStats support

Added optional bStats integration for anonymous plugin usage statistics.

bStats can be disabled through the plugin configuration.

Summary

StatsPlugin v2.0.0 is a major rewrite and improvement over v1.0.

This release focuses on:

• More accurate statistics
• Better database safety
• Improved performance
• Better handling of offline players
• Improved event handling
• A completely redesigned GUI
• Server-wide leaderboards
• Permissions
• PlaceholderAPI integration
• bStats integration
• Modern Adventure API support

StatsPlugin is now more secure, reliable, and feature-complete for production Minecraft servers.