> 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).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cheddah-development.net/plugin-documentaion/better-baltop.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.