wavelinkcord 2.0.33

A robust and powerful Lavalink wrapper for Nextcord

Wavelink is a robust and powerful Lavalink wrapper for Nextcord. Wavelink features a fully asynchronous API that’s intuitive and easy to use with built in Spotify Support and Node Pool Balancing. This is a Fork of WaveLink which was modified to allow it to run on Nextcord.

Features:

• Fully Asynchronous

• Auto-Play and Looping (With the inbuilt Queue system)

• Spotify Support

• Node Balancing and Fail-over

• Supports Lavalink 3.7+

Documentation

Official Documentation

Support

For support using WaveLink, please join the official support server on Discord.

Installation

The following commands are currently the valid ways of installing WaveLink.

WaveLink 2 requires Python 3.10+

Windows

py -3.10 -m pip install -U Wavelink

Linux

python3.10 -m pip install -U Wavelink

Getting Started

See also: Examples

import nextcord
import wavelink
from nextcord.ext import commands

intents = nextcord.intents.all()
client = nextcord.Client()
bot = commands.Bot(command_prefix="?", intents=intents)

@bot.event
async def on_ready():
    print(f'Logged in {self.user} | {self.user.id}')
    bot.loop.create_task(on_node())

async def setup_hook():
    # Wavelink 2.0 has made connecting Nodes easier... Simply create each Node
    # and pass it to NodePool.connect with the client/bot.
    node: wavelink.Node = wavelink.Node(uri='http://localhost:2333', password='youshallnotpass')
    await wavelink.NodePool.connect(client=self, nodes=[node])

@bot.slash_command()
async def play(interaction : nextcord.Interaction, search : str):
    """Simple play command."""

    query = await wavelink.YoutubeTrack.search(search, return_first=True)

    destination = interaction.user.voice.channel

    if not interaction.guild.voice_client:
        vc: wavelink.Player = await destination.connect(cls=wavelink.Player)
    elif interaction.guild.voice_client:
        vc: wavelink.Player = interaction.guild.voice_client

    await vc.play(query)


@bot.slash_command()
async def disconnect(interaction : nextcord.Interaction):
    """Simple disconnect command.

    This command assumes there is a currently connected Player.
    """
    vc: wavelink.Player = interaction.guild.voice_client
    await vc.disconnect()

Lavalink Installation

Head to the official Lavalink repo and give it a star!

• Create a folder for storing Lavalink.jar and related files/folders.

• Copy and paste the example application.yml to application.yml in the folder we created earlier. You can open the yml in Notepad or any simple text editor.

• Change your password in the application.yml and store it in a config for your bot.

• Set local to true in the application.yml if you wish to use wavelink.LocalTrack for local machine search options… Otherwise ignore.

• Save and exit.

• Install Java 17(Windows) or Java 13+ on the machine you are running.

• Download Lavalink.jar and place it in the folder created earlier.

• Open a cmd prompt or terminal and change directory cd into the folder we made earlier.

• Run: java -jar Lavalink.jar

If you are having any problems installing Lavalink, please join the official Discord Server listed above for help.