A Discord Music Bot written in TypeScript using Sapphire, discord.js, Next.js and React

System dependencies

• Node.js LTS or latest
• Java 13 (other versions have some issues with Lavalink)

Setup bot

Create an application.yml file root folder.

Download the latest Lavalink jar from here and also place it in the root folder.

PostgreSQL

Linux

Either from the official site or follow the tutorial for your distro.

MacOS

Get brew, then enter 'brew install postgresql'.

Windows

Getting Postgres and Prisma to work together on Windows is not worth the hassle. Create an account on heroku and follow these steps:

1. Open the dashboard and click on 'New' > 'Create new app', give it a name and select the closest region to you then click on 'Create app'.
2. Go to 'Resources' tab, under 'Add-ons' search for 'Heroku Postgres' and select it. Click 'Submit Order Form' and then do the same step again (create another postgres instance).
3. Click on each 'Heroku Postgres' addon you created, go to 'Settings' tab > Database Credentials > View Credentials and copy the each one's URI to either DATABASE_URL or SHADOW_DB_URL in the .env file you will be creating in the settings section.
4. Done!

Redis

MacOS

brew install redis.

Windows

Download from here.

Linux

Follow the instructions here.

Settings (env)

Create a .env file in the root directory and copy the contents of .env.example to it. Note: if you are not hosting postgres on Heroku you do not need the SHADOW_DB_URL variable.

# DB URL
DATABASE_URL="postgresql://john:doe@localhost:5432/master-bot?schema=public"

# Bot Token
DISCORD_TOKEN=""

NEXTAUTH_SECRET="somesupersecrettwelvelengthword"
NEXTAUTH_URL=
NEXTAUTH_URL_INTERNAL=http://localhost:3000
NEXT_PUBLIC_INVITE_URL="https://discord.com/api/oauth2/authorize?client_id=yourclientid&permissions=8&scope=bot"

# Next Auth Discord Provider
DISCORD_CLIENT_ID=""
DISCORD_CLIENT_SECRET=""

# Lavalink
LAVA_HOST="0.0.0.0"
LAVA_PASS="youshallnotpass"
LAVA_PORT=2333
LAVA_SECURE=false

# Spotify
SPOTIFY_CLIENT_ID=""
SPOTIFY_CLIENT_SECRET=""

# Twitch
TWITCH_CLIENT_ID=""
TWITCH_CLIENT_SECRET=""

# Other APIs
TENOR_API=""
NEWS_API=""
GENIUS_API=""
RAWG_API=""

Gif features

If you have no use in the gif commands, leave everything under 'Other APIs' empty. Same applies for Twitch, everything else is needed.

DB URL

Change 'john' to your pc username and 'doe' to some password, or set the name and password you created when you installed Postgres.

Bot Token

Generate a token in your Discord developer portal.

Next Auth

You can leave everything as is, just change 'yourclientid' in NEXT_PUBLIC_INVITE_URL to your Discord bot id and then change 'domain' in NEXTAUTH_URL to your domain or public ip. You can find your public ip by going to www.whatismyip.com.

Next Auth Discord Provider

Go to the OAuth2 tab in the developer portal, copy the Client ID to DISCORD_CLIENT_ID and generate a secret to place in DISCORD_CLIENT_SECRET. Also, set the following URLs under 'Redirects':

• http://localhost:3000/api/auth/callback/discord
• http://domain:3000/api/auth/callback/discord

Make sure to change 'domain' in http://domain:3000/api/auth/callback/discord to your domain or public ip.

Lavalink

You can leave this as long as the values match your application.yml.

Spotify and Twitch

Create an application in each platform's developer portal and paste the relevant values.

Pnpm

Install pnpm: npm install -g pnpm or on Windows iwr https://get.pnpm.io/install.ps1 -useb | iex or on Mac using Homebrew brew install pnpm

Running the bot

1. If you followed everything right, hit pnpm i in the root folder. When it finishes make sure prisma didn't error.
2. Open a separate terminal in the root folder and run 'java -jar Lavalink.jar' (must be running all the time).
3. Wait a few seconds and run pnpm dev in the root folder in another terminal window.
4. If everything works, your bot and dashboard should be running.
5. Enjoy!

Commands

A full list of commands for use with Master Bot

Music

Command	Description	Usage
/play	Play any song or playlist from youtube, you can do it by searching for a song by name or song url or playlist url	/play darude sandstorm
/pause	Pause the current playing song	/pause
/resume	Resume the current paused song	/resume
/leave	Leaves voice channel if in one	/leave
/remove	Remove a specific song from queue by its number in queue	/remove 4
/queue	Display the song queue	/queue
/shuffle	Shuffle the song queue	/shuffle
/skip	Skip the current playing song	/skip
/skipall	Skip all songs in queue	/skipall
/skipto	Skip to a specific song in the queue, provide the song number as an argument	/skipto 5
/volume	Adjust song volume	/volume 80
/music-trivia	Engage in a music trivia with your friends. You can add more songs to the trivia pool in resources/music/musictrivia.json	/music-trivia
/loop	Loop the currently playing song or queue	/loop
/lyrics	Get lyrics of any song or the lyrics of the currently playing song	/lyrics song-name
/now-playing	Display the current playing song with a playback bar	/now-playing
/move	Move song to a desired position in queue	/move 8 1
/queue-history	Display the queue history	/queue-history
/create-playlist	Create a custom playlist	/create-playlist 'playlistname'
/save-to-playlist	Add a song or playlist to a custom playlist	/save-to-playlist 'playlistname' 'yt or spotify url'
/remove-from-playlist	Remove a track from a custom playlist	/remove-from-playlist 'playlistname' 'track location'
/my-playlists	Display your custom playlists	/my-playlists

Gifs

Command	Description	Usage
/gif	Get a random gif	/gif
/jojo	Get a random jojo gif	/jojo
/gintama	Get a random gintama gif	/gintama
/anime	Get a random anime gif	/anime
/baka	Get a random baka gif	/baka
/cat	Get a cute cat picture	/cat
/doggo	Get a cute dog picture	/doggo
/hug	Get a random hug gif	/hug
/slap	Get a random slap gif	/slap
/pat	Get a random pat gif	/pat
/triggered	Get a random triggered gif	/triggered
/amongus	Get a random Among Us gif	/amongus

Other

Command	Description	Usage
/fortune	Get a fortune cookie tip	/fortune
/insult	Generate an evil insult	/insult
/chucknorris	Get a satirical fact about Chuck Norris	/chucknorris
/motivat