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

# Configuration

BetterBaltop's settings are stored in:

```
plugins/BetterBaltop/config.yml
```

The default configuration is:

```yaml
leaderboard:
  refresh-interval-seconds: 300
  accounts-per-tick: 50
  maximum-entries: 500
  show-zero-balances: false

gui:
  click-sounds: true
```

### Leaderboard settings

#### `refresh-interval-seconds`

How often BetterBaltop starts rebuilding its cached leaderboards. The default `300` means every five minutes.

Allowed range: `10` to `86400` seconds.

#### `accounts-per-tick`

How many known player accounts are checked per server tick when building the Vault economy leaderboard.

The default `50` is a good choice for most servers. Lower this value if your economy provider is unusually slow. Raising it makes refreshes finish sooner but performs more economy lookups during each tick.

Allowed range: `1` to `1000`.

#### `maximum-entries`

The maximum number of ranked players kept in each leaderboard cache.

The default is `500`. This limit applies to both Vault balances and PlayerPoints.

Allowed range: `1` to `10000`.

#### `show-zero-balances`

Controls whether players with exactly zero money or points are displayed.

* `false`: hide exact zero values
* `true`: include exact zero values

Negative balances are supported and are not removed by this setting.

### GUI settings

#### `click-sounds`

Controls the quiet button sound used when changing pages or switching leaderboard types.

* `true`: play menu click sounds
* `false`: disable menu click sounds

### Applying changes

After editing `config.yml`, use PlugManX to disable and enable BetterBaltop, or restart the server. The configuration is read again when BetterBaltop enables.

If a value is missing, has the wrong type, or is outside its allowed range, BetterBaltop uses a safe default and lists the invalid path in the console.


---

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