# Configuration

### BalTop addon

```yaml
BalTop:
  delay: 200.0 # how often are online users refreshed (ticks, 1sec = 20 ticks)
  placeholder-delay: 10.0 # how often do placeholders refresh (seconds)
  offline-delay: 800.0 # in ticks (1 sec = 20) how often should it update offline users
  size: 10 # Size you can set it up to inf, just specifies how many placheolders.
  format: 1 # Format 1,2,3 (1 default), 2 = xxx.xxx.xxx, 3 = xx<k,m ...>
  excluded-users: # list of users that plugin doesnt count on baltop
  - name1
  - name2
  - name3
```

### BalTopV2 addon

```yaml
BalTopV2: #uses UUIDS instead of names.
  delay: 200.0 # how often are online users refreshed (ticks, 1sec = 20 ticks)
  placeholder-delay: 10.0 # how often do placeholders refresh (seconds)
  offline-delay: 800.0 # in ticks (1 sec = 20) how often should it update offline users
  size: 10 # Size you can set it up to inf, just specifies how many placheolders.
  format: 1 # Format 1,2,3 (1 default), 2 = xxx.xxx.xxx, 3 = xx<k,m ...>
  excluded-users: # list of users that plugin doesnt count on baltop
  - name1
  - name2
  - name3
```

### PlaceholderAPI addon

```yaml
placeholderAPI:
  delay: 1.0 # Refresh delay in seconds.
  placeholders:
  - '%server_countdown_dd.MM.yyyy_01.12.2020%' # List of placeholders you want to use
```

### ProtocolLib addon

No configuration.

Refesh placeholders

| Placeholder | Refresh interval |
| ----------- | ---------------- |
| {slow}      | 10 seconds       |
| {medium}    | 1 second         |
| {fast}      | 0.1 seconds      |

{% hint style="info" %}
Your PAPi placeholders don't refresh and you use ProtocolLib addon? Make sure to add one of the refresh placeholders in same line as PAPi placeholder.
{% endhint %}

### PlayTime addon

```yaml
PlayTime:
  update-delay: 4000.0 # How often should playtime be updated for online players (default 4000.0) in ticks
  placeholder-delay: 10.0 # How often are the placeholders updated.
  size: 10 # Size of top users.
  excluded-users: # list of users that plugin doesnt count on playtop
  - name1
  - name2
  - name3
```

### MultiPlaceholders addon

```yaml
placeholder-addons:
  '%statistic_deaths%':
    size: 10 # Size of placeholders 1-INF
    interval: 200.0 # interval in ticks (1 second = 20 ticks)
    value: number # number or time
    format: 1 # Format only works for number (same as baltop)
    signs: false # Updates sings?
    heads: false # Updates heads?
  '%statistic_seconds_played%':
    size: 10
    interval: 200.0
    value: number
    format: 1
    signs: true
    heads: true
```

{% hint style="warning" %}
This module is still in beta so if you find any bugs please report them to discord.
{% endhint %}
