Skip to main content

​
Overview

The message counter system tracks how many messages each member sends in your server. View leaderboards, check individual stats, and manage message counts with administrative commands. Counts are updated in real-time and include both all-time and daily statistics.
Message counting must be enabled before any statistics are tracked. Use messagecount on to start tracking.

​
Commands

Enable or disable message counting for your server.
Parameters:
  • on — Enable message counting
  • off — Disable message counting
  • No parameter — Show current status
What It Does:
  • Controls whether messages are tracked
  • Shows current enabled/disabled status
  • Must be enabled before any tracking occurs
Aliases: msgtoggle, msgcount
Permissions: Administrator
View message statistics for a user.
Parameters:
  • @user — Optional: User to check (defaults to yourself)
What It Shows:
  • Total all-time messages in the server
  • Messages sent today
  • Real-time updated statistics
Aliases: m
Permissions: None
View the total message leaderboard for your server.
What It Shows:
  • Top message senders (all-time)
  • Paginated display (10 users per page)
  • Real-time updated counts
  • Navigation buttons for browsing
Aliases: mlb
Permissions: None
View today’s message leaderboard.
What It Shows:
  • Top message senders for today
  • Paginated display (10 users per page)
  • Real-time updated counts
  • Navigation buttons for browsing
Aliases: mdl
Permissions: None
Add messages to a user’s count manually.
Parameters:
  • @user — User to add messages to
  • amount — Number of messages to add (positive integer)
What It Does:
  • Adds specified amount to total message count
  • Useful for importing data or corrections
  • Updates immediately
Aliases: msgadd
Permissions: Manage Server
Remove messages from a user’s count manually.
Parameters:
  • @user — User to remove messages from
  • amount — Number of messages to remove (positive integer)
What It Does:
  • Removes specified amount from total count
  • Shows confirmation prompt
  • Cannot go below 0
Aliases: msgremove
Permissions: Manage Server
Set exact message count for a user.
Parameters:
  • @user — User to set count for
  • amount — Exact message count (non-negative integer)
What It Does:
  • Sets total message count to exact value
  • Shows confirmation prompt
  • Replaces current count completely
Aliases: msgset
Permissions: Manage Server
Reset a user’s message count to zero.
Parameters:
  • @user — User to reset count for
What It Does:
  • Removes all message data for the user
  • Shows confirmation prompt
  • Cannot be undone
This permanently deletes the user’s message data.
Aliases: msgreset
Permissions: Manage Server
Reset all message counts for the entire server.
What It Does:
  • Deletes ALL message data for the server
  • Shows confirmation prompt
  • Cannot be undone
This permanently deletes all message statistics for every user in your server.
Aliases: msgresetall
Permissions: Manage Server

​
How It Works

1

Enable Message Counting

Turn on the message counter for your server:
2

Messages Are Tracked

The bot automatically tracks:
  • Every message sent by members
  • Total all-time counts
  • Daily counts (resets at midnight UTC)
3

View Statistics

Check stats and leaderboards:

​
Leaderboard Navigation

Both leaderboards support interactive navigation:
  • First — Jump to first page
  • Previous — Go to previous page
  • Stop — Close the leaderboard
  • Next — Go to next page
  • Last — Jump to last page
Leaderboards show 10 users per page and auto-disable buttons after 60 seconds.

​
Permission Requirements

Bot Permissions

No special permissions required beyond basic message reading and sending.

User Permissions

Command Requirements:
  • Administrator — messagecount toggle
  • Manage Server — add/remove/set/reset commands
  • None — Viewing statistics and leaderboards

​
Usage Examples

​
Common Use Cases

Monitor who’s most active in your community.
Use statistics to recognize and reward engagement.
Migrate message counts when switching bots.
Track activity during specific events or competitions.
Correct data errors or spam inflation.

​
Important Notes

Real-Time Updates
  • All statistics update immediately
  • Leaderboards reflect current counts
  • Daily counts reset at midnight UTC
  • No caching delays
Data Persistence
  • Disabling message counting does NOT delete data
  • Existing statistics remain intact
  • Re-enabling will continue from current counts
  • Use reset commands to delete data

Server Settings

Configure other server features and preferences

Role Management

Create roles to reward active members