https://github.com/lavacord/lavacord
A easy to use Lavalink client that can be used with any discord api wrapper
https://github.com/lavacord/lavacord
bot discord discord-js discordjs eris lavalink lavalink-client lavalink-music lavalink-wrapper
Last synced: 18 days ago
JSON representation
A easy to use Lavalink client that can be used with any discord api wrapper
- Host: GitHub
- URL: https://github.com/lavacord/lavacord
- Owner: lavacord
- License: apache-2.0
- Created: 2018-08-11T06:13:05.000Z (over 6 years ago)
- Default Branch: LL-v4
- Last Pushed: 2025-03-12T17:10:42.000Z (about 1 month ago)
- Last Synced: 2025-04-04T07:36:12.187Z (18 days ago)
- Topics: bot, discord, discord-js, discordjs, eris, lavalink, lavalink-client, lavalink-music, lavalink-wrapper
- Language: TypeScript
- Homepage:
- Size: 756 KB
- Stars: 84
- Watchers: 2
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://discord.gg/wXrjZmV)
[](https://www.npmjs.com/package/lavacord)
[](https://www.npmjs.com/package/lavacord)
[](https://github.com/lavacord/lavacord/)
[](https://depfu.com/github/lavacord/Lavacord?project_id=11810)
[](https://www.codacy.com/app/lavacord/lavacord)
# LavaCord
A simple and easy to use lavalink wrapper.
## Documentation
[**lavacord.github.io/lavacord**](https://lavacord.github.io/Lavacord/)
## Installation
**For stable**
```bash
# Using yarn
yarn add lavacord
# Using npm
npm install lavacord
```
**For Development**
```bash
# Using yarn
yarn add lavacord/lavacord
# Using npm
npm install lavacord/lavacord
```
## LavaLink configuration
Download Lavalink from [their GitHub releases](https://github.com/lavalink-devs/Lavalink/releases)
Put an `application.yml` file in your working directory. [Example](https://github.com/lavalink-devs/Lavalink/blob/master/LavalinkServer/application.yml.example)
Run with `java -jar Lavalink.jar`
## The issue tracker is for issues only
If you're having a problem with the module contact us in the [**Discord Server**](https://discord.gg/wXrjZmV)
# Implementation
Start by creating a new `Manager` passing an array of nodes and an object with `user` the client's user id.
```javascript
// import the Manager class from lavacord
const { Manager } = require("lavacord");
// Define the nodes array as an example
const nodes = [
{ id: "1", host: "localhost", port: 2333, password: "youshallnotpass" }
];
// Initilize the Manager with all the data it needs
const manager = new Manager(nodes, {
user: client.user.id, // Client id
send: (packet) => {
// this needs to send the provided packet to discord's WS using the method from your library.
// use the bindings for the discord library you use if you don't understand this
}
});
// Connects all the LavalinkNode WebSockets
await manager.connect();
// The error event, which you should handle otherwise your application will crash when an error is emitted
manager.on("error", (error, node) => {
error, // is the error
node // is the node which the error is from
});
```
Resolving tracks using LavaLink REST API
```javascript
const { Rest } = require("lavacord");
async function getSongs(search) {
// This gets the best node available, what I mean by that is the idealNodes getter will filter all the connected nodes and then sort them from best to least beast.
const node = manager.idealNodes[0];
return Rest.load(node, search)
.catch(err => {
console.error(err);
return null;
});
}
getSongs("ytsearch:30 second song").then(songs => {
// handle loading of the tracks somehow ¯\_(ツ)_/¯
});
```
Joining and Leaving channels
```javascript
// Join
const player = await manager.join({
guild: guildId, // Guild id
channel: channelId, // Channel id
node: "1" // lavalink node id, based on array of nodes
});
await player.play(track); // Track is a base64 string we get from Lavalink REST API
player.once("error", error => console.error(error));
player.once("end", data => {
if (data.type === "TrackEndEvent" && data.reason === "replaced") return; // Ignore replaced reason to prevent skip loops
// Play next song
});
// Leave voice channel and destroy Player
await manager.leave(guildId); // Player ID aka guild id
```