lewdhutao / musicbot

Yet another Discord Music Bot using Discord.js v14 and Lavalink v4

Discord Music Bot

Features

• Built using Discord.js v14 and Lavalink v4
• Supports Slash Commands, Context Commands, and Prefix Commands
• User-friendly and easy to set up
• 24/7 Music Playback
• Customizable Prefix
• Supports Docker

Supported Sources

Required Plugins

Note: If you use Lavalink Docker, LavaSrc and Youtube-Source Plugins are already installed. You just need to set up in lavalink/application.yml

Requirements

• Node Version v18.x or higher
• Lavalink v4
• MongoDB (You can set up a free MongoDB server here)

Installation

You can run this bot with or without Docker. For an easy setup, use the make command. If make is not available, use run.sh. Ensure Docker is installed on your machine to use the bot with Docker.

Using Make

Without Make

• Before using ./run.sh, make sure to run chmod +x ./run.sh.

Before you start the bot, ensure you have filled out everything in src/config.js.

Command Usage (Docker)

1. make start or ./run.sh start: Starts the bot with Lavalink using Docker Compose.

2. make start-noll or ./run.sh start-noll: Starts the bot without Lavalink using Docker Compose.

3. make restart or ./run.sh restart: Restarts the bot.

4. make stop or ./run.sh stop: Stops the bot.

5. make clean or ./run.sh clean: Removes Docker containers.

Command Usage (Without Docker)

1. make start-local or ./run.sh start local: Starts the bot locally on your machine without Docker Compose.

Note: If you use a VPS and start the bot without Docker, make sure to use pm2 to keep the bot online 24/7.

Preview

LICENSE

This project is licensed under the ISC License. You are free to use the music bot for any purpose, including making it public or verifying the bot.

musicbot's Issues

Version 1.0.0

v1.0.0 checklist

• Bot structure
• Use docker
• Use makefile for easy setup
• Add slash command
• Add client events
• Add node events
• Add message command
• Add context command
• Add custom prefix
• Add lavalink docker
• Better logger
• Add mongo structure for db

error on make start

Musicbot v1.0.5

• Add permissions check before send message
• Refactor player handler code
• Refactor code how bot join stage channel
• Manually disconnect the bot from vc will now destroy the player
• Fix player automatically stopped after changing voice channel region
• Fix player destroy by itself if track empty or error without checking the player
• Fix track stuck/error message is not deleted
• Fix lyrics command not working if no query
• Fix track stop play after move to other vc
• Fix bot join the vc if no query when use play prefix cmd
• Fix player not destroy properly if 24/7 or autoplay mode is enabled
• Fix bot return error if no permission to connect to stage as speaker
• Fix canvas deleted by itself if permissions is not correct for the bot

All commit are pushed to https://github.com/lewdhutao/musicbot/tree/dev