Laffey

An adorable lavalink discord music bot that has a lot of features inside it.

First Project of Weeb-Devs

Features:

✓ High quality
✓ Support filters
✓ Stable
✓ Suport 8 music sources
✓ Feature-rich
✓ per guild prefix configuration
✓ and of course, adorable shipgirl

Current version:

• 0.1.2 (latest) Release | Change Log
• 0.1.1 Release | Change Log
• 0.1.0 Release | Change Log

Requirements:

Lavalink server

You need dev lavalink version to use our filters. You can get it by clicking Here and then, click on Lavalink.jar files How to setup
All required OS and other for lavalink server available here

Server for the bot to run

• nodejs v14.x.x or higher because we're using ? method
• discordjs v12.x.x or higher

Data

• Discord bot's token You should know why you need this or you won't go to this repo Get or create bot here | How to get token
• Mongodb URI for prefix feature. It won't work if you enter invalid or no URI MongoDB
• Your ID for eval command. It's dangerous if eval accessible to everyone
• Spotify client ID for spotify support Click here to get
• Spotify client Secret for spotify support Click here to get
• Ksoft API Key additional, but you can't use lyrics if you didn't provide it Click here to get
• Lavalink server
  • Host url to your lavalink server
  • Password your lavalink's password. Default is youshallnotpass
  • Port port for your lavalink server. Default is 80
  • Identifier Name for your node. Default to its url
  • Retry amount retry amount when the node encounted error. Default is 3
  • Retry delay delay for each retry. Default is 1000 (1s)
  • Secure wether your node use ssl connection. Default is false

Note

• Why use ksoft.si api and not other? Because other modules are bad and we have to provide a very specific title which is ksoft.si didn't

Available music sources:

• youtube*
• bandcamp*
• soundcloud*
• twitch*
• vimeo*
• http (you can use radio for it)*
• spotify
• deezer

Configuration & Starting the bot:

1. First, change config.json.example file's name into config.json, and fill it

{
    "TOKEN": "YOUR TOKEN",
    "PREFIX": "?",
    "OWNERS": [
        "Your discord id for eval, can be more than 1 user"
    ],
    "MONGODB_URI": "Additional, but needed for custom prefix feautre",
    "SPOTIFY_CLIENT_ID": "spotify client id for spotify support",
    "SPOTIFY_CLIENT_SECRET": "spotify client secret for spotify support",
    "KSOFT_API_KEY": "KSOFT API Key to use lyrics feature",
    "NODES": [
        {
            "HOST": "lavalink's host",
            "PASSWORD": "lavalink's password",
            "PORT": 80,
            "IDENTIFIER": "lavalink's identifier. Additional",
            "RETRY_AMOUNT": 3,
            "RETRY_DELAY": 1000,
            "SECURE": false
        }
    ],
    "DEBUG": true,
    "LOG_USAGE": false
}

2. Go to your console, and type cd "path to laffey's file" and install all dependencies by typing npm i
3. You're ready to go, use node . or npm start to start the bot

Screenshots

Commands

• music

  • play play music from 7 music sources
    -aliases: p
    -example: ?play https://www.youtube.com/playlist?list=PL0jh16Vp3NzVjEjKbZ3pV4f15Jze5EANV

  • forceplay same like play, but this will force the player to play specific song
    -aliases: fp
    -example: ?forceplay https://www.youtube.com/watch?v=dQw4w9WgXcQ

  • loop toggle track/queue loop
    -aliases: l
    -example: ?loop

  • lyrics Get specific/current playing song's lyrics
    -aliases: ly
    -example: ?lyrics [ song's title ]

  • volume Set player's volume. 0-1000
    -aliases: v
    -example: ?volume 1000

  • nowplaying see current playing song
    -aliases: np
    -example: ?nowplaying

  • move Move song
    -aliases: -
    -example: ?move 2 | ?move 4 3

  • queue check all songs inside queue
    -aliases: q
    -example: ?queue

  • skip skip the song
    -aliases: s
    -example: ?skip

  • skipto skip to specific song
    -aliases: st, jump, jumpto
    -example: ?skipto 3

  • join Join a voice channel
    -aliases: -
    -example: ?join

  • leave Leave a voice channel
    -aliases: stop
    -example: ?leave

  • shuffle Shuffle queue
    -aliases: -
    -example: ?shuffle

  • clear Clear the queue
    -aliases: -
    -example: ?clear

  • bassboost Set bassboost filter for the player
    -aliases: bb
    -example: ?bassboost [reset | 1 - 2000]

  • 24h whether the bot to leave vc when there's no user or not
    -aliases: -
    -example: ?24h

  • vaporwave Set vaporwave filter for the player
    -aliases: -
    -example: ?vaporwave

  • nightcore Set nightcore filter for the player
    -aliases: nc
    -example: ?nightcore

  • 8d Set 8d filter for the player
    -aliases: -
    -example: ?8d

  • remove Remove song from queue
    -aliases: -
    -example: ?remove 3

  • previous Play song that played previously
    -aliases: pr
    -example: ?previous

  • resume Resume the player
    -aliases: r
    -example: ?resume

  • pause Pause the player
    -aliases: -
    -example: ?pause

• config

  • prefix get, set, or reset prefix on guild
    -aliases: -
    -example: ?prefix set ! | ?prefix reset | ?prefix get

• misc

  • ping get bot's ping
    -aliases: -
    -example: ?ping

  • help Show list of available commands
    -aliases: h
    -example: ?help play

  • eval to evaluate code
    -aliases: -
    -example: ?eval message.channel.send('hello')

  • about Give information about this project
    -aliases: -
    -example: ?about

  • stats Give bot's stats
    -aliases: -
    -example: ?stats adv

  • node Give lavalink's stats
    -aliases: -
    -example: ?node

  • invite Invite your bot to another guild
    -aliases: -
    -example: ?invite

Description & About

Created at: Friday, 2 April 2021
Published at: Sunday, 11 April 2021
Laffey is Weeb-Devs's first project. Was created by our first member aka owner, Takiyo. He really wants to make his first open source project ever. Because he wants more for coding experience. In this project, he was challenged to make project with less bugs. Hope you enjoy using Laffey!