Saltar al contenido

Funciones

Scoreboard

Configura el scoreboard lateral de sofyCore con tableros por permiso y mundo, títulos animados, placeholders y colores hex.

El módulo scoreboard muestra un sidebar con información del jugador. Los tableros, los textos y la velocidad de refresco están en scoreboard.yml. No guarda nada en Redis ni en la base de datos: todos los valores salen de placeholders que responden desde memoria.

Activarlo

config.ymlYAML
modules:
  scoreboard:
    enabled: true

Después ejecuta /sofycore module scoreboard reload. Si scoreboard.yml tiene un error, el módulo queda en FAILED y la consola indica la clave incorrecta.

scoreboard.yml

ClaveDescripción
update-ticksTicks entre refrescos de líneas por jugador (2–200; 20 = 1 segundo)
title-ticksTicks entre fotogramas del título (1–200)
hide-numbersOculta los números rojos (solo clientes 1.20.3+)
disabled-worldsMundos sin sidebar
date-format, time-zoneFormato del token de fecha y su zona horaria
state-text.on / offTexto de los tokens de vanish y modo staff
boardsTableros, revisados de arriba abajo; se muestra el primero que encaja

Cada tablero tiene permission (vacío para todos), worlds (vacío para todos), un title (un texto, o una lista de fotogramas para un título animado) y de 1 a 15 lines.

Tableros por defecto

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'

Procesamiento del texto

Cada línea y título se procesa en este orden:

  1. Tokens del módulo: {player}, {displayname}, {world}, {server}, {date}, {vanish}, {staffmode}.
  2. Placeholders de sofyCore %sofycore_<clave>%, sin PlaceholderAPI. Si el módulo que responde está apagado, sale vacío.
  3. Colores: &a, &l... y &#RRGGBB (clientes 1.16+; los antiguos ven el color clásico más cercano).
  4. PlaceholderAPI, si está instalado y queda algún %...%.

Rendimiento

El sidebar se dibuja con paquetes por jugador mediante scoreboard-library incluida y relocalizada, así no se reemplaza el scoreboard de Bukkit del jugador y los nametags siguen funcionando. Los jugadores se reparten entre los update-ticks: con 100 jugadores y 20 ticks se procesan unos cinco por tick. Una línea solo se envía si su texto final cambió.