Chat-Stats

📊 Chat Message Statistics Tracking

Chat-Stats is a comprehensive plugin that tracks player activity in chat and displays rankings of the most active participants. Perfect for community servers, roleplay servers, and any server where you want to monitor chat engagement.

✨ Core Features

Message Tracking

• Automatically counts every message sent by each player
• Persistent statistics saved to YAML files
• Real-time tracking without performance impact

Top Players Ranking

• Beautiful top 10 leaderboard with medal emojis (🥇🥈🥉)
• Formatted display with player names and message counts
• Easy-to-read interface for all players

Multi-Language Support

• Full Russian language support
• Complete English language support
• Easy to add more languages
• Administrators can switch languages on-the-fly

Customization Options

• 7 different color schemes for interface (Gold, Yellow, Green, Cyan, Purple, White, Red)
• Administrators can change colors without restarting
• Customizable anti-spam settings

Anti-Spam Protection

• Prevents rapid message spam in chat
• Configurable cooldown periods (time intervals)
• Adjustable message limits per interval
• Can be enabled/disabled by administrators
• Protects server chat quality
• Blocked messages don't count toward statistics
• Each player has their own message counter
• Administrators are not affected by anti-spam rules

Easy Administration

• Simple command-based configuration
• No need to restart server for changes
• Comprehensive help system
• Detailed error messages

🎮 Available Commands

Player Commands:

• /chatstats stats - View your personal message statistics
• /chatstats top - See the top 10 most active players
• /chatstats help - Display help information

Administrator Commands:

• /chatstats stats <player> - Check any player's statistics
• /chatstats setlang <ru|en> - Change plugin language
• /chatstats setcolor <code> - Customize interface color
• /chatstats antispam on|off - Enable/disable anti-spam
• /chatstats antispam cooldown <seconds> - Set spam cooldown
• /chatstats antispam maxmsg <count> - Set max messages per interval

🎨 Color Customization

Choose from 7 color options:

• 6 - Gold (default)
• e - Yellow
• a - Green
• b - Cyan
• d - Purple
• f - White
• c - Red

⚙️ Configuration

The plugin creates a config.yml file with these options:

language: ru  # Language: ru or en
bar-color: "&6"  # Interface color code

# Anti-spam settings
anti-spam:
  enabled: false  # Enable/disable anti-spam
  cooldown-seconds: 5  # Time between message groups
  max-messages-per-interval: 3  # Max messages allowed per interval

🚫 Anti-Spam System

The anti-spam feature helps maintain chat quality by preventing rapid message flooding.

How it works:

• Tracks message sending speed for each player
• Allows a maximum number of messages within a time interval
• Blocks messages that exceed the limit
• Shows warning message to blocked players
• Blocked messages don't count toward statistics
• Each player has their own message counter
• Administrators are not affected by anti-spam rules

Configuration:

anti-spam:
  enabled: false  # Enable/disable anti-spam
  cooldown-seconds: 5  # Time interval in seconds
  max-messages-per-interval: 3  # Max messages allowed per interval

Command Examples:

Enable anti-spam:

/chatstats antispam on

Set strict protection (10 seconds, 2 messages):

/chatstats antispam cooldown 10
/chatstats antispam maxmsg 2

Set moderate protection (5 seconds, 3 messages):

/chatstats antispam cooldown 5
/chatstats antispam maxmsg 3

Set relaxed protection (3 seconds, 5 messages):

/chatstats antispam cooldown 3
/chatstats antispam maxmsg 5

View current settings:

/chatstats antispam help

Protection Levels:

Level	Cooldown	Max Messages	Use Case
Strict	10 sec	2	Heavy spam problems
Moderate	5 sec	3	Standard protection
Relaxed	3 sec	5	Active communities

Player Experience:
When a player exceeds the limit, they see:

⚠ You are writing too fast! Wait before your next message.

Key Features:

• ✅ Administrators are not affected by anti-spam
• ✅ Settings apply immediately without restart
• ✅ Each player has their own message counter
• ✅ Can be toggled on/off anytime
• ✅ Fully customizable thresholds

📊 Statistics Storage

• All statistics are saved in YAML format
• Data persists between server restarts
• Automatic saving on server shutdown
• Easy to backup and restore

🔧 Use Cases

Community Servers

• Track most active community members
• Reward top chatters with recognition
• Monitor engagement levels

Roleplay Servers

• Track character activity
• Identify most active roleplayers
• Manage chat quality with anti-spam

Gaming Communities

• See who's most engaged
• Create friendly competitions
• Maintain healthy chat environment

Event Servers

• Monitor participation during events
• Track engagement metrics
• Identify key community members

👨‍💻 Author

SHTUKA

---

Enhance your server's chat experience with Chat-Stats!