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.
~messagecount <on|off>
~messagecount
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.
~messages [@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.
~messageleaderboard
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.
~dailyleaderboard
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.
~addmessages <@user> <amount>
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.
~removemessages <@user> <amount>
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.
~setmessages <@user> <amount>
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.
~resetmessages <@user>
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.
~resetallmessages
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:
~messagecount on
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:
# Your stats
~messages

# Someone else's stats
~messages @User

# All-time leaderboard
~mlb

# Today's leaderboard
~mdl

​
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

# Enable message counting
~messagecount on

# Check if it's enabled
~messagecount

# Disable message counting
~messagecount off

​
Common Use Cases

# Enable tracking
~messagecount on

# Check most active members
~mlb

# Check today's activity
~mdl
Monitor who’s most active in your community.
# Check leaderboard
~mlb

# Reward top 3 most active members
# Give them special roles or perks
Use statistics to recognize and reward engagement.
# Set counts for all users
~setmessages @User1 10000
~setmessages @User2 8500
~setmessages @User3 7200
Migrate message counts when switching bots.
# Reset everyone's counts
~resetallmessages

# Start event tracking
# Check daily leaderboard during event
~mdl
Track activity during specific events or competitions.
# User's count is too high
~removemessages @User 500

# User's count is too low
~addmessages @User 200

# Set to correct value
~setmessages @User 1000
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