Skip to content

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

config.ymlYAML
modules:
  scoreboard:
    enabled: true

Then 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

KeyDescription
update-ticksTicks between line refreshes per player (2–200; 20 = 1 second)
title-ticksTicks between title frames (1–200)
hide-numbersHides the red numbers (1.20.3+ clients only)
disabled-worldsWorlds without a sidebar
date-format, time-zoneFormat of the date token and its time zone
state-text.on / offText of the vanish and staff mode tokens
boardsBoards, 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

scoreboard.ymlYAML
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:

  1. Module tokens: {player}, {displayname}, {world}, {server}, {date}, {vanish}, {staffmode}.
  2. sofyCore placeholders %sofycore_<key>%, without PlaceholderAPI. If the module that answers is off, the value is empty.
  3. Colors: &a, &l... and &#RRGGBB (1.16+ clients; older ones see the closest classic color).
  4. 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.