Commands
Every command shipped by TDX Leaderboards, with the permission each one needs.
Commands
Player commands
| Command | Description | Permission |
|---|---|---|
/leaderboard | Open the main leaderboard GUI. | tdxleaderboards.use |
/leaderboard <board> | Show a board's top players in chat. | tdxleaderboards.use |
/leaderboard history | List the past periods that were archived. | tdxleaderboards.use |
/leaderboard history <period> | Show the archived points standings for a period. | tdxleaderboards.use |
/leaderboard history <period> <board> | Show one board's archived standings for a period. | tdxleaderboards.use |
/points | View your own points breakdown. | tdxleaderboards.points |
/points <player> | View another player's points. | tdxleaderboards.points.others |
/points top [count] | Show the top players by points in chat. count is 1 to 100. | tdxleaderboards.points |
/mystats | Personal stats page across every board. | tdxleaderboards.stats |
/mystats <player> | Stats page for another player. | tdxleaderboards.stats.others |
Aliases: /lb, /leaderboards, /stats, /statistics and /stat for
/leaderboard. /pts and /pointstop for /points. /mstats and
/playerstats for /mystats.
Admin commands
All admin tools live under /lbadmin (aliases /leaderboardadmin and
/tdxlb).
Every subcommand checks two permissions: tdxleaderboards.admin, and
its own node from the table below. Operators have all of them. For staff
who are not operators, grant both, because tdxleaderboards.admin on its
own does not include the others.
| Subcommand | Description | Permission |
|---|---|---|
/lbadmin reload | Reload config.yml, messages.yml and the GUI layout from disk. | tdxleaderboards.admin.reload |
/lbadmin update | Recalculate every board right now instead of waiting for the next refresh. | tdxleaderboards.admin.update |
/lbadmin reset confirm | Wipe the current period's data and start it again from zero. No rewards are paid. | tdxleaderboards.admin.reset |
/lbadmin snapshot confirm | Take a fresh starting point for online players on DELTA boards without clearing anything. | tdxleaderboards.admin.reset |
/lbadmin baselines | Report on the starting points of every DELTA board. Changes nothing. | tdxleaderboards.admin.reset |
/lbadmin baselines repair confirm | Remove the zero starting points held by players who joined before this period began. | tdxleaderboards.admin.reset |
/lbadmin baselines reset <board|all> confirm | Remove every starting point of one DELTA board, or of all of them. | tdxleaderboards.admin.reset |
/lbadmin archive <period> confirm | Close out a past period that was missed: archive it, pay its rewards, then clear its data. | tdxleaderboards.admin.reset |
/lbadmin setstat <player> <board> <value> | Set a player's value on a board. | tdxleaderboards.admin.setstat |
/lbadmin addstat <player> <board> <amount> | Add to a player's value on a board the plugin counts itself. | tdxleaderboards.admin.setstat |
/lbadmin debug [player] | Print board status. Add a player to also see their points, rank and value on every board. | tdxleaderboards.admin.debug |
/lbadmin hologram create <id> <board|points> [lines] | Create a hologram at your position. Needs DecentHolograms. | tdxleaderboards.admin |
/lbadmin hologram remove <id> | Remove a hologram. | tdxleaderboards.admin |
/lbadmin hologram list | List the holograms this plugin manages. | tdxleaderboards.admin |
/lbadmin hologram refresh | Redraw every hologram now. | tdxleaderboards.admin |
Closing out a period by hand
The reset runs on its own when the period changes, including after the server was offline over the boundary. You only need these when something went wrong:
- A period was never closed out. Run
/lbadmin archive <period> confirmwith the period key, for example2026-08,2026-W35or2026-BW18. It is safe to run twice: rewards and the archive are each marked done per period, so neither can happen a second time. DELTAboards are empty after a reset. Run/lbadmin snapshot confirm. It only fills in missing starting points, so it cannot wipe anybody's progress.
When a DELTA board shows lifetime totals
A DELTA board shows how far a player's number has moved since their
starting point for the period. If that starting point is wrong, their
whole lifetime total shows up as this period's progress. There are two
ways that happens: a starting point of 0 that was stored before the
player's data had loaded, and a lifetime value that jumped in the
middle of a period because statistics or another plugin's data were
restored, merged or imported.
/lbadmin baselinesreports on both for everyDELTAboard and changes nothing: how many starting points there are, how many zero ones belong to players who joined before the period began, and how many players show more playtime than has passed this period, which is the sure sign of a jump./lbadmin baselines repair confirmremoves only those zero starting points./lbadmin baselines reset <board|all> confirmremoves every starting point of one board, or of allDELTAboards.
Both also clear the cached standings of the boards they touch. The
players affected start again from the value they have the next time
they are online. What they did earlier in the period cannot be worked
out afterwards. Boards the plugin counts itself (ACCUMULATE) have no
starting points and are never touched.
setstat and addstat
setstat overwrites a value. addstat adds to it, and a negative amount
subtracts.
addstat is the one to put in another plugin's reward commands, because it
never needs to know the current number. It works on any board with
tracking: ACCUMULATE, and a CUSTOM_COUNTER board exists only to be fed
this way. See Feeding a board from another plugin.
On a DELTA board, setstat works by moving the player's starting point,
which is only possible while they are online. For an offline player it
changes their row on the board and nothing else, and that lasts until
they next join. It is still the right tool for taking an offline player
off a board: /lbadmin setstat <player> <board> 0.