v3.1.0

Version 3.1.0

This release adds some QoL features that have been frequently requested, and adds support for plugin events.

Documentation:
https://wavelink.dev

Support:
Discord Server

Caution

You can no longer use a BETA version of Lavalink on this release. Please upgrade your Lavalink to a stable version 4+.

Additions

Playable:

• Playable.extras
  _{Updates to support userData field in Lavalink.}

Node:

• Node.fetch_info
• Node.fetch_stats
• Node.fetch_version
• Node.fetch_player_info
• Node.fetch_players
  _{All the above endpoints have been made public.}

Important

Node.fetch_player_info and Node.fetch_players are not the same as Node.get_player. Please read the documentation before using these endpoints for more details.

Payloads:

• StatsResponsePayload
• PlayerStatePayload
• VoiceStatePayload
• PlayerResponsePayload
• GitResponsePayload
• VersionResponsePayload
• PluginResponsePayload
• InfoResponsePayload
• ExtraEventPayload
  _{These payloads correspond to all the data received in the above endpoints, minus ExtraEventPayload which will be received in the on_wavelink_extra_event event.}

Events:

• on_wavelink_extra_event
  _{An event fired when an event that is unknown/unhandled by default is received, usually from Lavalink Plugins.}

Warning

Make sure you know the source of your event when using on_wavelink_extra_event. Lavalink does not provide this information by default.

Utils:

• ExtrasNamespace
  _{ExtrasNamespace is a container class that holds all the information sent to Lavalink via the userData field which can be set by passing a dict of str keys to Any value (Must be convertible to JSON) to Playable.extras. Please see documentation for more details.}

Changes

Internally Wavelink now sends a different payload to Lavalink when playing a track or skipping. This is inline with Lavalink changes. Please upgrade your Lavalink to a stable version 4+ if you are currently on a beta version.