The Scoreboard

The sidebar showing the world you are standing in.

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.

---

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.

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.

Minecraft limits a sidebar to 15 lines. Anything past that is dropped silently, so keep body shorter than that.

---

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 -.

Standing in a world BuildSystem does not manage is fine. Every placeholder except %world% falls back to - rather than leaving the sidebar blank.

Placeholders From Other Plugins

If PlaceholderAPI is installed, its placeholders work in title and body too, so you can mix in a rank, a balance, or a player count:

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 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.