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 with scoreboard.persistent enabled their choice is kept across sessions.
The scoreboard is enabled by default. When PlaceholderAPI is not installed, the built-in placeholders are used instead. The scoreboard is not supported on Folia yet - it stays off there.
Commands
| Command | Description |
|---|---|
/scoreboard toggle |
Toggle the scoreboard sidebar on or off for yourself. |
/scoreboard reload |
Reload the scoreboard configuration from config.yml. |
/scoreboard status |
Show the current scoreboard status. |
Configuration
Scoreboard settings live under the scoreboard section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
scoreboard.enabled |
Boolean | true |
Enable or disable the scoreboard entirely. |
scoreboard.persistent |
Boolean | true |
Remember each player's /scoreboard toggle choice across relogs. |
scoreboard.update-interval |
Integer | 20 |
How often the scoreboard refreshes, in ticks. 20 ticks = 1 second. |
scoreboard.title |
String | <#279FF5><b>ꜱᴇʀᴠᴇʀɴᴀᴍᴇ |
The title shown at the top of the scoreboard. Supports MiniMessage. |
scoreboard.lines |
List | 11 entries | The lines displayed on the scoreboard, from top to bottom. Use "" for an empty line. |
config.yml
scoreboard: enabled: true update-interval: 20 title: "<#279FF5><b>ꜱᴇʀᴠᴇʀɴᴀᴍᴇ" lines: - "" - "<#279FF5><b>%player_name%:<reset>" - "<#279FF5><b>|<reset> <#9CD6FF>ʀᴀɴᴋ: <white>%luckperms_prefix%" - "<#279FF5><b>|<reset> <#9CD6FF>ʙᴀʟᴀɴᴄᴇ: <white>%vault_eco_balance_formatted%" - "<#279FF5><b>|<reset> <#9CD6FF>ᴋɪʟʟѕ: <white>%statistic_player_kills%" - "<#279FF5><b>|<reset> <#9CD6FF>ᴅᴇᴀᴛʜѕ: <white>%statistic_deaths%" - "<#279FF5><b>|<reset> <#9CD6FF>ʟᴀᴛᴇɴᴄʏ: <white>%player_ping%<#9CD6FF>ᴍꜱ" - "" - "<#279FF5><b>|<reset> <#9CD6FF>ᴏɴʟɪɴᴇ: <white>%server_online%<gray>/<white>%server_max_players%" - "<#279FF5><b>|<reset> <#9CD6FF>ᴛᴘꜱ: <white>%server_tps_1%" - "<#279FF5><b>|<reset> <#9CD6FF>ᴠᴇʀꜱɪᴏɴ: <white>%server_version%"
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.scoreboard.toggle |
Toggle the scoreboard on or off for yourself. | Everyone |
essentialsc.scoreboard.reload |
Reload the scoreboard configuration. | Operators |