> 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/messages.md).

# Messages

Player-facing text is stored in:

```
plugins/BetterBaltop/messages.yml
```

You can customize:

* Command replies
* Economy and points menu titles
* Player-head names and lore
* Top-three descriptions
* Previous and next page buttons
* Economy and PlayerPoints switch buttons
* Loading, empty, and unavailable states
* Leaderboard information text

### MiniMessage formatting

BetterBaltop uses MiniMessage. Basic examples include:

```
<red>Red text</red>
<gold><bold>Bold gold text</bold></gold>
<#55ffff>Custom hex color</#55ffff>
```

MiniMessage documentation is available at [docs.papermc.io/adventure/minimessage](https://docs.papermc.io/adventure/minimessage/format/).

### Available placeholders

Keep placeholders inside angle brackets exactly as written.

#### Leaderboard entries

* `<rank>` — the player's numbered position
* `<player>` — the player's name
* `<balance>` — the Vault-formatted balance
* `<points>` — the formatted PlayerPoints amount
* `<amount>` — the current source's formatted value

#### Page controls and titles

* `<page>` — the current page or destination page

#### Information item

* `<page>` — current page
* `<pages>` — total pages
* `<entries>` — number of cached entries
* `<source>` — leaderboard source name
* `<updated>` — last successful update time

#### Refresh result

* `<started>` — sources whose refresh started
* `<running>` — sources already refreshing
* `<unavailable>` — requested sources that are not available

#### Status line

* `<source>` — source name
* `<state>` — current state
* `<entries>` — cached entry count
* `<updated>` — last successful update time

{% hint style="warning" %}
Do not remove required placeholders unless you intentionally want to hide that information. Player names and formatted amounts are inserted safely and cannot add their own MiniMessage formatting.
{% endhint %}

### Safe upgrades

BetterBaltop does not overwrite your existing `messages.yml`. When an update adds a new message path, the bundled value is used as a fallback. This lets customized files continue working without showing missing-message warnings.

After editing messages, disable and enable BetterBaltop with PlugManX or restart the server.


---

# 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/messages.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.
