# 🎵 Moon Beatz - Premium Music Bot

**Moon Beatz** is a high-performance Discord music bot with advanced features and crystal-clear audio quality. Experience seamless music streaming with support for multiple platforms!

---

## ✨ Key Features

### 🎶 **Multi-Platform Support**
- 🎵 YouTube & YouTube Music
- 🟢 Spotify (tracks, playlists, albums, artists)
- 🔊 SoundCloud
- 🎧 JioSaavn (Indian music)
- 📻 Direct URL playback

### 🎤 **Advanced Music Features**
- 📜 **Real-time Synced Lyrics** - LavaLyrics integration
- 🎚️ **Audio Filters** - Bass boost, nightcore, 8D, vaporwave, and 15+ more
- 🔊 **Volume Control** - Precise adjustment (0-200%)
- 🔁 **Loop Modes** - Track, queue, and autoplay
- ⏩ **Seek & Rewind** - Jump to any position
- 🎲 **Queue Management** - Shuffle, remove, move, clear
- 🔄 **24/7 Mode** - Keep music playing non-stop

### 🎮 **Interactive Controls**
- 🎛️ **Music Panel** - Beautiful interactive embed with buttons
- ⏯️ **Button Controls** - Play, pause, skip, stop with one click
- 📊 **Visual Queue** - Paginated queue display
- 🎯 **Smart Search** - Intelligent track search

### 🎯 **Server Management**
- 🔒 **DJ Role System** - Restrict controls to specific roles
- 🚫 **Channel Restrictions** - Control where bot can be used
- ⚙️ **Full Customization** - Extensive configuration options
- 📢 **Track Announcements** - Notify when tracks change

### ⚡ **Performance & Reliability**
- 🚀 **Auto-Sharding** - Scales automatically
- ⚙️ **Cluster Management** - Distributed processing
- 🔄 **Auto-Reconnect** - Resilient connections
- 💾 **Redis Caching** - Lightning-fast responses
- 🛡️ **Error Handling** - Graceful recovery

---

## 🎵 Essential Commands

### Playback
```
/play <song>      - Play a song or playlist
/pause            - Pause playback
/resume           - Resume playback
/skip             - Skip current track
/stop             - Stop and clear queue
/nowplaying       - Show current track
```

### Queue
```
/queue            - Display queue
/shuffle          - Shuffle queue
/remove <pos>     - Remove track
/clear            - Clear queue
/jump <pos>       - Jump to track
```

### Advanced
```
/lyrics           - Show synced lyrics
/filter <filter>  - Apply audio filter
/volume <0-200>   - Adjust volume
/seek <time>      - Seek to timestamp
/loop <mode>      - Set loop mode
/24/7             - Toggle 24/7 mode
```

### Utility
```
/stats            - Bot statistics
/help             - Command list
/ping             - Check latency
```

---

## 🎛️ Audio Filters

Transform your music with professional filters:

🔊 **Bass Boost** • 🌃 **Nightcore** • 🌊 **Vaporwave** • 🎭 **8D Audio**  
🎪 **Karaoke** • 🎸 **Soft** • 🎺 **Treble** • 📻 **Radio** • 🔥 **And more!**

---

## 🚀 Getting Started

1. **[Add Moon Beatz](https://discord.com/oauth2/authorize?client_id=936647052815925349&permissions=1759218604441591&response_type=code&redirect_uri=https%3A%2F%2Fdiscord.gg%2Fn32EH9bPU7&integration_type=0&scope=bot+applications.commands+identify)** to your server
2. **Join a voice channel**
3. Use `/play <song>` to start
4. Control with **interactive buttons** or **slash commands**

---

## 🔐 Required Permissions

**Essential:**
- ✅ View Channels
- ✅ Send Messages & Embed Links
- ✅ Connect & Speak (Voice)
- ✅ Use Voice Activity

**Recommended:**
- ✅ Manage Messages
- ✅ Use External Emojis
- ✅ Read Message History

---

## 💎 Vote for Premium Features

Vote on Top.gg to unlock:

- 🎵 Extended Queue Limits
- 🎚️ All Audio Filters
- ⏩ Priority Queue Processing

---

## 📊 Why Choose Moon Beatz?

✅ **99.9% Uptime** - Always reliable  
✅ **Auto-Sharding** - Optimal performance  
✅ **Regular Updates** - New features weekly  
✅ **Active Support** - Responsive team  
✅ **Free Core Features** - No paywalls  
✅ **Privacy Focused** - Secure & safe  

---

## 🛠️ Built With

- **Discord.js v14** - Latest Discord API
- **Moonlink.js** - Advanced audio streaming
- **Lavalink** - High-performance audio
- **Redis** - Fast caching
- **MongoDB** - Reliable storage
- **TypeScript** - Type-safe code

---

## 🔗 Important Links

- 💬 **[Support Server](https://discord.gg/n32EH9bPU7)** - Get help & updates
- 📚 **Commands** - Use `/help` in Discord
- 🐛 **Report Issues** - Join support server

---

## 🙏 Support Development

Love Moon Beatz? Help us grow:

- ⭐ Vote on Top.gg
- 📢 Invite to more servers
- 💬 Join our [support server](https://discord.gg/n32EH9bPU7)
- 🐛 Report bugs & suggest features

---

**Experience premium Discord music. Add Moon Beatz today!**

[**Add to Discord**](https://discord.com/oauth2/authorize?client_id=936647052815925349&permissions=1759218604441591&response_type=code&redirect_uri=https%3A%2F%2Fdiscord.gg%2Fn32EH9bPU7&integration_type=0&scope=bot+applications.commands+identify) • [**Support**](https://discord.gg/n32EH9bPU7)

Moon Beatz

Advanced music bot with auto-sharding, premium features, lyrics, filters, and 24/7 playback. Supports Spotify, YouTube, SoundCloud & more! 

Voto per Moon Beatz

Do you want to support us?