Leaderboards

Any hologram can become a leaderboard: a top list of kills, play time, a balance, any statistic or any placeholder. The plugin keeps the values itself, so no stats plugin is needed behind it, and offline players are ranked too.

Turning one on

While a hologram is a leaderboard its lines are written from the section; the lines it had are kept for when it is turned off. /holo <name> leaderboard flatten turns the board into plain lines you can edit one by one; the places still read the board.

holograms:
  top:
    leaderboard:
      enabled: true
      stats: [kills, playtime]        # ids from leaderboards.yml
      spans: [weekly, all-time]       # all-time, daily, weekly, monthly, yearly
      rows: 10                        # 1 to 30
      header: ['<size:1.6><shine:highlight>{highlight}&lTOP %stat%', '%resets%']
      row: '{highlight}%rank%. {letters}%name% {letters_black}· {info}%value%'
      empty-row: '{muted}%rank%. ---'
      you: '{success}You {letters_black}· {highlight}#%rank% {letters_black}· {info}%value%'
      you-unranked: '{muted}You are not on this board yet'
      footer: ['<size:0.4> ']
      stat-button: '{info}◀ {letters}%stat% {info}▶'
      span-button: '{info}◀ {letters}%span% {info}▶'

Every stat and period is a page. The buttons turn the page for the player who clicked, and nobody else. Every viewer sees their own place under the others.

From commands:

What can be ranked

leaderboards.yml defines the stats and when periods start over:

time-zone: 'Europe/Madrid'   # empty for the server's own
day-starts-at: 0             # the hour a day starts, 0-23
week-starts-on: MONDAY
sample-every: 1m             # how often online players are read
sort-every: 30s              # how often the boards are sorted again
stats:
  kills: {name: Kills, source: 'statistic:PLAYER_KILLS'}
  playtime: {name: Play time, source: playtime, format: duration}
  money: {name: Balance, source: balance, format: money}
  level: {name: Level, source: 'placeholder:%player_level%'}

Shipped stats: kills, deaths, mobs, playtime, money, diamonds, jumps.

Statistics, play time and balances count players who are offline too: they are read once, in the background, the first time a stat is tracked. A placeholder only counts players as they join. A period counts what was gained since it began. time-zone, day-starts-at and week-starts-on are also editable in game, in Settings on the hologram list.

Placeholders

The same values work anywhere that reads placeholders (an NPC's skin included):

The period is all-time, daily, weekly, monthly or yearly. An NPC whose skin is %exyliadisplays_lb_kills:weekly:1:name% wears this week's best killer; see Statues.