Nexus is a feature-rich, all-in-one Discord bot with music playback, AI chat, leveling system, anti-spam, and more!
Features • Installation • Configuration • Commands • Contributing
- 🎶 Play music from YouTube and Spotify URLs
- 🔍 Search and play from YouTube
- 📝 Queue management with loop modes
- 🎚️ Volume control with interactive buttons
- 📊 Animated progress bars and beat visualizers
- ⏯️ Interactive controls (Pause/Resume, Skip, Stop, Loop)
- 🔒 Voice channel restrictions
- 💬 Responds to mentions with intelligent AI responses
- 🧠 Powered by Groq API (Llama3 model)
- 📚 Maintains conversation context per user
- ⚡ Fast and natural responses
- 🏆 Track user activity and award levels
- 📈 XP-based progression (level² × 100 formula)
- 🏅 Server leaderboards
- 📢 Customizable level-up notifications
- 💾 Persistent data storage
- 🚫 Advanced spam detection
- 🔗 Link spam prevention
- ⏱️ Rate limiting and duplicate detection
- 🎯 Aggressive punishment system (kick on spam)
- ⚙️ Configurable thresholds and whitelist
- 🎉 AI-generated personalized welcome messages
- 🎨 Custom welcome messages with placeholders
- 🎭 Auto-role assignment for new members
- 🖼️ Animated welcome banners
- 🚪 Automatic personal voice channel creation
- 🏷️ Custom channel naming
- 🗑️ Auto-deletion when empty
- 👥 User-controlled permissions
- 📩 Interactive ticket creation with buttons
- 🗂️ Organized with categories
- 📄 Transcript generation on close
- ✅ Confirmation dialogs
- 🔐 Private channel permissions
- 🛡️ Additional security and moderation tools
- 👮 Permission-based command access
- 📝 Comprehensive logging
Before you begin, ensure you have the following:
- Python 3.8+ installed
- FFmpeg installed and in your system PATH
- Download from: https://ffmpeg.org/download.html
- Discord Bot Token from Discord Developer Portal
- (Optional) Spotify API credentials
- (Optional) Groq API Key for AI features
git clone https://github.com/er-sunny-4/nexus-discord-bot.git
cd nexus-discord-botpip install -r requirements.txtCreate a .env file in the root directory:
DISCORD_TOKEN=your_discord_bot_token_here
SPOTIFY_CLIENT_ID=your_spotify_client_id # Optional
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret # Optional
GROQ_API_KEY=your_groq_api_key # OptionalGo to Discord Developer Portal:
- Select your bot application
- Go to Bot section
- Enable these Privileged Gateway Intents:
- ✅ Server Members Intent
- ✅ Message Content Intent
- ✅ Presence Intent (optional)
# Using Python module
python -m bot.main
# Or using the startup scripts
# Windows:
scripts\start_bot.bat
# PowerShell:
scripts\start_bot.ps1Your bot needs these permissions:
- Read Messages/View Channels
- Send Messages
- Manage Messages
- Connect (voice)
- Speak (voice)
- Manage Guild
- Manage Channels (for voice master/tickets)
- Manage Roles (for auto-role)
- Moderate Members (for anti-spam)
- Kick Members (for anti-spam)
Permission Integer: 1099511828487 (Administrator recommended for all features)
- Go to https://discord.com/developers/applications
- Create/select your application
- Go to "Bot" section
- Copy the token
- Go to https://developer.spotify.com/dashboard/
- Create/select your app
- Copy Client ID and Client Secret
- Go to https://console.groq.com/
- Sign up and create an API key
- Copy the key
| Command | Description |
|---|---|
/play <url/query> |
Play music from YouTube/Spotify or search |
/join |
Join your voice channel |
/leave |
Leave the voice channel |
/pause |
Pause the current song |
/resume |
Resume the paused song |
/stop |
Stop playback and clear queue |
/skip |
Skip to the next song |
/setvc [channel] |
Restrict bot to specific voice channel |
/clearvc |
Clear voice channel restrictions |
| Command | Description |
|---|---|
/setwelcome [channel] |
Set welcome message channel |
/setwelcomemessage <text> |
Set custom welcome message |
/setautorole <role> |
Auto-assign role to new members |
/testwelcome |
Test welcome message |
/clearwelcome |
Clear welcome channel |
/clearwelcomemessage |
Clear custom message |
/clearautorole |
Clear auto-role |
| Command | Description |
|---|---|
/setlevelchannel <channel> |
Set level-up notification channel |
/setcheckchannel <channel> |
Set level check channel |
/level [user] |
Check user's level |
/leaderboard |
Show server leaderboard |
| Command | Description |
|---|---|
/antispam |
Show current settings |
/antispam enable/disable |
Toggle anti-spam system |
/antispam messagelimit <1-20> |
Set message rate limit |
/antispam timewindow <1-60> |
Set time window (seconds) |
/antispam duplicatelimit <1-10> |
Set duplicate limit |
/antispam linkdetection <on/off> |
Toggle link detection |
/antispam linklimit <1-10> |
Set link spam limit |
/antispam muteduration <1-300> |
Set timeout duration |
/antispam whitelistrole <role> |
Whitelist/remove role |
/antispam whitelistchannel <channel> |
Whitelist/remove channel |
| Command | Description |
|---|---|
/setvoicemaster <channel> |
Set voice master channel |
/clearvoicemaster <channel> |
Remove voice master status |
/listvoicemaster |
List all voice master channels |
| Command | Description |
|---|---|
/setticket <channel> <category> |
Set up ticket system |
/removeticket |
Remove ticket system |
Detailed documentation available in the docs/ folder:
- Quick Setup Guide
- Setup Guide
- Troubleshooting
- Groq API Setup
- Anti-Spam Guide
- Voice Master Guide
- Voice Master Usage
- Voice Master Troubleshooting
nexus-discord-bot/
├── bot/ # Main bot package
│ ├── main.py # Bot entry point
│ ├── config.py # Configuration loader
│ └── extensions/ # Bot features (cogs)
│ ├── music_bot.py
│ ├── chat_system.py
│ ├── level_system.py
│ ├── anti_spam.py
│ ├── welcome_bot.py
│ ├── voice_master.py
│ ├── ticket_system.py
│ └── security_system.py
├── config/ # JSON configuration files
├── docs/ # Documentation
├── scripts/ # Startup scripts
├── tests/ # Test suite
├── .env # Environment variables (create this)
├── requirements.txt # Python dependencies
└── README.md # This file
Run the test suite:
# Run all tests
python -m pytest tests/
# Run specific test
python -m pytest tests/test_music_bot.pyContributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow PEP 8 style guidelines
- Add docstrings to all functions/classes
- Include tests for new features
- Update documentation as needed
- Keep commits atomic and well-described
Found a bug? Please open an issue with:
- Description of the bug
- Steps to reproduce
- Expected behavior
- Actual behavior
- Environment (OS, Python version, etc.)
- Logs (if applicable)
Have an idea? Open an issue with:
- Feature description
- Use case (why is this needed?)
- Proposed solution (if you have one)
- Python 3.8+
- discord.py - Discord API wrapper
- yt-dlp - YouTube downloader
- spotipy - Spotify API wrapper
- groq - AI chat (Groq API)
- FFmpeg - Audio processing
- python-dotenv - Environment variables
- 📝 ~4,100 lines of Python code
- 🎨 8 core features/extensions
- 📚 11 documentation files
- 🧪 14 test files
- ⭐ Production-ready quality
This bot is provided "as is" without warranty of any kind. Use at your own risk. Make sure to:
- Keep your API keys secure
- Never commit
.envfile to git - Regenerate tokens if exposed
- Follow Discord's Terms of Service
- Respect API rate limits
This project is licensed under the MIT License - see the LICENSE file for details.
- discord.py - Discord API wrapper
- yt-dlp - YouTube downloader
- Groq - AI inference API
- Spotify Web API - Spotify integration
- 📧 Email: abhishekk30034@gmail.com
- 💬 Discord: bruce.xe
- 🐛 Issues: GitHub Issues
If you find this project useful, please consider giving it a star! ⭐
Made with ❤️ for the Discord community