Commands

Base aliases: /leaderboard, /classements, /classement, /baltop.

Command	Permission	Description
`/leaderboard`	`leaderboards.command`	Opens the `leaderboards-list` menu, populated with every configured leaderboard. Player-only.
`/leaderboard set <player> <leaderboardId> <value>`	`leaderboards.command` + `leaderboards.set`	Overwrites a player's score on a leaderboard.
`/leaderboard reload`	`leaderboards.command` + `leaderboards.reload`	Reloads `config.yml` and the menu container.

The class-level @CommandPermission("leaderboards.command") on LeaderboardCommand applies to every subcommand; the per-subcommand permissions below are additive.

`/leaderboard`

Player-only. Opens the leaderboards-list menu with an entries context populated from configuration().leaderboards().values() — every leaderboard declared in config.yml, unfiltered.

`/leaderboard set <player> <leaderboardId> <value>`

Permission: leaderboards.set.

/leaderboard set <player> <leaderboardId> <value>

<player> — resolved to a MinecraftPlayer (network-aware; works for offline players).
<leaderboardId> — tab-completed from configuration().ids().
<value> — a double, the new absolute score.

Sends an UpdatePlayerEntryPacket to the master node with the leaderboard's configured sort direction (defaults to DESC if the id isn't in config.yml). The master overwrites the player's value in every current period bucket (all-time, weekly, monthly) — this is not an increment. Success/failure is only logged server-side (getSLF4JLogger()); there is no in-game feedback message to the executor.

`/leaderboard reload`

Permission: leaderboards.reload. Calls AstralLeaderboards.loadConfiguration() — re-reads config.yml and reloads the menu container. Errors are logged, not shown to the sender.

Permission summary

Node	Grants
`leaderboards.command`	Base access to `/leaderboard` and its subcommands (class-level, required for all of the above).
`leaderboards.set`	`/leaderboard set` — overwrite any player's score.
`leaderboards.reload`	`/leaderboard reload` — reload configuration.
`leaderboards.bypass`	Exempts a player from the built-in block/kill/fish trackers (see Developer API). Not a command permission — checked directly in `PlayerDataListener`.

Last modified: 25 July 2026