TopLoeaderboard Remake

_______________________________________________________

Introduction

Are you looking for a professional way to showcase your server's top players? Look no further. TopLeaderboard v1.2 is a premium-quality, fully customizable leaderboard solution designed to be lightweight, efficient, and beautiful. Whether you run a PvP server, a Survival SMP, or an Economy-based Tycoon server, this plugin is built to handle it all.

Unlike other plugins that rely on clunky holograms or signs, TopLeaderboard provides a clean, interactive GUI (Graphical User Interface) that players can access anywhere with a simple command.

New in v1.2: Complete performance overhaul with lazy page loading, batched database transactions, and SkinsRestorer integration. We've also rebuilt the interaction engine with our new Slot-Based Action System — guaranteeing 100% reliable menu clicks across all versions!

_______________________________________________________

Visuals & In-Game Screenshots


_______________________________________________________

Extensive Feature List


1. Async Performance & Optimization

Performance is our #1 priority. TopLeaderboard performs all database queries, score calculations, and player lookups asynchronously. This means zero lag spikes on your main thread, even if you have thousands of players in your database.

• Folia Support: Native support for Folia's region-based threading.
• Smart Caching: Leaderboards are cached and only refreshed at your configured interval.
• Lazy Page Loading: Only loads the 45 players on the page you're viewing — not the entire database.
• Batched Transactions: All DB writes wrapped in a single transaction for 10-50x faster I/O.
• WAL Mode: SQLite uses Write-Ahead Logging for better concurrent read performance.

2. 7 Unique Leaderboard Types

Track virtually every aspect of gameplay with built-in statistics:

• Top Kills: Show who dominates the PvP arena.
• Top Deaths: A fun "wall of shame" for survival fails.
• Top Balance: Integration with Vault to display the richest players.
• Top Playtime: Reward loyalty by showing who plays the most.
• Top Mobs Killed: Perfect for PvE/SMP servers.
• Top Blocks Broken: Tracks mining dedication (stored via SQLite).
• Top Blocks Placed: Celebrate your server's builders (stored via SQLite).

3. Advanced GUI System

• Interactive Menu: A beautiful chest interface to select categories.
• Paginated Results: Supports unlimited pages! Click "Next" to see ranks #46-90 and beyond.
• Player Heads: Automatically displays the skin/head of each player on the leaderboard.
• Skin Caching: Player skins are cached locally — no Mojang API rate limiting (429 errors).
• SkinsRestorer Support: Uses SkinsRestorer API if installed, with automatic fallback.
• Sound Effects: Satisfying UI click sounds for better user experience.

4. Hybrid Storage System

We use the best storage method for each task:

• Native Stats: Uses Minecraft's internal statistic tracking for zero-overhead data.
• SQLite Database: Uses a local database for all stats to ensure fast lookups and offline player support.
• Auto Migration: Automatically migrates old data.yml to SQLite on first run.

5. 100% Customizable

• Every message, item name, lore line, inventory title, and material is editable in config.yml.
• Hex Colors: Full support for &#RRGGBB color codes.
• Layout Control: Move items to any slot you want.
• Placeholders: Use %rank%, %player_name%, and %score% anywhere.

6. PlaceholderAPI Support

Use leaderboard data anywhere — scoreboards, holograms, tab lists, and more!

_______________________________________________________

Commands

Permissions

_______________________________________________________

Soft Dependencies

• Vault — Required for Balance leaderboard
• PlaceholderAPI — Required for placeholder support
• SkinsRestorer — Optional, for improved skin display

_______________________________________________________

Compatibility

• Spigot 1.8 - 1.21+
• Paper
• Folia
• Java 16+

_______________________________________________________

Support & Suggestions

We are active developers! If you find a bug or have a request:

1. Post in the Discussion tab.
2. Send us a PM on SpigotMC.