> For the complete documentation index, see [llms.txt](https://buildsystem.eintosti.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://buildsystem.eintosti.de/v4/builder-tools/scoreboard.md).

# The Scoreboard

BuildSystem shows a sidebar with the current world's details. It refreshes once per second for every player who has it switched on.

***

## Turning It On and Off

Two switches control it, and both have to allow it:

| Switch                | Where        | Effect                                                                                  |
| --------------------- | ------------ | --------------------------------------------------------------------------------------- |
| `settings.scoreboard` | `config.yml` | Server-wide. Set to `false` and no one gets a sidebar, regardless of their own setting. |
| **Scoreboard** toggle | `/settings`  | Per player. Each builder decides for themselves.                                        |

Restrict who may switch it on with `buildsystem.setting.scoreboard`, which is granted by default. See [Player Settings](/v4/builder-tools/player-settings.md).

***

## Changing What It Says

The sidebar is two keys in `messages.yml`, not a config section. `title` is the heading, `body` is the list of lines below it.

```yaml
title: "&b&lBuildSystem"
body:
  - "&7&m                     &8"
  - "&7World:"
  - " &b%world%"
  - " "
  - "&7Status:"
  - " %status%"
  - "&7&m                     &7"
```

Add, remove, or reorder the `body` lines freely. Colour codes work as they do everywhere else, including hex.

{% hint style="info" %}
Minecraft limits a sidebar to **15 lines**. Anything past that is dropped silently, so keep `body` shorter than that.
{% endhint %}

***

## Available Placeholders

These are substituted into `title` and `body`. All of them describe the world the player is standing in.

| Placeholder      | Outputs                                                                |
| ---------------- | ---------------------------------------------------------------------- |
| `%world%`        | The world's name.                                                      |
| `%status%`       | The world's status, already coloured (for example a green *Finished*). |
| `%permission%`   | The permission required to enter, or `-` when unrestricted.            |
| `%project%`      | The project tag set with `/worlds setProject`, or `-`.                 |
| `%creator%`      | The name of whoever created the world, or `-`.                         |
| `%creation%`     | When the world was created.                                            |
| `%lastedited%`   | When a block was last changed.                                         |
| `%lastloaded%`   | When the world was last loaded.                                        |
| `%lastunloaded%` | When the world was last unloaded.                                      |

Dates use `settings.date-format` from `config.yml` (`dd/MM/yyyy` by default). A timestamp that was never set renders as `-`.

{% hint style="info" %}
Standing in a world BuildSystem does not manage is fine. Every placeholder except `%world%` falls back to `-` rather than leaving the sidebar blank.
{% endhint %}

### Placeholders From Other Plugins

If [PlaceholderAPI](/v4/reference/integrations.md) is installed, its placeholders work in `title` and `body` too, so you can mix in a rank, a balance, or a player count:

```yaml
body:
  - "&7World:"
  - " &b%world%"
  - " "
  - "&7Rank:"
  - " %vault_rank%"
```

BuildSystem substitutes its own placeholders first, then hands the line to PlaceholderAPI. BuildSystem's own values are also exposed *to* other plugins as `%buildsystem_..._%` placeholders, listed on the [Placeholders & Integrations](/v4/reference/integrations.md) page.

***

## Troubleshooting

**The sidebar does not appear.** Check `settings.scoreboard` is `true` in `config.yml`, then check the player's own **Scoreboard** toggle in `/settings`, then check they have `buildsystem.setting.scoreboard`.

**A placeholder shows as literal text**, for example `%creator%` instead of a name. That means the token is misspelled. Anything BuildSystem does not recognise is left exactly as written, so a typo shows through rather than disappearing.

**A line is missing.** You are likely over the 15-line sidebar limit.