Manager Events

The RyanlinkManager emits events throughout the lifecycle of nodes and players. Listen on the manager instance directly.

Node Events

Event	Signature	Description
`nodeConnect`	`(node)`	Node WebSocket connected.
`nodeDisconnect`	`(node, reason)`	Node WebSocket disconnected. `reason.code`, `reason.reason`.
`nodeError`	`(node, error)`	Node encountered an error.
`nodeReady`	`(node, payload)`	Node session ready. `payload.resumed`, `payload.sessionId`.
`nodeRaw`	`(node, payload)`	Every raw WebSocket payload from the node.

Track Events

Event	Signature	Description
`trackStart`	`(player, track, payload)`	Track begins playing.
`trackEnd`	`(player, track, payload)`	Track finishes. `payload.reason`: `finished`, `replaced`, `stopped`, `loadFailed`, `cleanup`.
`trackStuck`	`(player, track, payload)`	Track stuck for `payload.thresholdMs` ms.
`trackError`	`(player, track, payload)`	Playback error or unresolved track failure. `payload.exception` contains severity and cause.

Queue Events

Event	Signature	Description
`queueEnd`	`(player)`	Queue exhausted — no more tracks.

Player Lifecycle Events

Event	Signature	Description
`playerCreate`	`(player)`	A new player was created.
`playerDestroy`	`(player, reason?)`	Player was destroyed.
`playerMove`	`(player, oldChannelId, newChannelId)`	Bot moved to a different voice channel.
`playerDisconnect`	`(player, channelId)`	Bot disconnected from voice (when `destroyPlayer: false` and `autoReconnect: false`).
`playerSocketClosed`	`(player, payload)`	Discord voice WebSocket closed. `payload.code`, `payload.reason`.

Player State Events

Event	Signature	Description
`playerUpdate`	`(player, oldJson, newJson)`	Node sent a position/ping update, or `player.syncState()` was called.

SponsorBlock Events Requires sponsorblock-plugin

Event	Signature	Description
`sponsorBlockSegmentsLoaded`	`(player, track, payload)`	Segments loaded for the current track.
`sponsorBlockSegmentSkipped`	`(player, track, payload)`	A segment was skipped. `payload.segment.category`.
`sponsorBlockChaptersLoaded`	`(player, track, payload)`	YouTube chapters loaded.
`sponsorBlockChapterStarted`	`(player, track, payload)`	A new chapter started.

Lyrics Events Requires lavalyrics-plugin or lavasrc-plugin

Event	Signature	Description
`lyricsFound`	`(player, track, payload)`	Lyrics found for the current track.
`lyricsNotFound`	`(player, track, payload)`	No lyrics found.
`lyricsLine`	`(player, track, payload)`	Real-time lyrics line event. `payload.line`, `payload.lineIndex`, `payload.skipped`.

Debug Event

Event	Signature	Description
`debug`	`(eventKey, eventData)`	Internal debug events. Only emitted when `advancedOptions.enableDebugEvents: true`. `eventData.state`: `'log' \| 'warn' \| 'error'`.

Usage Example

manager.on('trackStart', (player, track, payload) => {
  console.log(`[${player.guildId}] Now playing: ${track.info.title} by ${track.info.author}`);
});

manager.on('trackEnd', (player, track, payload) => {
  console.log(`[${player.guildId}] Ended (${payload.reason}): ${track.info.title}`);
});

manager.on('trackError', (player, track, payload) => {
  console.error(`[${player.guildId}] Error: ${payload?.exception?.message}`);
});

manager.on('queueEnd', (player) => {
  console.log(`[${player.guildId}] Queue empty`);
});

manager.on('playerCreate', (player) => {
  console.log(`[${player.guildId}] Player created`);
});

manager.on('playerDestroy', (player, reason) => {
  console.log(`[${player.guildId}] Player destroyed: ${reason}`);
});

manager.on('playerMove', (player, oldChannel, newChannel) => {
  console.log(`[${player.guildId}] Moved: ${oldChannel} → ${newChannel}`);
});

manager.on('playerSocketClosed', (player, payload) => {
  console.warn(`[${player.guildId}] WS closed: code=${payload.code} reason=${payload.reason}`);
});

manager.on('nodeConnect', (node) => {
  console.log(`[Node] ${node.id} connected`);
});

manager.on('nodeDisconnect', (node, reason) => {
  console.warn(`[Node] ${node.id} disconnected: ${reason.reason} (${reason.code})`);
});

manager.on('nodeReady', (node, payload) => {
  console.log(`[Node] ${node.id} ready — session: ${payload.sessionId}, resumed: ${payload.resumed}`);
});

manager.on('nodeError', (node, error) => {
  console.error(`[Node] ${node.id} error: ${error.message}`);
});

manager.on('sponsorBlockSegmentSkipped', (player, track, payload) => {
  console.log(`[SponsorBlock] Skipped: ${payload.segment.category}`);
});

manager.on('lyricsLine', (player, track, payload) => {
  console.log(`[Lyrics] ${payload.line.line}`);
});

manager.on('debug', (eventKey, eventData) => {
  if (eventData.state === 'error') console.error(`[Debug] ${eventKey}: ${eventData.message}`);
});