Skip to content

Leaderboard

okereke-dev edited this page Jul 4, 2026 · 1 revision

Leaderboard

RPGLoot tracks two lightweight, persistent per-player stats and lets you view them as a server leaderboard.


Tracked stats

Stat When it increments
Legendaries found A player receives a Legendary item (or an Artifact, which is Legendary-tier) from a mob or boss kill
Sets completed A player equips a full 5-piece set for the first time (re-equipping the same completed set again does not increment it again — only the transition from incomplete to complete counts)

Structure loot never counts toward "Legendaries found" — same reasoning as the broadcast feature: there's no player "finder" at chest-generation time.


Viewing the leaderboard

/rpgloot leaderboard
/rpgloot leaderboard legendaries
/rpgloot leaderboard sets

Shows the top 10 players for the selected stat, ranked highest first.

Output example:

─── Legendaries Found Leaderboard ───
  1. Steve — 12
  2. Alex — 8
  3. Notch — 5

Available to all players by default (rpgloot.command.leaderboard).


Data storage

Stats are stored in plugins/RPGLoot/playerstats.yml, keyed by player UUID. This is a separate file from config.yml — safe to back up or reset independently. Deleting it resets every player's stats to zero.


PlaceholderAPI

Both stats are also exposed as placeholders for the viewing player — see Compatibility:

  • %rpgloot_stat_legendaries_found%
  • %rpgloot_stat_sets_completed%

Clone this wiki locally