# MCTIERBot Advanced Discord queue management and community moderation bot with tier systems and statistics tracking. ## Features - **Queue Management** - Create and manage multiple queues for events, support tickets, or any purpose - **Tier System** - Sophisticated tier assignments based on user activity and points - **Blacklist Management** - Comprehensive blacklist system with detailed logging - **Statistics Tracking** - Track user activity, sessions, and view leaderboards - **Session Control** - Manage user sessions with automatic queue progression - **Role-Based Permissions** - Integrated with Discord roles for access control ## Setup 1. Install Python 3.8 or higher 2. Install dependencies: `pip install -r requirements.txt` 3. Copy `.env` file and add your Discord bot token 4. Configure `config.yml` with your server settings 5. Run the bot: `python bot.py` ## Configuration Edit `config.yml` to customize: - Bot prefix and status - Role names for permissions - Queue settings (max size, notifications) - Tier system (names, colors, required points) - Statistics tracking options - Blacklist settings ## Commands ### Queue Commands - `/queue_create ` - Create a new queue - `/queue_join ` - Join a queue - `/queue_leave ` - Leave a queue - `/queue_view ` - View queue members - `/queue_list` - List all active queues - `/queue_remove ` - Remove user from queue (moderator) - `/queue_clear ` - Clear queue (moderator) - `/queue_delete ` - Delete queue (moderator) ### Tier Commands - `/tier_view [user]` - View tier information - `/tier_set ` - Set user tier (moderator) - `/tier_add_points ` - Add points to user (moderator) - `/tier_leaderboard` - View tier leaderboard - `/tier_list` - List all available tiers ### Blacklist Commands - `/blacklist_add [reason]` - Add user to blacklist (moderator) - `/blacklist_remove ` - Remove user from blacklist (moderator) - `/blacklist_check ` - Check if user is blacklisted - `/blacklist_list` - List all blacklisted users (moderator) ### Statistics Commands - `/stats [user]` - View user statistics - `/stats_leaderboard [sort_by]` - View leaderboard (points/sessions/time) - `/stats_sessions [user]` - View recent sessions ### Session Commands - `/session_start ` - Start session with user (moderator) - `/session_stop` - Stop current session (moderator) - `/session_current` - View current session - `/session_next ` - Move to next user in queue (moderator) ## Requirements - Python 3.8+ - discord.py 2.3.2+ - python-dotenv - PyYAML - aiosqlite ## License MIT License