CLICommands
leaderboard
snug leaderboard <COMMAND>Leaderboard operations.
Subcommands
| Command | What it does |
|---|---|
create | Create a new leaderboard |
get | Get leaderboard details by ID |
list | List leaderboards |
update | Update a leaderboard |
delete | Delete a leaderboard |
submit | Submit scores to a leaderboard |
batch-submit | Submit scores for many entities from a JSON file (array of submissions, each with an id) |
top | Get top entries from a leaderboard |
time-window | Get top entries within a time window |
metric-top | Get top entries for a specific metric |
rank | Get rank for a specific entity |
surrounding | Get surrounding ranks for an entity |
delete-entity | Delete an entity from leaderboards |
delete-namespace | Delete an entire namespace |
delete-metric | Delete a metric from a namespace |
namespaces | List all namespaces |
metrics | List metrics in a namespace |
Run snug leaderboard <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug leaderboard create --name "Season 1" --description "Spring competition" --max-entries 10000 --tags game:battle-royale,season:1
snug leaderboard list --limit 10 --active true
snug leaderboard get --id abc123
snug leaderboard update --id abc123 --name "Season 1 Updated" --active false
snug leaderboard delete --id abc123 --force
snug leaderboard submit -n game1 -i player123 -m score:100,kills:10 -d '{"username":"ProGamer"}'
snug leaderboard top -n game1 -l 10 -w score:2.0,kills:1.5
snug leaderboard time-window -n game1 -s 1700000000 -e 1700003600 -l 25
snug leaderboard metric-top -n game1 -m assists -l 15
snug leaderboard rank -n game1 -i player123
snug leaderboard surrounding -n game1 -i player123 -w 5
snug leaderboard delete-entity -n game1 -i player123
snug leaderboard delete-namespace -n game1 --force
snug leaderboard delete-metric -n game1 -m score
snug leaderboard namespaces
snug leaderboard metrics -n game1Next
- leaderboard guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.