> For the complete documentation index, see [llms.txt](https://docs.cheddah-development.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cheddah-development.net/plugin-documentaion/better-baltop.md).

# Better Baltop

BetterBaltop is a fast, polished GUI leaderboard for Paper servers. Instead of showing a long list in chat, `/baltop` opens an easy-to-browse menu with player heads, ranked balances, special styling for the top three players, and simple page controls.

BetterBaltop connects to your server's economy through Vault. If PlayerPoints is installed, players can also switch between the economy and points leaderboards directly inside the same menu. The switch appears automatically when PlayerPoints is available.

Leaderboards are safely refreshed and cached in the background, keeping the menu responsive even as your server grows. Server owners get straightforward configuration, customizable MiniMessage text, useful status tools, and manual refresh commands without unnecessary setup.

### Highlights

* Simple `/baltop` menu for players
* Player heads with special styling for the top three positions
* Vault economy support
* Optional PlayerPoints leaderboard
* Fast cached results that do not refresh every time the menu opens
* Safe manual refresh and status commands for administrators
* Beginner-friendly configuration and customizable MiniMessage text
* Clean PlugManX disable and enable support

### Requirements

* Paper `26.2`
* Java `25`
* Vault
* A Vault-compatible economy plugin
* PlayerPoints `3.3.5` or a compatible 3.x version (optional)

{% hint style="info" %}
Vault is required, along with a Vault-compatible economy plugin. PlayerPoints is completely optional.
{% endhint %}

Use the pages in this section to install BetterBaltop, configure the leaderboard, customize its appearance, manage permissions, and troubleshoot common issues.

Start with Installation, then review Commands and permissions and Configuration.

### Support

Found a bug or have a feature suggestion? Use the [BetterBaltop issue tracker](https://github.com/Cheddah01/Better-Baltop/issues).