🎵 Music Bot

Bot nhạc Discord hỗ trợ YouTube, Spotify, SoundCloud
Sử dụng Slash Commands, wavelink 3.x và Lavalink 4.x

---

✨ Tính năng

• 🎵 Phát nhạc từ YouTube, Spotify, SoundCloud
• ⌨️ Toàn bộ lệnh dạng Slash Commands (/play, /skip, ...)
• 🎛️ Embed Now Playing tự động cập nhật mỗi 30 giây
• 🔘 Nút tương tác: Stop / Skip / Pause / Loop ngay trên embed
• 📋 Xem queue phân trang, tự xóa sau 130 giây
• 🔀 Shuffle, Loop (bài / tất cả), Skip to vị trí bất kỳ
• 🔊 Chỉnh âm lượng 0–1000
• 📡 Voice channel status hiển thị tên bài đang phát

---

📋 Danh sách lệnh

Lệnh	Mô tả
/play <bài/link>	Phát nhạc từ YouTube / Spotify / SoundCloud
/addtrack <bài/link>	Thêm bài vào queue (không phát ngay)
/skip	Bỏ qua bài đang phát
/skipto <N>	Nhảy đến bài thứ N trong queue
/queue	Xem danh sách phát (phân trang)
/shuffle	Trộn ngẫu nhiên queue
/loop	Vòng qua chế độ: Tắt → Bài → Tất cả
/volume <0-1000>	Chỉnh âm lượng
/leave	Bot rời voice channel
/clear	Xóa toàn bộ queue
/help	Hiển thị danh sách lệnh

---

⚙️ Cài đặt

Yêu cầu

• Python 3.10+
• Java 17+ (để chạy Lavalink)

1. Clone repo

git clone https://github.com/zienshang/music-bot.git
cd music-bot

2. Cài thư viện Python

pip install -r requirements.txt

3. Tạo file .env

cp .env.example .env

Mở .env và điền thông tin:

DISCORD_TOKEN=your_bot_token_here
LAVALINK_URI=http://127.0.0.1:2333
LAVALINK_PASSWORD=youshallnotpass
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret

4. Cài đặt & chạy Lavalink

Tải Lavalink.jar và tạo application.yml cùng thư mục:

server:
  port: 2333
  address: 0.0.0.0

lavalink:
  server:
    password: "youshallnotpass"
    sources:
      youtube: false
      soundcloud: true

  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.1"
      repository: "https://maven.lavalink.dev/releases"
    - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:4.8.1"
      repository: "https://maven.lavalink.dev/releases"

plugins:
  youtube:
    enabled: true
    clients:
      - MUSIC
      - TVHTML5_SIMPLY
      - ANDROID_MUSIC
    oauth:
      enabled: true   # Lần đầu chạy sẽ yêu cầu xác thực Google

Khởi động Lavalink:

java -jar Lavalink.jar

Lần đầu bật OAuth: Terminal sẽ hiện link https://www.google.com/device kèm mã code — truy cập và đăng nhập tài khoản Google để xác thực.

5. Khởi động bot

python main.py
# Hoặc trên Windows:
start-music-bot.bat

---

📁 Cấu trúc project

music-bot/
├── main.py                  # Entry point
├── config.py                # Đọc cấu hình từ .env
├── requirements.txt
├── .env.example             # Template biến môi trường
├── start-music-bot.bat      # Script khởi động Windows
├── cogs/music/
│   ├── play.py              # /play
│   ├── addtrack.py          # /addtrack
│   ├── skip.py              # /skip
│   ├── skipto.py            # /skipto
│   ├── queue.py             # /queue
│   ├── shuffle.py           # /shuffle
│   ├── loop.py              # /loop
│   ├── volume.py            # /volume
│   ├── leave.py             # /leave
│   └── clear_queue.py       # /clear
└── utils/
    ├── help.py              # /help
    ├── helpers.py           # Hàm tiện ích
    ├── nowplaying.py        # Embed Now Playing + auto-refresh
    └── status.py            # Quản lý presence bot

---

🔧 Lấy token

Thứ	Link
Discord Bot Token	discord.com/developers
Spotify Client ID/Secret	developer.spotify.com

---

Made with ❤️ by zienshang