Skip to content

Leaderboards

Jump to bottom
Cyrusbye720 edited this page Jun 6, 2026 · 3 revisions

Leaderboards

ZDiscord tracks kills, deaths, and playtime (seconds) per player and exposes them via /leaderboard <stat> in Discord.

Configuration

leaderboard:
  enabled: true
  tracked-stats:
    - KILLS
    - DEATHS
    - PLAYTIME
  top-count: 10

The list of stats in tracked-stats is informational; the actual stats tracked are controlled by the listeners:

  • kills and deaths are incremented from PlayerDeathEvent.
  • playtime is accumulated from the time between PlayerJoinEvent and PlayerQuitEvent, and is stored in seconds.

Slash command

/leaderboard <stat> accepts kills, deaths, or playtime (case-insensitive). The embed lists the top N players with a numeric value (or Xh Ym for playtime).

Storage

Stats are persisted via the configured storage backend. See Storage backends for details.

ZDiscord v1.1.0 · Home · Issues · Source

Clone this wiki locally