Statistics

Complete server statistics system similar to Statbot, but 100% integrated into Yume-chan.

Features

Feature	Description
Message Tracking	Counts messages by user, channel, hour, day, week, month
Voice Tracking	Time in voice channels with detailed sessions
Presence Tracking	Online/idle/dnd/offline status by user
Game Tracking	Games played by users
Statdocks	Voice channels with real-time counters
Statroles	Automatic roles based on activity
Leaderboards	Rankings by messages, voice, activity
History	Historical data for charts

---

Basic Commands

View Server Statistics

/stats server

Shows a summary of server statistics:

• Total and today's messages
• Total voice time
• Tracked members
• System status

View User Statistics

/stats user [@user]

Shows detailed statistics of a user:

• Messages (total, today, week, month)
• Voice time (total, today, week, month)
• Peak activity hour
• Top games played
• Last activity

View Channel Statistics

/stats channel [#channel]

Shows statistics of a specific channel:

• Total messages
• Peak activity hour
• Total voice time (if voice channel)

---

Statdocks (Channel Counters)

Statdocks are voice channels that display statistics in their name. Users cannot join them.

Create Stats Category

/stats setup create

Creates a category with basic counters:

📊 STATISTICS
├── 👥 Members: 1,234
├── 🟢 Online: 456
├── 🎤 In Voice: 12
└── 💎 Boosts: 5

Add Counter

/stats setup add <type>

Available counter types:

Type	Description	Example
members	Total members	👥 Members: 1,234
online	Online members	🟢 Online: 456
inVoice	In voice channels	🎤 In Voice: 12
boosts	Server boosts	💎 Boosts: 5
roles	Total roles	🏷️ Roles: 25
channels	Total channels	📁 Channels: 50
bots	Bots in server	🤖 Bots: 3
humans	Human members	👤 Humans: 1,231
messagesToday	Today's messages	💬 Msgs Today: 789
voiceNow	Users in voice now	🎙️ Active Voice: 8

Remove Counter

/stats setup remove <type>

Removes a specific counter.

Delete All

/stats setup delete

Deletes the category and all counters.

Enable/Disable Tracking

/stats setup toggle <feature> <true/false>

Enable or disable tracking types:

• messages - Message tracking
• voice - Voice tracking
• presence - Presence tracking
• games - Game tracking

---

Statroles

Statroles are roles that are automatically assigned when a user reaches a certain amount of activity.

Create Statrole

/stats statroles add <@role> <type> <amount> [period] [remove]

Parameters:

• role - Role to assign
• type - messages or voice (hours)
• amount - Required amount
• period - total, today, week, month (optional, default: total)
• remove - Remove role if no longer meets requirement (optional, default: false)

Examples:

/stats statroles add @Chatter messages 1000
/stats statroles add @VoiceActive voice 10 week true
/stats statroles add @TopMonthly messages 500 month true

View Statroles

/stats statroles list

Shows all configured statroles.

Delete Statrole

/stats statroles remove <@role>

Removes a statrole.

---

Leaderboards

Top Messages

/stats top messages [period]

Shows users with most messages.

Periods:

• total - All time (default)
• today - Today only
• week - This week
• month - This month

Top Voice

/stats top voice [period]

Shows users with most voice channel time.

Top Channels

/stats top channels [period]

Shows channels with most activity.

---

Reset Statistics

/stats reset <type>

Resets statistics (administrators only).

Types:

• all - Everything (CAREFUL!)
• messages - Messages only
• voice - Voice only
• daily - Daily data only

---

Server Panel

Configure everything from the Server Panel:

Overview Tab

• General statistics
• Active counters
• Configured statroles
• Tracking status

Leaderboards Tab

• Top messages
• Top voice
• Period filter

Statroles Tab

• Create statroles
• View existing statroles
• Delete statroles

Counters Tab

• View active counters
• Available commands

Configuration Tab

• Enable/disable tracking
• View system status

---

Technical Notes

• Counters update every 5 minutes (Discord limit)
• Statroles are verified every hour
• Daily data resets at midnight
• Weekly data resets on Mondays
• Monthly data resets on the 1st
• History is saved for the last 90 days

---

Comparison with Statbot

Feature	Statbot	Yume-chan
Message Tracking	Yes	Yes
Voice Tracking	Yes	Yes
Presence Tracking	Yes	Yes
Game Tracking	Yes	Yes
Statdocks	Yes	Yes
Statroles	Yes	Yes
Leaderboards	Yes	Yes
Economy Integration	No	YES
Web Panel	Paid	FREE
No Limits	Paid	FREE