Scoreboard
A configurable per-player sidebar scoreboard with MiniMessage and PlaceholderAPI support.
Overview
EssentialsC can display a sidebar scoreboard to each player, updated on a fixed interval. The title and lines support MiniMessage formatting and PlaceholderAPI placeholders. Players can toggle the scoreboard on or off individually, and their preference persists across sessions.
The scoreboard is disabled by default. Enable it by setting
scoreboard.enabled to true in config.yml.
Commands
| Command | Description |
|---|---|
/scoreboard toggle |
Toggle the scoreboard sidebar on or off for yourself. |
/scoreboard reload |
Reload the scoreboard configuration from config.yml. |
Configuration
Scoreboard settings live under the scoreboard section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
scoreboard.enabled |
Boolean | false |
Enable or disable the scoreboard entirely. |
scoreboard.update-interval |
Integer | 20 |
How often the scoreboard refreshes, in ticks. 20 ticks = 1 second. |
scoreboard.persistent |
Boolean | true |
Remember each player's toggle preference across sessions. |
scoreboard.title |
String | <gold><bold>MyServer</bold></gold> |
The title shown at the top of the scoreboard. Supports MiniMessage. |
scoreboard.lines |
List | [] |
The lines displayed on the scoreboard, from top to bottom. Supports MiniMessage and PlaceholderAPI placeholders. |
config.yml
scoreboard: enabled: true update-interval: 20 persistent: true title: "<gold><bold>MyServer</bold></gold>" lines: - "<gray>Player: <white>%player_name%" - "<gray>Balance: <white>%essc_balance_formatted%" - "<gray>Online: <white>%online%" - "<gray>Ping: <white>%player_ping%ms"
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.scoreboard.toggle |
Toggle the scoreboard on or off for yourself. | Everyone |
essentialsc.scoreboard.reload |
Reload the scoreboard configuration. | Operators |