UltimateChristmas 4.0 Wiki

UltimateChristmas / Leaderboards

Leaderboards

Boards over any stat the plugin tracks. Competition is retention — the players at the top keep playing to stay there, and everyone else plays to catch them.

module id: leaderboard config: modules/leaderboards.yml

How players use it

/christmas top                  the default board
/christmas top boss_damage      a specific board
/christmas top shards 25        a board with a row count

Permission: ultimatechristmas.top.

Configuration

default-size: 10     # rows shown by default
max-size: 25         # the most a player may request
cache-seconds: 60    # how long a board result is cached before re-querying

# Boards to offer: a stat key mapped to a display name. Any tracked stat works.
boards:
  shards: "Shards"
  shards_earned: "Shards Earned"
  gifts_opened: "Gifts Opened"
  presents_found: "Presents Found"
  snowballs_hit: "Snowball Hits"
  boss_damage: "Boss Damage"
  bosses_slain: "Bosses Slain"
  ornaments_hung: "Ornaments Hung"
  advent_claimed: "Advent Doors"
  gifts_given: "Gifts Given"

Remove a line to hide that board; the stat keys are the same ones quests track.

With storage.type: sqlite in config.yml, board queries run as indexed SQL instead of scanning player files — worth switching to past a few thousand players. See Installation.

Season ideas