lavacord
Version:
A simple by design lavalink wrapper made for any discord library.
117 lines (89 loc) • 3.84 kB
Markdown
[](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
```