sBalTop - balance Top Plugin With Gui icon

sBalTop - balance Top Plugin With Gui -----

add balance top gui and functions in your game server




New Features
  • 100% Asynchronous: The core process of fetching and sorting all player balances is done on a separate thread, guaranteeing zero lag on the main server thread, even with tens of thousands of players.

  • Fully Customizable GUI:
    • Configure the title, size (number of rows), and all items within the GUI.

    • Use special placeholders like {rank}, {player_name}, {balance_formatted}, and even {vault_prefix} and {vault_suffix} in item names and lore.

    • Interactive Clicks: Configure commands to be run when a player clicks on another player's head in the menu. Commands can be run by the clicking player or by the console.
  • Advanced Paginated Menu: The GUI automatically creates pages so you can display an unlimited number of top players in a clean, organized way.

  • Data Persistence (Instant Startup):
    • The leaderboard cache is intelligently saved to a file (baltop-cache.dat) on server shutdown.

    • On startup, this cache is loaded instantly, making /baltop available immediately without waiting for the first refresh.
  • Deep Admin Control: A comprehensive set of subcommands allows administrators to manage every aspect of the plugin live, from reloading the config to changing the update speed and exporting data.

  • Powerful Integrations:
    • Vault: Required for fetching player balances from any economy plugin (like EssentialsX, CMI, etc.). Also hooks into Vault's Chat provider to fetch player prefixes and suffixes from permission plugins like LuckPerms.

    • PlaceholderAPI: Provides a full set of placeholders to use sBalTop data in any other plugin that supports PAPI (like scoreboards, tablists, and menus).
  • Customizable Sound Effects: Configure unique sounds for opening the GUI, clicking navigation buttons, and clicking on player heads to create a more immersive user experience.

  • Lightweight & Optimized: The plugin is built with modern Java 17 and PaperMC's API for maximum efficiency and minimal resource usage.


New Commands
Player Commands
These are the commands available to regular players with the correct permissions.

Command Description Permission
/baltop <br> /balancetop Opens the main graphical balance top menu. sbaltop.use
Admin Commands
The main administrative command is /sbaltop (alias: /sbt). All admin commands require the permission sbaltop.admin.

Command Description
/sbaltop help Displays a list of all available admin commands.
/sbaltop reload Reloads all settings from the config.yml file and restarts the update task with the new interval.
/sbaltop refresh Manually forces the plugin to start an asynchronous leaderboard update in the background.
/sbaltop info Shows key statistics: plugin version, number of cached players, the last update time, and the current update interval.
/sbaltop version Displays the current plugin version and author information.
/sbaltop lookup <player> Checks the specific rank and balance of any player (online or offline) who is on the leaderboard.
/sbaltop resetcache Completely clears the in-memory cache and deletes the baltop-cache.dat file from disk, then forces a refresh.
/sbaltop setinterval <seconds> Changes the leaderboard update interval on-the-fly without needing a full reload.
/sbaltop export [amount] Exports the top players (default 100) to a simple text file located at /plugins/sBalTop/export.txt.



PlaceholderAPI Placeholders
If you have PlaceholderAPI installed, you can use the following placeholders in other plugins:

  • %sbaltop_name_<rank>%
    • Displays the name of the player at the specified rank.

    • Example: %sbaltop_name_1% -> Shows the name of the #1 richest player.
  • %sbaltop_balance_formatted_<rank>%
    • Displays the formatted balance (e.g., "1,234,567.89") of the player at the specified rank.

    • Example: %sbaltop_balance_formatted_1% -> Shows the balance of the #1 richest player.
----------, Nov 16, 2025

Resource Information
Author:
----------
Total Downloads: 102
First Release: May 31, 2025
Last Update: Nov 16, 2025
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings