Server statistics
Live statistic channels, activity roles, tracking windows and the /stats overview — with the rate-limit realities of Discord.
The Server Stats module keeps statistic channels up to date, awards activity roles, and answers ,/stats with an on-demand overview.
Statistic channels#
Each entry points one channel at one statistic and formats its name from a template. The nine statistics:
| Key | Counts |
|---|---|
| members | Total members |
| boosts | Server boost level count |
| channels | All channels |
| textChannels | Text + announcement + forum + media channels |
| voiceChannels | Voice + stage channels |
| categories | Categories |
| roles | Roles |
| ticketsOpen | Open tickets (cached ~10 s) |
| ticketsClosed | Closed tickets (cached ~10 s) |
Channel name template (≤120 chars, must contain {value}), default {emoji} {label}: {value}, plus per-entry emoji, label, prefix and suffix. Number formats: plain, comma (1,234), compact (1.2K), padded. Maximum 20 statistic channels per server.
The rename rhythm#
Discord permits two channel renames per ten minutes — no bot can go faster. Kharat therefore:
- refreshes each server on its configured interval (minimum 10 minutes),
- renames only when the formatted name actually changed, and
- only ever renames voice or stage channels (text-channel renames are skipped by design).
Configure stat channels on the dashboard (fields); the bot needs Manage Channels on the target channels.
Activity roles#
Rules grant a role to members who were active enough recently:
| Setting | Bounds | Default |
|---|---|---|
| Activity type | messages / voice minutes / days active | — |
| Threshold | 1–1,000,000 | — |
| Window | 1–90 days | 30 |
Up to 20 rules per server. Award and removal are applied gradually — at most 50 role changes per refresh cycle — so very large servers converge over several cycles instead of hammering the API. Voice minutes and message activity are only recorded while the corresponding tracking switches are on, and channels/roles on the ignore lists never count.
Tracking & retention#
Tracking (messages, voice) is on by default, activity is retained for 90 days (7–365). Ignore lists exclude specific channels and roles from all activity accounting.
/stats#
The /stats slash command shows members, boosts, roles, text/voice channels, categories, open and closed tickets, bot uptime and the server owner — computed on demand, no configuration required.