# 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 %}


---

# 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:

```
GET https://wiki.virtusdevelops.eu/holograpicplaceholders/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.