Fastlink
About
FastLink is a NodeJs Lavalink client, with a low-level representation of the Lavalink API, with a simple and easy-to-use API.
Able to be installed in most NodeJs versions, and with low memory usage, FastLink is a good choice for your Discord bot.
Recommendations
- NodeJs 16.6.0 or higher (ES6)
- NodeLink for performance, Lavalink for stability.
Installation
You can install FastLink through npm:
$ npm i PerformanC/FastLink
And that's it, you'll be able to use FastLink in your project.
Example
import FastLink from 'fastlink'
const events = Lavalink.node.connectNodes([{
hostname: '127.0.0.1',
secure: false,
password: 'youshallnotpass',
port: 2333
}], {
botId: 'Your bot Id here',
shards: 1,
queue: true,
debug: true
})
client.on('messageCreate', async (message) => {
if (message.content.startsWith(prefix + 'decodetrack')) {
const node = Lavalink.player.createPlayer(message.guild.id)
const player = new Lavalink.player.Player(node, message.guild.id)
let track = await player.decodeTrack(message.content.replace(prefix + 'decodetrack ', ''))
return message.channel.send(JSON.stringify(track, null, 2))
}
if (message.content.startsWith(prefix + 'play')) {
if (!message.member.voice.channel) return message.channel.send('You need to be in a voice channel to use this command.')
const node = Lavalink.player.createPlayer(message.guild.id)
const player = new Lavalink.player.Player(node, message.guild.id)
player.connect(message.member.voice.channel.id.toString(), (guildId, payload) => {
client.guilds.cache.get(guildId).shard.send(payload)
})
let track = await player.loadTrack((message.content.replace(prefix + 'play ', '').startsWith('https://') ? '' : 'ytsearch:') + message.content.replace(prefix + 'play ', ''))
if (track.loadType == 'error')
return message.channel.send('Something went wrong. ' + track.data.message)
if (track.loadType == 'empty')
return message.channel.send('No matches found.')
if (track.loadType == 'playlist') {
player.update({ encodedTracks: track.data.tracks.map((track) => track.encoded) })
return message.channel.send(`Added ${track.data.tracks.length} songs to the queue, and playing ${track.data.tracks[0].info.title}.`)
}
if (track.loadType == 'track') {
player.update({ encodedTrack: track.data.encoded, })
return message.channel.send(`Playing ${track.data.info.title} from ${track.data.info.sourceName} from url search.`)
}
if (track.loadType == 'search') {
player.update({ encodedTrack: track.data[0].encoded })
return message.channel.send(`Playing ${track.data[0].info.title} from ${track.data[0].info.sourceName} from search.`)
}
}
// volume
if (message.content.startsWith(prefix + 'volume')) {
const player = Lavalink.player.getPlayer(message.guild.id)
if (!player) return message.channel.send('No player found.')
Lavalink.player.update(player, message.guild.id, {
volume: parseInt(message.content.replace(prefix + 'volume ', ''))
})
}
//pause
if (message.content.startsWith(prefix + 'pause')) {
const node = Lavalink.player.getPlayer(message.guild.id)
if (!node) return message.channel.send('No player found.')
const player = new Lavalink.player.Player(node, message.guild.id)
player.update({ paused: true })
}
//resume
if (message.content.startsWith(prefix + 'resume')) {
const node = Lavalink.player.getPlayer(message.guild.id)
if (!node) return message.channel.send('No player found.')
const player = new Lavalink.player.Player(node, message.guild.id)
player.update({ paused: false })
}
if (message.content.startsWith(prefix + 'skip')) {
const node = Lavalink.player.getPlayer(message.guild.id)
if (!node) return message.channel.send('No player found.')
const player = new Lavalink.player.Player(node, message.guild.id)
const skip = player.skipTrack()
if (skip.skipped) return message.channel.send('Skipped the current track.')
if (!skip.skipped) return message.channel.send('Could not skip the current track.')
}
//stop
if (message.content.startsWith(prefix + 'stop')) {
const node = Lavalink.player.getPlayer(message.guild.id)
if (!node) return message.channel.send('No player found.')
const player = new Lavalink.player.Player(node, message.guild.id)
player.update({ encodedTrack: null })
}
})
client.on('raw', (data) => Lavalink.other.handleRaw(data))
client.login('Your bot token here')
Documentation
We have a documentation for FastLink, you can find it here. If you have any issue with it, please report it on GitHub Issues.
Support
In case of any issue using it (except bugs, that should be reported on GitHub Issues), you are free to ask on PerformanC's Discord server.
License
FastLink is licensed under PerformanC's custom license, which is a modified version of the MIT license. You can find it here
The license is made to protect PerformanC's software(s) and to prevent people from stealing our code. You are free to use FastLink in your projects, but you are not allowed to get any part of the code without our permission. You are also not allowed to remove the license from the project.