Event Logging Features

🔨 Moderation Events

Track all moderation actions taken in your server:

• Member Banned / Unbanned - Logs when members are banned or unbanned, including the reason and moderator
• Member Kicked - Records member kicks with moderator information
• Member Joined / Left - Tracks when members join or leave the server
• Nickname Changed - Monitors nickname changes for all members
• Timeout Given / Removed - Logs timeout actions with duration and moderator
• Role Added / Removed - Tracks role assignments and removals

🎙️ Voice Events

Monitor all voice channel activity:

• Member Joined/Left Voice Channel - Tracks voice channel participation
• Member Moved Between Channels - Logs when members are moved between voice channels
• Member Muted / Unmuted - Records mute and unmute actions
• Member Deafened / Undeafened - Tracks deafen and undeafen actions

📝 Message Events

Keep track of message modifications:

• Message Deleted - Logs deleted messages with full content and attachment information
• Message Edited - Records message edits with before/after content comparison

🧩 Channel & Thread Events

Monitor channel and thread management:

• Channel Created / Deleted / Updated - Tracks all channel lifecycle events
• Thread Created / Deleted / Updated - Monitors thread creation and modifications
• Channel Permissions Updated - Logs permission changes for channels

🎨 Role Events

Track role management and changes:

• Role Created / Deleted / Updated - Monitors role lifecycle events
• Role Permissions and Settings Changes - Logs all role permission modifications

⚙️ Server Events

Keep track of server-wide changes:

• Server Settings Updated - Logs changes to server settings
• Invite Created / Deleted - Tracks invite link creation and deletion

📬 Modmail System

Enable private communication between users and staff members:

• Direct Message Support - Users can DM the bot to contact server staff
• Multi-Guild Support - Users in multiple servers can select which server to contact via dropdown menu
• Support Server Priority - Support server is always shown first with special indicator (🛟) for easy access
• Automatic Thread Creation - Each modmail conversation creates a dedicated thread in your configured modmail channel
• Organized Conversations - All modmail threads are organized in one channel for easy management
• Two-Way Communication - Staff can respond in threads, and users receive messages in their DMs
• Enable/Disable Control - Administrators can enable or disable modmail for their server
• Custom Channel Setup - Configure which channel modmail threads are created in
• Rate Limiting Integration - All modmail operations automatically use the rate limiting system for reliable delivery

Use Cases: Support tickets, user reports, private inquiries, staff communication, and more!

⚡ Rate Limiting System

Automatic rate limiting prevents Discord API errors and ensures reliable message delivery:

• Per-Channel Queuing - Each channel has its own queue (5 messages per 5 seconds) to prevent rate limits
• Token Bucket Algorithm - Implements smooth rate limiting with automatic token refill
• Global Rate Limiting - 50 requests per second global limit to protect against API overload
• Audit Log Protection - Conservative 2 requests per second for audit log operations
• Automatic Retry - Handles 429 errors with automatic retry after delay
• Queue Management - Maximum 100 items per queue with overflow protection
• Statistics Tracking - Monitor rate limit hits, messages queued/sent, and overflows via /ratelimitstatus command
• No Configuration Required - Works automatically in the background - no setup needed!

Benefits: Prevents bot crashes from rate limit errors, ensures all messages are delivered, and provides visibility into rate limiting statistics.

🛠️ Utility Commands

Comprehensive utility commands for bot management and information:

• /help - Display all available commands organized by category
• /config - View current server configuration (log channel, colors, toggles, modmail)
• /testlog - Send a test embed to verify logging is working
• /checkperms - Check bot permissions in the server
• /botinfo - View bot status, uptime, latency, and statistics
• /ratelimitstatus - View rate limiting statistics and queue information

Embed Design

Each event type features:

• Unique Color Scheme - Color-coded embeds for quick visual identification
• Emoji Icons - Category-specific emojis for easy recognition
• Detailed Fields - All relevant information organized in clear fields
• Timestamps - Precise timestamps for when events occurred
• Moderator Information - When available from audit logs, includes moderator details