Player Events: Track Events

These events are triggered during the lifecycle of track playback — from start, to end, to error handling.
They are useful for reacting to playback changes or handling track failures gracefully.
These interfaces extend BaseEvent.

TrackStartEvent

Emitted when a track begins playback.
Extends: BaseEvent.

Property	Type	Description	Optional
op	string = "event"	Lavalink operation type.
type	string = "TrackStartEvent"	Event type identifier.
guildId	string	Guild this event applies to.
track	TrackData	Track that started playing.

---

TrackEndEvent

Emitted when a track finishes playing, whether normally or due to skipping, failure, or replacement.
Extends: BaseEvent.

Property	Type	Description	Optional
op	string = "event"	Lavalink operation type.
type	string = "TrackEndEvent"	Event type identifier.
guildId	string	Guild this event applies to.
track	TrackData	Track that ended.
reason	TrackEndReasonTypes	Reason for track ending.

---

TrackExceptionEvent

Emitted when a track fails during playback due to an internal error.
Extends: BaseEvent.

Property	Type	Description	Optional
op	string = "event"	Lavalink operation type.
type	string = "TrackExceptionEvent"	Event type identifier.
guildId	string	Guild this event applies to.
exception	Exception | undefined	Error details from Lavalink.

---

TrackStuckEvent

Emitted when Lavalink fails to decode audio frames within the given threshold — often indicating a corrupted or inaccessible track.
Extends: BaseEvent.

Property	Type	Description	Optional
op	string = "event"	Lavalink operation type.
type	string = "TrackStuckEvent"	Event type identifier.
guildId	string	Guild this event applies to.
thresholdMs	number	Threshold in milliseconds Lavalink waited before reporting stuck.