Ledger | Stats & Leaderboards v1.0.0

Ledger
Ledger tracks player stats on your server and shows them off with a live leaderboard menu. It counts player kills, mob kills, deaths, blocks broken, blocks placed, and playtime, then hands out configurable rewards the first time a player crosses a milestone.

Built for: Survival, SMP, and any server that wants a stats and leaderboard system with real rewards attached.

View attachment 1403706

Leaderboard menu
/ledger top opens a leaderboard GUI. The top rows show the leading players as their own heads, ranked highest first. A selector row at the bottom lets players click between every tracked stat without closing the menu, and the stat currently on screen is marked with a glow. How many players show up is set in config.yml, from 1 to 45.

View attachment 1403707

Switching stats plays a short click sound by default, and earning a milestone plays its own sound too. Both can be changed to any Bukkit sound name or turned off entirely in config.yml.

Stats and milestones

/ledger stats shows a player their own numbers for every tracked stat, or check another player's with /ledger stats <name> if you have the permission. /ledger milestones lists the next reward threshold for each stat and how close the player is to it.

Milestones live in config.yml: pick a stat, a threshold, and the console commands to run when a player first reaches it. {player} is replaced with their name, so a threshold can give items, run other plugin commands, or both. Playtime thresholds are set in minutes; every other stat is a plain count. Each threshold only fires once per player.

Features

• Tracks player kills, mob kills, deaths, blocks broken, blocks placed, and playtime, each one switchable off in config.yml.
• Live leaderboard GUI with a click-to-switch selector row for every tracked stat.
• Configurable leaderboard size, from 1 to 45 players.
• Milestone rewards per stat: set any threshold and any list of console commands to run once a player reaches it.
• /ledger stats and /ledger milestones for checking your own or another player's progress.
• A destructive reset command that requires a second confirm within a configurable time window, for a single player or every player at once.
• Sound feedback on milestones and leaderboard clicks, fully configurable or off.
• PlaceholderAPI support for every stat, raw or formatted.
• Stats save automatically in the background and flush on shutdown, so a stop or crash never loses progress.
• Full tab completion filtered to what the sender can run.

Commands

• /ledger (aliases /stats, /lb, /leaderboard) opens the leaderboard, or with no player context shows help.
• /ledger stats [player] shows your own stats, or another player's with permission.
• /ledger top opens the leaderboard menu directly.
• /ledger milestones shows your next milestone for each tracked stat.
• /ledger reload reloads config.yml and messages.yml live.
• /ledger reset <player|all> then the same command with confirm within the config window wipes a player's stats, or everyone's.

Permissions

• ledger.use view your own stats and open the leaderboard. Default: everyone.
• ledger.others view another player's stats. Default: operators.
• ledger.admin reload the config and reset stats. Default: operators.

Placeholders
PlaceholderAPI support with %ledger_<stat>% for the raw number and %ledger_<stat>_formatted% for a readable value (playtime shown as a duration). Stat keys are kills, mob-kills, deaths, blocks-broken, blocks-placed, and playtime.

Configuration
config.yml controls which stats are tracked, the leaderboard size, how often playtime and milestones update, how often stats save to disk, the reset confirm window, and every sound. messages.yml holds every player-facing line. Run /ledger reload to apply changes with no restart.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• PlaceholderAPI is optional, for the placeholders above.

Installation

1. Put Ledger-1.0.0.jar in your plugins folder.
2. Start the server once to create config.yml and messages.yml.
3. Set your milestone rewards in config.yml if you want any, then run /ledger reload.

Try it first
Ledger is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to open the leaderboard and check your stats before you buy.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.