BlockcadeDocumentation ← Portfolio
Docs/Storage and leaderboards

#Storage and Leaderboards

#storage.yml

type: properties
file: stats.properties
flush-seconds: 30

The current release supports the built-in properties repository. The filename is restricted to a file inside plugins/Blockcade; directory traversal is not accepted.

#Stored data

Statistics are keyed by player UUID and game ID. Blockcade stores:

  • Last known player name
  • Last played game
  • Personal high score
  • Games played
  • Wins and losses
  • Total playtime

Writes run on a dedicated storage thread. Data is first written to a temporary file, forced to disk and then atomically moved over the main file where the filesystem supports it.

#Backup and reset

Back up stats.properties while the server is stopped or immediately after a clean shutdown. To reset all statistics, stop the server, move the file somewhere safe and start again.

#Leaderboards

/bcade top <game> sorts stored personal bests and shows up to leaderboards.size entries. The GUI leaderboard button uses the player's last played game.