# Discord Utility Bot A multi-purpose Discord bot with music, moderation, tickets, and auto-messaging features. ## Features - 🎵 **Music Player**: Play music from YouTube with queue management - 🛡️ **Moderation**: Ban, kick, timeout, mute, and more - 🎫 **Ticket System**: Customizable ticket categories with automatic channel creation - 📢 **Auto Messages**: Send automated messages to specified channels ## Setup 1. Install Python 3.10 or higher 2. Install FFmpeg (required for music): - **Windows**: Download from https://ffmpeg.org/download.html and add to PATH - **Ubuntu/Debian**: `sudo apt install ffmpeg` - **macOS**: `brew install ffmpeg` 3. Install dependencies: ```bash pip install -U pip pip install -r requirements.txt ``` 4. Copy `.env.example` to `.env` and add your bot token 5. Edit `config.json` to configure the bot 6. Run the bot: ```bash python bot.py ``` ### Troubleshooting Installation If you get compilation errors with `yarl` or `aiohttp`: ```bash # Install pre-built wheels pip install --only-binary :all: aiohttp yarl # Or upgrade pip and setuptools pip install --upgrade pip setuptools wheel ``` ## Configuration Edit `config.json` to customize: - Prefix for text commands - Auto-message interval and messages - Ticket categories - Channel IDs for logging ## Commands ### Music - `/play ` - Play a song from YouTube - `/pause` - Pause the current song - `/resume` - Resume playback - `/skip` - Skip current song - `/stop` - Stop and clear queue - `/queue` - Show music queue - `/volume <0-100>` - Set volume - `/loop` - Toggle loop mode - `/disconnect` - Disconnect from voice ### Moderation - `/kick [reason]` - Kick a member - `/ban [reason]` - Ban a member - `/unban [reason]` - Unban a user - `/timeout [reason]` - Timeout a member - `/untimeout ` - Remove timeout - `/mute [reason]` - Voice mute a member - `/unmute ` - Voice unmute a member - `/clear ` - Clear messages - `/warn ` - Warn a member ### Tickets - `/ticket_panel` - Create ticket panel (Admin only) - `/close_ticket` - Close current ticket ### Auto Messages - `!set_auto_channel ` - Set auto-message channel - `!add_auto_message ` - Add an auto-message - `!list_auto_messages` - List all auto-messages ## Required Bot Permissions - Send Messages - Embed Links - Manage Messages - Manage Channels - Kick Members - Ban Members - Moderate Members (Timeout) - Mute Members - Connect (Voice) - Speak (Voice) ## Required Intents Enable these in Discord Developer Portal: - Server Members Intent - Message Content Intent - Presence Intent (optional)