Leaderboards
Auto-posting ranked leaderboards for kills, K/D, survival, economy, and more.
What it does
The Leaderboard module automatically posts — and keeps updated — a ranked leaderboard in a Discord channel. It shows your top players by whichever stat you choose, and refreshes on a schedule so it always reflects current standings.
The leaderboard message is edited in place — Vigil updates the existing Discord message instead of posting a new one every time, keeping your channel clean.
Available stat types
| Stat | Description |
|---|---|
| Kills | Total player kills (excludes animals and zombies) |
| Deaths | Total deaths |
| K/D Ratio | Kill/death ratio |
| Headshots | Total headshot kills |
| Headshot % | Percentage of kills that were headshots |
| Sessions | Number of times the player has connected |
| Kill streak | Best single-session kill streak ever recorded |
| Survival time | Longest single session without dying |
| Richest | Current economy balance (requires Economy) |
Configuration options
Time range
Filter the leaderboard to a specific time window:
- All time — entire server history
- Today — last 24 hours
- This week — last 7 days
- This month — last 30 days
Number of players shown
How many players appear on the leaderboard (default: 10, max: 25).
Update interval
How often Vigil refreshes the leaderboard (default: 15 minutes, minimum: 5 minutes).
Podium style
When enabled, the top 3 players are visually separated from the rest of the list with a divider, making the gold/silver/bronze positions stand out.
Display
The leaderboard is rendered as a formatted ANSI code block in Discord, giving it a clean terminal-style appearance. The top 3 positions are highlighted in gold, silver, and bronze colours.
Suggested Discord channel
#leaderboards — dedicate a channel specifically for leaderboards. Because the message is updated in place, the channel stays tidy.
You can run multiple Leaderboard modules at once by adding them separately — each pointing to a different stat type and channel. For example, one for kills and one for richest players.