Features
Scoreboard
Configure the sofyCore sidebar scoreboard with boards per permission and world, animated titles, placeholders and hex colors.
The scoreboard module shows a sidebar with player information. Boards, texts and refresh speed live in scoreboard.yml. It stores nothing in Redis or the database: every value comes from placeholders that answer from memory.
Enabling
modules:
scoreboard:
enabled: trueThen run /sofycore module scoreboard reload. If scoreboard.yml has an error, the module stays in FAILED and the console names the wrong key.
scoreboard.yml
| Key | Description |
|---|---|
update-ticks | Ticks between line refreshes per player (2–200; 20 = 1 second) |
title-ticks | Ticks between title frames (1–200) |
hide-numbers | Hides the red numbers (1.20.3+ clients only) |
disabled-worlds | Worlds without a sidebar |
date-format, time-zone | Format of the date token and its time zone |
state-text.on / off | Text of the vanish and staff mode tokens |
boards | Boards, checked from top to bottom; the first match is shown |
Each board has permission (empty for everyone), worlds (empty for all), a title (one text, or a list of frames for an animated title) and 1–15 lines.
Default boards
boards:
staff:
permission: sofycore.scoreboard.staff
worlds: []
title: '&c&lSTAFF &7| &fsofyCore'
lines:
- '&7&m-------------------'
- '&fStaff: &c{player}'
- '&fRank: &r%sofycore_rank_name%'
- ''
- '&fVanish: {vanish}'
- '&fStaff mode: {staffmode}'
- '&fOpen reports: &e%sofycore_mod_reports_open%'
- ''
- '&fServer: &b{server}'
- '&fNetwork: &a%sofycore_online_network%'
- '&7&m-------------------'
- '&bexample.com'
default:
permission: ''
worlds: []
title:
- '&b&lSOFY&f&lCORE'
- '&3&lSOFY&b&lCORE'
- '&f&lSOFY&3&lCORE'
lines:
- '&7{date}'
- ''
- '&fPlayer: &b{player}'
- '&fRank: &r%sofycore_rank_name%'
- '&fPlaytime: &e%sofycore_playtime%'
- '&fVIP points: &6%sofycore_vippoints%'
- ''
- '&fServer: &b{server}'
- '&fOnline: &a%sofycore_online_network%'
- ''
- '&bexample.com'Text processing
Each line and title is processed in this order:
- Module tokens:
{player},{displayname},{world},{server},{date},{vanish},{staffmode}. - sofyCore placeholders
%sofycore_<key>%, without PlaceholderAPI. If the module that answers is off, the value is empty. - Colors:
&a,&l... and&#RRGGBB(1.16+ clients; older ones see the closest classic color). - PlaceholderAPI, if installed and any
%...%remains.
Performance
The sidebar is drawn with per-player packets through the bundled, relocated scoreboard-library, so the player's Bukkit scoreboard is not replaced and nametags keep working. Players are spread across update-ticks: with 100 players and 20 ticks, about five are processed per tick. A line is only sent when its final text changed.