lavalink-client 2.5.10 → 2.6.1

package/dist/index.d.mts

@@ -449,6 +449,138 @@ declare class FilterManager {
     clearEQ(): Promise<this>;
 }
 
+/** Sourcenames provided by lavalink server */
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+/** Source Names provided by lava src plugin */
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz";
+/** Source Names provided by jiosaavan plugin */
+type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
+/** The SourceNames provided by lavalink */
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
+interface LavalinkTrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    length: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface TrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    duration: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface PluginInfo {
+    /** The Type provided by a plugin */
+    type?: "album" | "playlist" | "artist" | "recommendations" | string;
+    /** The Identifier provided by a plugin */
+    albumName?: string;
+    /** The url of the album */
+    albumUrl?: string;
+    /** The url of the album art */
+    albumArtUrl?: string;
+    /** The url of the artist */
+    artistUrl?: string;
+    /** The url of the artist artwork */
+    artistArtworkUrl?: string;
+    /** The url of the preview */
+    previewUrl?: string;
+    /** Whether the track is a preview */
+    isPreview?: boolean;
+    /** The total number of tracks in the playlist */
+    totalTracks?: number;
+    /** The Identifier provided by a plugin */
+    identifier?: string;
+    /** The ArtworkUrl provided by a plugin */
+    artworkUrl?: string;
+    /** The Author Information provided by a plugin */
+    author?: string;
+    /** The Url provided by a Plugin */
+    url?: string;
+    /** The Url provided by a Plugin */
+    uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        previousTrack?: boolean;
+        [key: string]: any;
+    };
+}
+interface LavalinkTrack {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: LavalinkTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The Track's Requester */
+    requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface UnresolvedTrackInfo extends Partial<TrackInfo> {
+    /** Required */
+    title: string;
+}
+interface UnresolvedQuery extends UnresolvedTrackInfo {
+    /** The base64 of the unresolved track to "encode" */
+    encoded?: Base64;
+}
+interface UnresolvedTrack {
+    /** Required */
+    resolve: (player: Player) => Promise<void>;
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: UnresolvedTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+    /** The Track's Requester */
+    requester?: unknown;
+}
+
 declare class QueueSaver {
     /**
      * The queue store manager
@@ -669,7 +801,7 @@ declare class Player {
     /** The current Positin of the player (Calculated) */
     get position(): number;
     /** The timestamp when the last position change update happened */
-    lastPositionChange: number;
+    lastPositionChange: number | null;
     /** The current Positin of the player (from Lavalink) */
     lastPosition: number;
     lastSavedPosition: number;
@@ -862,138 +994,6 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
-/** Sourcenames provided by lavalink server */
-type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
-/** Source Names provided by lava src plugin */
-type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz";
-/** Source Names provided by jiosaavan plugin */
-type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
-/** The SourceNames provided by lavalink */
-type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
-interface LavalinkTrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    length: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface TrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    duration: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface PluginInfo {
-    /** The Type provided by a plugin */
-    type?: "album" | "playlist" | "artist" | "recommendations" | string;
-    /** The Identifier provided by a plugin */
-    albumName?: string;
-    /** The url of the album */
-    albumUrl?: string;
-    /** The url of the album art */
-    albumArtUrl?: string;
-    /** The url of the artist */
-    artistUrl?: string;
-    /** The url of the artist artwork */
-    artistArtworkUrl?: string;
-    /** The url of the preview */
-    previewUrl?: string;
-    /** Whether the track is a preview */
-    isPreview?: boolean;
-    /** The total number of tracks in the playlist */
-    totalTracks?: number;
-    /** The Identifier provided by a plugin */
-    identifier?: string;
-    /** The ArtworkUrl provided by a plugin */
-    artworkUrl?: string;
-    /** The Author Information provided by a plugin */
-    author?: string;
-    /** The Url provided by a Plugin */
-    url?: string;
-    /** The Url provided by a Plugin */
-    uri?: string;
-    /** You can put specific track information here, to transform the tracks... */
-    clientData?: {
-        previousTrack?: boolean;
-        [key: string]: any;
-    };
-}
-interface LavalinkTrack {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: LavalinkTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface Track {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: TrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The Track's Requester */
-    requester?: unknown;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface UnresolvedTrackInfo extends Partial<TrackInfo> {
-    /** Required */
-    title: string;
-}
-interface UnresolvedQuery extends UnresolvedTrackInfo {
-    /** The base64 of the unresolved track to "encode" */
-    encoded?: Base64;
-}
-interface UnresolvedTrack {
-    /** Required */
-    resolve: (player: Player) => Promise<void>;
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: UnresolvedTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-    /** The Track's Requester */
-    requester?: unknown;
-}
-
 interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -1011,7 +1011,7 @@ interface QueueStoreManager {
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
     parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
-interface ManagerQueueOptions {
+interface ManagerQueueOptions<CustomPlayerT extends Player = Player> {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */
     maxPreviousTracks?: number;
     /** Custom Queue Store option */
@@ -1044,7 +1044,7 @@ interface PlayerJson {
     /** Lavalink's position the player was at */
     lastPosition: number;
     /** Last time the position was sent from lavalink */
-    lastPositionChange: number;
+    lastPositionChange: number | null;
     /** Volume in % from the player (without volumeDecrementer) */
     volume: number;
     /** Real Volume used in lavalink (with the volumeDecrementer) */
@@ -2538,47 +2538,47 @@ declare class NodeManager extends EventEmitter {
 /**
  * The events from the lavalink Manager
  */
-interface LavalinkManagerEvents {
+interface LavalinkManagerEvents<CustomPlayerT extends Player = Player> {
     /**
      * Emitted when a Track started playing.
      * @event Manager#trackStart
      */
-    "trackStart": (player: Player, track: Track | null, payload: TrackStartEvent) => void;
+    "trackStart": (player: CustomPlayerT, track: Track | null, payload: TrackStartEvent) => void;
     /**
      * Emitted when a Track finished.
      * @event Manager#trackEnd
      */
-    "trackEnd": (player: Player, track: Track | null, payload: TrackEndEvent) => void;
+    "trackEnd": (player: CustomPlayerT, track: Track | null, payload: TrackEndEvent) => void;
     /**
      * Emitted when a Track got stuck while playing.
      * @event Manager#trackStuck
      */
-    "trackStuck": (player: Player, track: Track | null, payload: TrackStuckEvent) => void;
+    "trackStuck": (player: CustomPlayerT, track: Track | null, payload: TrackStuckEvent) => void;
     /**
      * Emitted when a Track errored.
      * @event Manager#trackError
      */
-    "trackError": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackExceptionEvent) => void;
+    "trackError": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: TrackExceptionEvent) => void;
     /**
      * Emitted when the Playing finished and no more tracks in the queue.
      * @event Manager#queueEnd
      */
-    "queueEnd": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
+    "queueEnd": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
     /**
      * Emitted when a Player is created.
      * @event Manager#playerCreate
      */
-    "playerCreate": (player: Player) => void;
+    "playerCreate": (player: CustomPlayerT) => void;
     /**
      * Emitted when a Player is moved within the channel.
      * @event Manager#playerMove
      */
-    "playerMove": (player: Player, oldVoiceChannelId: string, newVoiceChannelId: string) => void;
+    "playerMove": (player: CustomPlayerT, oldVoiceChannelId: string, newVoiceChannelId: string) => void;
     /**
      * Emitted when a Player is disconnected from a channel.
      * @event Manager#playerDisconnect
      */
-    "playerDisconnect": (player: Player, voiceChannelId: string) => void;
+    "playerDisconnect": (player: CustomPlayerT, voiceChannelId: string) => void;
     /**
      * Emitted when a Node-Socket got closed for a specific Player.
      * Usually emits when the audio websocket to discord is closed, This can happen for various reasons (normal and abnormal), e.g. when using an expired voice server update. 4xxx codes are usually bad.
@@ -2592,85 +2592,85 @@ interface LavalinkManagerEvents {
      * @link https://lavalink.dev/api/websocket.html#websocketclosedevent
      * @event Manager#playerSocketClosed
      */
-    "playerSocketClosed": (player: Player, payload: WebSocketClosedEvent) => void;
+    "playerSocketClosed": (player: CustomPlayerT, payload: WebSocketClosedEvent) => void;
     /**
      * Emitted when a Player get's destroyed
      * @event Manager#playerDestroy
      */
-    "playerDestroy": (player: Player, destroyReason?: DestroyReasonsType) => void;
+    "playerDestroy": (player: CustomPlayerT, destroyReason?: DestroyReasonsType) => void;
     /**
      * Always emits when the player (on lavalink side) got updated
      * @event Manager#playerUpdate
      */
-    "playerUpdate": (oldPlayerJson: PlayerJson, newPlayer: Player) => void;
+    "playerUpdate": (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
     /**
      * Emitted when the player's selfMuted or serverMuted state changed (true -> false | false -> true)
      * @event Manager#playerMuteChange
      */
-    "playerMuteChange": (player: Player, selfMuted: boolean, serverMuted: boolean) => void;
+    "playerMuteChange": (player: CustomPlayerT, selfMuted: boolean, serverMuted: boolean) => void;
     /**
      * Emitted when the player's selfDeafed or serverDeafed state changed (true -> false | false -> true)
      * @event Manager#playerDeafChange
      */
-    "playerDeafChange": (player: Player, selfDeafed: boolean, serverDeafed: boolean) => void;
+    "playerDeafChange": (player: CustomPlayerT, selfDeafed: boolean, serverDeafed: boolean) => void;
     /**
      * Emitted when the player's suppressed (true -> false | false -> true)
      * @event Manager#playerSuppressChange
      */
-    "playerSuppressChange": (player: Player, suppress: boolean) => void;
+    "playerSuppressChange": (player: CustomPlayerT, suppress: boolean) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout started
      * @event Manager#playerQueueEmptyStart
      */
-    "playerQueueEmptyStart": (player: Player, timeoutMs: number) => void;
+    "playerQueueEmptyStart": (player: CustomPlayerT, timeoutMs: number) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout finished leading to destroying the player
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerQueueEmptyEnd": (player: Player) => void;
+    "playerQueueEmptyEnd": (player: CustomPlayerT) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout got cancelled becuase a track got re-added to it.
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerQueueEmptyCancel": (player: Player) => void;
+    "playerQueueEmptyCancel": (player: CustomPlayerT) => void;
     /**
      * Emitted, when a user joins the voice channel, while there is a player existing
      * @event Manager#playerQueueEmptyStart
      */
-    "playerVoiceJoin": (player: Player, userId: string) => void;
+    "playerVoiceJoin": (player: CustomPlayerT, userId: string) => void;
     /**
      * Emitted, when a user leaves the voice channel, while there is a player existing
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerVoiceLeave": (player: Player, userId: string) => void;
+    "playerVoiceLeave": (player: CustomPlayerT, userId: string) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Segments are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentsloaded
      * @event Manager#trackError
      */
-    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
+    "SegmentsLoaded": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Segment was skipped
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentskipped
      * @event Manager#trackError
      */
-    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
+    "SegmentSkipped": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Chapter starts playing
      * @link https://github.com/topi314/Sponsorblock-Plugin#chapterstarted
      * @event Manager#trackError
      */
-    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
+    "ChapterStarted": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Chapters are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#chaptersloaded
      * @event Manager#trackError
      */
-    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
+    "ChaptersLoaded": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
     /**
      * Lavalink-Client Debug Event
      * Emitted for several erros, and logs within lavalink-client, if managerOptions.advancedOptions.enableDebugEvents is true
@@ -2689,21 +2689,21 @@ interface LavalinkManagerEvents {
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsLine
      */
-    "LyricsLine": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsLineEvent) => void;
+    "LyricsLine": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsLineEvent) => void;
     /**
      * Emitted when a Lyrics is found
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsFound
      */
-    "LyricsFound": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsFoundEvent) => void;
+    "LyricsFound": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsFoundEvent) => void;
     /**
      * Emitted when a Lyrics is not found
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsNotFound
      */
-    "LyricsNotFound": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsNotFoundEvent) => void;
-    "playerResumed": (player: Player, track: Track | UnresolvedTrack | null) => void;
-    "playerPaused": (player: Player, track: Track | UnresolvedTrack | null) => void;
+    "LyricsNotFound": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsNotFoundEvent) => void;
+    "playerResumed": (player: CustomPlayerT, track: Track | UnresolvedTrack | null) => void;
+    "playerPaused": (player: CustomPlayerT, track: Track | UnresolvedTrack | null) => void;
 }
 /**
  * The Bot client Options needed for the manager
@@ -2717,7 +2717,7 @@ interface BotClientOptions {
     [x: string | number | symbol]: unknown;
 }
 /** Sub Manager Options, for player specific things */
-interface ManagerPlayerOptions {
+interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
     /** If the Lavalink Volume should be decremented by x number */
     volumeDecrementer?: number;
     /** How often it should update the the player Position */
@@ -2748,7 +2748,7 @@ interface ManagerPlayerOptions {
     };
     onEmptyQueue?: {
         /** Get's executed onEmptyQueue -> You can do any track queue previous transformations, if you add a track to the queue -> it will play it, if not queueEnd will execute! */
-        autoPlayFunction?: (player: Player, lastPlayedTrack: Track) => Promise<void>;
+        autoPlayFunction?: (player: CustomPlayerT, lastPlayedTrack: Track) => Promise<void>;
         destroyAfterMs?: number;
     };
     useUnresolvedData?: boolean;
@@ -2756,9 +2756,10 @@ interface ManagerPlayerOptions {
 type DeepRequired<T> = {
     [K in keyof T]-?: NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
 };
-type RequiredManagerOptions = DeepRequired<ManagerOptions>;
+type RequiredManagerOptions<T extends Player> = DeepRequired<ManagerOptions<T>>;
+type PlayerConstructor<T extends Player = Player> = new (options: PlayerOptions, LavalinkManager: LavalinkManager, dontEmitPlayerCreateEvent?: boolean) => T;
 /** Manager Options used to create the manager */
-interface ManagerOptions {
+interface ManagerOptions<CustomPlayerT extends Player = Player> {
     /** The Node Options, for all Nodes! (on init) */
     nodes: LavalinkNodeOptions[];
     /** @async The Function to send the voice connection changes from Lavalink to Discord */
@@ -2766,9 +2767,11 @@ interface ManagerOptions {
     /** The Bot Client's Data for Authorization */
     client?: BotClientOptions;
     /** QueueOptions for all Queues */
-    queueOptions?: ManagerQueueOptions;
+    queueOptions?: ManagerQueueOptions<CustomPlayerT>;
     /** PlayerOptions for all Players */
-    playerOptions?: ManagerPlayerOptions;
+    playerOptions?: ManagerPlayerOptions<CustomPlayerT>;
+    /** The player class you want to use when creating a player. (can be extendable) */
+    playerClass?: PlayerConstructor<CustomPlayerT>;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
     /** If it should automatically move the player to the next node when node is down */
@@ -2806,44 +2809,44 @@ interface ManagerOptions {
     };
 }
 
-declare class LavalinkManager extends EventEmitter {
+declare class LavalinkManager<CustomPlayerT extends Player = Player> extends EventEmitter {
     /**
      * Emit an event
      * @param event The event to emit
      * @param args The arguments to pass to the event
      * @returns
      */
-    emit<Event extends keyof LavalinkManagerEvents>(event: Event, ...args: Parameters<LavalinkManagerEvents[Event]>): boolean;
+    emit<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, ...args: Parameters<LavalinkManagerEvents<CustomPlayerT>[Event]>): boolean;
     /**
      * Add an event listener
      * @param event The event to listen to
      * @param listener The listener to add
      * @returns
      */
-    on<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    on<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Add an event listener that only fires once
      * @param event The event to listen to
      * @param listener The listener to add
      * @returns
      */
-    once<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    once<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Remove an event listener
      * @param event The event to remove the listener from
      * @param listener The listener to remove
      * @returns
      */
-    off<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    off<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Remove an event listener
      * @param event The event to remove the listener from
      * @param listener The listener to remove
      * @returns
      */
-    removeListener<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    removeListener<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /** The Options of LavalinkManager (changeable) */
-    options: ManagerOptions;
+    options: ManagerOptions<CustomPlayerT>;
     /** LavalinkManager's NodeManager to manage all Nodes */
     nodeManager: NodeManager;
     /** LavalinkManager's Utils Class */
@@ -2851,7 +2854,7 @@ declare class LavalinkManager extends EventEmitter {
     /** Wether the manager was initiated or not */
     initiated: boolean;
     /** All Players stored in a MiniMap */
-    readonly players: MiniMap<string, Player>;
+    readonly players: MiniMap<string, CustomPlayerT>;
     /**
      * Applies the options provided by the User
      * @param options
@@ -2922,7 +2925,7 @@ declare class LavalinkManager extends EventEmitter {
      * })
      * ```
      */
-    constructor(options: ManagerOptions);
+    constructor(options: ManagerOptions<CustomPlayerT>);
     /**
      * Get a Player from Lava
      * @param guildId The guildId of the player
@@ -2937,7 +2940,7 @@ declare class LavalinkManager extends EventEmitter {
      * ```
      * @returns
      */
-    getPlayer(guildId: string): Player | undefined;
+    getPlayer(guildId: string): CustomPlayerT | undefined;
     /**
      * Create a Music-Player. If a player exists, then it returns it before creating a new one
      * @param options
@@ -2962,7 +2965,7 @@ declare class LavalinkManager extends EventEmitter {
      * });
      * ```
      */
-    createPlayer(options: PlayerOptions): Player;
+    createPlayer(options: PlayerOptions): CustomPlayerT;
     /**
      * Destroy a player with optional destroy reason and disconnect it from the voice channel
      * @param guildId
@@ -2975,7 +2978,7 @@ declare class LavalinkManager extends EventEmitter {
      * // recommend to do it on the player tho: player.destroy("forcefully destroyed the player");
      * ```
      */
-    destroyPlayer(guildId: string, destroyReason?: string): Promise<void | Player>;
+    destroyPlayer(guildId: string, destroyReason?: string): Promise<void | CustomPlayerT>;
     /**
      * Delete's a player from the cache without destroying it on lavalink (only works when it's disconnected)
      * @param guildId
@@ -3013,7 +3016,7 @@ declare class LavalinkManager extends EventEmitter {
      * });
      * ```
      */
-    init(clientData: BotClientOptions): Promise<LavalinkManager>;
+    init(clientData: BotClientOptions): Promise<this>;
     /**
      * Sends voice data to the Lavalink server.
      * ! Without this the library won't work

package/dist/index.d.ts

@@ -449,6 +449,138 @@ declare class FilterManager {
     clearEQ(): Promise<this>;
 }
 
+/** Sourcenames provided by lavalink server */
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+/** Source Names provided by lava src plugin */
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz";
+/** Source Names provided by jiosaavan plugin */
+type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
+/** The SourceNames provided by lavalink */
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
+interface LavalinkTrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    length: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface TrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    duration: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface PluginInfo {
+    /** The Type provided by a plugin */
+    type?: "album" | "playlist" | "artist" | "recommendations" | string;
+    /** The Identifier provided by a plugin */
+    albumName?: string;
+    /** The url of the album */
+    albumUrl?: string;
+    /** The url of the album art */
+    albumArtUrl?: string;
+    /** The url of the artist */
+    artistUrl?: string;
+    /** The url of the artist artwork */
+    artistArtworkUrl?: string;
+    /** The url of the preview */
+    previewUrl?: string;
+    /** Whether the track is a preview */
+    isPreview?: boolean;
+    /** The total number of tracks in the playlist */
+    totalTracks?: number;
+    /** The Identifier provided by a plugin */
+    identifier?: string;
+    /** The ArtworkUrl provided by a plugin */
+    artworkUrl?: string;
+    /** The Author Information provided by a plugin */
+    author?: string;
+    /** The Url provided by a Plugin */
+    url?: string;
+    /** The Url provided by a Plugin */
+    uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        previousTrack?: boolean;
+        [key: string]: any;
+    };
+}
+interface LavalinkTrack {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: LavalinkTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The Track's Requester */
+    requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface UnresolvedTrackInfo extends Partial<TrackInfo> {
+    /** Required */
+    title: string;
+}
+interface UnresolvedQuery extends UnresolvedTrackInfo {
+    /** The base64 of the unresolved track to "encode" */
+    encoded?: Base64;
+}
+interface UnresolvedTrack {
+    /** Required */
+    resolve: (player: Player) => Promise<void>;
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: UnresolvedTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+    /** The Track's Requester */
+    requester?: unknown;
+}
+
 declare class QueueSaver {
     /**
      * The queue store manager
@@ -669,7 +801,7 @@ declare class Player {
     /** The current Positin of the player (Calculated) */
     get position(): number;
     /** The timestamp when the last position change update happened */
-    lastPositionChange: number;
+    lastPositionChange: number | null;
     /** The current Positin of the player (from Lavalink) */
     lastPosition: number;
     lastSavedPosition: number;
@@ -862,138 +994,6 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
-/** Sourcenames provided by lavalink server */
-type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
-/** Source Names provided by lava src plugin */
-type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz";
-/** Source Names provided by jiosaavan plugin */
-type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
-/** The SourceNames provided by lavalink */
-type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
-interface LavalinkTrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    length: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface TrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    duration: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface PluginInfo {
-    /** The Type provided by a plugin */
-    type?: "album" | "playlist" | "artist" | "recommendations" | string;
-    /** The Identifier provided by a plugin */
-    albumName?: string;
-    /** The url of the album */
-    albumUrl?: string;
-    /** The url of the album art */
-    albumArtUrl?: string;
-    /** The url of the artist */
-    artistUrl?: string;
-    /** The url of the artist artwork */
-    artistArtworkUrl?: string;
-    /** The url of the preview */
-    previewUrl?: string;
-    /** Whether the track is a preview */
-    isPreview?: boolean;
-    /** The total number of tracks in the playlist */
-    totalTracks?: number;
-    /** The Identifier provided by a plugin */
-    identifier?: string;
-    /** The ArtworkUrl provided by a plugin */
-    artworkUrl?: string;
-    /** The Author Information provided by a plugin */
-    author?: string;
-    /** The Url provided by a Plugin */
-    url?: string;
-    /** The Url provided by a Plugin */
-    uri?: string;
-    /** You can put specific track information here, to transform the tracks... */
-    clientData?: {
-        previousTrack?: boolean;
-        [key: string]: any;
-    };
-}
-interface LavalinkTrack {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: LavalinkTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface Track {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: TrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The Track's Requester */
-    requester?: unknown;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface UnresolvedTrackInfo extends Partial<TrackInfo> {
-    /** Required */
-    title: string;
-}
-interface UnresolvedQuery extends UnresolvedTrackInfo {
-    /** The base64 of the unresolved track to "encode" */
-    encoded?: Base64;
-}
-interface UnresolvedTrack {
-    /** Required */
-    resolve: (player: Player) => Promise<void>;
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: UnresolvedTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-    /** The Track's Requester */
-    requester?: unknown;
-}
-
 interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -1011,7 +1011,7 @@ interface QueueStoreManager {
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
     parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
-interface ManagerQueueOptions {
+interface ManagerQueueOptions<CustomPlayerT extends Player = Player> {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */
     maxPreviousTracks?: number;
     /** Custom Queue Store option */
@@ -1044,7 +1044,7 @@ interface PlayerJson {
     /** Lavalink's position the player was at */
     lastPosition: number;
     /** Last time the position was sent from lavalink */
-    lastPositionChange: number;
+    lastPositionChange: number | null;
     /** Volume in % from the player (without volumeDecrementer) */
     volume: number;
     /** Real Volume used in lavalink (with the volumeDecrementer) */
@@ -2538,47 +2538,47 @@ declare class NodeManager extends EventEmitter {
 /**
  * The events from the lavalink Manager
  */
-interface LavalinkManagerEvents {
+interface LavalinkManagerEvents<CustomPlayerT extends Player = Player> {
     /**
      * Emitted when a Track started playing.
      * @event Manager#trackStart
      */
-    "trackStart": (player: Player, track: Track | null, payload: TrackStartEvent) => void;
+    "trackStart": (player: CustomPlayerT, track: Track | null, payload: TrackStartEvent) => void;
     /**
      * Emitted when a Track finished.
      * @event Manager#trackEnd
      */
-    "trackEnd": (player: Player, track: Track | null, payload: TrackEndEvent) => void;
+    "trackEnd": (player: CustomPlayerT, track: Track | null, payload: TrackEndEvent) => void;
     /**
      * Emitted when a Track got stuck while playing.
      * @event Manager#trackStuck
      */
-    "trackStuck": (player: Player, track: Track | null, payload: TrackStuckEvent) => void;
+    "trackStuck": (player: CustomPlayerT, track: Track | null, payload: TrackStuckEvent) => void;
     /**
      * Emitted when a Track errored.
      * @event Manager#trackError
      */
-    "trackError": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackExceptionEvent) => void;
+    "trackError": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: TrackExceptionEvent) => void;
     /**
      * Emitted when the Playing finished and no more tracks in the queue.
      * @event Manager#queueEnd
      */
-    "queueEnd": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
+    "queueEnd": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
     /**
      * Emitted when a Player is created.
      * @event Manager#playerCreate
      */
-    "playerCreate": (player: Player) => void;
+    "playerCreate": (player: CustomPlayerT) => void;
     /**
      * Emitted when a Player is moved within the channel.
      * @event Manager#playerMove
      */
-    "playerMove": (player: Player, oldVoiceChannelId: string, newVoiceChannelId: string) => void;
+    "playerMove": (player: CustomPlayerT, oldVoiceChannelId: string, newVoiceChannelId: string) => void;
     /**
      * Emitted when a Player is disconnected from a channel.
      * @event Manager#playerDisconnect
      */
-    "playerDisconnect": (player: Player, voiceChannelId: string) => void;
+    "playerDisconnect": (player: CustomPlayerT, voiceChannelId: string) => void;
     /**
      * Emitted when a Node-Socket got closed for a specific Player.
      * Usually emits when the audio websocket to discord is closed, This can happen for various reasons (normal and abnormal), e.g. when using an expired voice server update. 4xxx codes are usually bad.
@@ -2592,85 +2592,85 @@ interface LavalinkManagerEvents {
      * @link https://lavalink.dev/api/websocket.html#websocketclosedevent
      * @event Manager#playerSocketClosed
      */
-    "playerSocketClosed": (player: Player, payload: WebSocketClosedEvent) => void;
+    "playerSocketClosed": (player: CustomPlayerT, payload: WebSocketClosedEvent) => void;
     /**
      * Emitted when a Player get's destroyed
      * @event Manager#playerDestroy
      */
-    "playerDestroy": (player: Player, destroyReason?: DestroyReasonsType) => void;
+    "playerDestroy": (player: CustomPlayerT, destroyReason?: DestroyReasonsType) => void;
     /**
      * Always emits when the player (on lavalink side) got updated
      * @event Manager#playerUpdate
      */
-    "playerUpdate": (oldPlayerJson: PlayerJson, newPlayer: Player) => void;
+    "playerUpdate": (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
     /**
      * Emitted when the player's selfMuted or serverMuted state changed (true -> false | false -> true)
      * @event Manager#playerMuteChange
      */
-    "playerMuteChange": (player: Player, selfMuted: boolean, serverMuted: boolean) => void;
+    "playerMuteChange": (player: CustomPlayerT, selfMuted: boolean, serverMuted: boolean) => void;
     /**
      * Emitted when the player's selfDeafed or serverDeafed state changed (true -> false | false -> true)
      * @event Manager#playerDeafChange
      */
-    "playerDeafChange": (player: Player, selfDeafed: boolean, serverDeafed: boolean) => void;
+    "playerDeafChange": (player: CustomPlayerT, selfDeafed: boolean, serverDeafed: boolean) => void;
     /**
      * Emitted when the player's suppressed (true -> false | false -> true)
      * @event Manager#playerSuppressChange
      */
-    "playerSuppressChange": (player: Player, suppress: boolean) => void;
+    "playerSuppressChange": (player: CustomPlayerT, suppress: boolean) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout started
      * @event Manager#playerQueueEmptyStart
      */
-    "playerQueueEmptyStart": (player: Player, timeoutMs: number) => void;
+    "playerQueueEmptyStart": (player: CustomPlayerT, timeoutMs: number) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout finished leading to destroying the player
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerQueueEmptyEnd": (player: Player) => void;
+    "playerQueueEmptyEnd": (player: CustomPlayerT) => void;
     /**
      * Emitted when the player's queue got empty, and the timeout got cancelled becuase a track got re-added to it.
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerQueueEmptyCancel": (player: Player) => void;
+    "playerQueueEmptyCancel": (player: CustomPlayerT) => void;
     /**
      * Emitted, when a user joins the voice channel, while there is a player existing
      * @event Manager#playerQueueEmptyStart
      */
-    "playerVoiceJoin": (player: Player, userId: string) => void;
+    "playerVoiceJoin": (player: CustomPlayerT, userId: string) => void;
     /**
      * Emitted, when a user leaves the voice channel, while there is a player existing
      * @event Manager#playerQueueEmptyEnd
      */
-    "playerVoiceLeave": (player: Player, userId: string) => void;
+    "playerVoiceLeave": (player: CustomPlayerT, userId: string) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Segments are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentsloaded
      * @event Manager#trackError
      */
-    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
+    "SegmentsLoaded": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Segment was skipped
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentskipped
      * @event Manager#trackError
      */
-    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
+    "SegmentSkipped": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Chapter starts playing
      * @link https://github.com/topi314/Sponsorblock-Plugin#chapterstarted
      * @event Manager#trackError
      */
-    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
+    "ChapterStarted": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Chapters are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#chaptersloaded
      * @event Manager#trackError
      */
-    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
+    "ChaptersLoaded": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
     /**
      * Lavalink-Client Debug Event
      * Emitted for several erros, and logs within lavalink-client, if managerOptions.advancedOptions.enableDebugEvents is true
@@ -2689,21 +2689,21 @@ interface LavalinkManagerEvents {
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsLine
      */
-    "LyricsLine": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsLineEvent) => void;
+    "LyricsLine": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsLineEvent) => void;
     /**
      * Emitted when a Lyrics is found
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsFound
      */
-    "LyricsFound": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsFoundEvent) => void;
+    "LyricsFound": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsFoundEvent) => void;
     /**
      * Emitted when a Lyrics is not found
      * @link https://github.com/topi314/LavaLyrics
      * @event Manager#LyricsNotFound
      */
-    "LyricsNotFound": (player: Player, track: Track | UnresolvedTrack | null, payload: LyricsNotFoundEvent) => void;
-    "playerResumed": (player: Player, track: Track | UnresolvedTrack | null) => void;
-    "playerPaused": (player: Player, track: Track | UnresolvedTrack | null) => void;
+    "LyricsNotFound": (player: CustomPlayerT, track: Track | UnresolvedTrack | null, payload: LyricsNotFoundEvent) => void;
+    "playerResumed": (player: CustomPlayerT, track: Track | UnresolvedTrack | null) => void;
+    "playerPaused": (player: CustomPlayerT, track: Track | UnresolvedTrack | null) => void;
 }
 /**
  * The Bot client Options needed for the manager
@@ -2717,7 +2717,7 @@ interface BotClientOptions {
     [x: string | number | symbol]: unknown;
 }
 /** Sub Manager Options, for player specific things */
-interface ManagerPlayerOptions {
+interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
     /** If the Lavalink Volume should be decremented by x number */
     volumeDecrementer?: number;
     /** How often it should update the the player Position */
@@ -2748,7 +2748,7 @@ interface ManagerPlayerOptions {
     };
     onEmptyQueue?: {
         /** Get's executed onEmptyQueue -> You can do any track queue previous transformations, if you add a track to the queue -> it will play it, if not queueEnd will execute! */
-        autoPlayFunction?: (player: Player, lastPlayedTrack: Track) => Promise<void>;
+        autoPlayFunction?: (player: CustomPlayerT, lastPlayedTrack: Track) => Promise<void>;
         destroyAfterMs?: number;
     };
     useUnresolvedData?: boolean;
@@ -2756,9 +2756,10 @@ interface ManagerPlayerOptions {
 type DeepRequired<T> = {
     [K in keyof T]-?: NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
 };
-type RequiredManagerOptions = DeepRequired<ManagerOptions>;
+type RequiredManagerOptions<T extends Player> = DeepRequired<ManagerOptions<T>>;
+type PlayerConstructor<T extends Player = Player> = new (options: PlayerOptions, LavalinkManager: LavalinkManager, dontEmitPlayerCreateEvent?: boolean) => T;
 /** Manager Options used to create the manager */
-interface ManagerOptions {
+interface ManagerOptions<CustomPlayerT extends Player = Player> {
     /** The Node Options, for all Nodes! (on init) */
     nodes: LavalinkNodeOptions[];
     /** @async The Function to send the voice connection changes from Lavalink to Discord */
@@ -2766,9 +2767,11 @@ interface ManagerOptions {
     /** The Bot Client's Data for Authorization */
     client?: BotClientOptions;
     /** QueueOptions for all Queues */
-    queueOptions?: ManagerQueueOptions;
+    queueOptions?: ManagerQueueOptions<CustomPlayerT>;
     /** PlayerOptions for all Players */
-    playerOptions?: ManagerPlayerOptions;
+    playerOptions?: ManagerPlayerOptions<CustomPlayerT>;
+    /** The player class you want to use when creating a player. (can be extendable) */
+    playerClass?: PlayerConstructor<CustomPlayerT>;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
     /** If it should automatically move the player to the next node when node is down */
@@ -2806,44 +2809,44 @@ interface ManagerOptions {
     };
 }
 
-declare class LavalinkManager extends EventEmitter {
+declare class LavalinkManager<CustomPlayerT extends Player = Player> extends EventEmitter {
     /**
      * Emit an event
      * @param event The event to emit
      * @param args The arguments to pass to the event
      * @returns
      */
-    emit<Event extends keyof LavalinkManagerEvents>(event: Event, ...args: Parameters<LavalinkManagerEvents[Event]>): boolean;
+    emit<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, ...args: Parameters<LavalinkManagerEvents<CustomPlayerT>[Event]>): boolean;
     /**
      * Add an event listener
      * @param event The event to listen to
      * @param listener The listener to add
      * @returns
      */
-    on<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    on<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Add an event listener that only fires once
      * @param event The event to listen to
      * @param listener The listener to add
      * @returns
      */
-    once<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    once<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Remove an event listener
      * @param event The event to remove the listener from
      * @param listener The listener to remove
      * @returns
      */
-    off<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    off<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /**
      * Remove an event listener
      * @param event The event to remove the listener from
      * @param listener The listener to remove
      * @returns
      */
-    removeListener<Event extends keyof LavalinkManagerEvents>(event: Event, listener: LavalinkManagerEvents[Event]): this;
+    removeListener<Event extends keyof LavalinkManagerEvents<CustomPlayerT>>(event: Event, listener: LavalinkManagerEvents<CustomPlayerT>[Event]): this;
     /** The Options of LavalinkManager (changeable) */
-    options: ManagerOptions;
+    options: ManagerOptions<CustomPlayerT>;
     /** LavalinkManager's NodeManager to manage all Nodes */
     nodeManager: NodeManager;
     /** LavalinkManager's Utils Class */
@@ -2851,7 +2854,7 @@ declare class LavalinkManager extends EventEmitter {
     /** Wether the manager was initiated or not */
     initiated: boolean;
     /** All Players stored in a MiniMap */
-    readonly players: MiniMap<string, Player>;
+    readonly players: MiniMap<string, CustomPlayerT>;
     /**
      * Applies the options provided by the User
      * @param options
@@ -2922,7 +2925,7 @@ declare class LavalinkManager extends EventEmitter {
      * })
      * ```
      */
-    constructor(options: ManagerOptions);
+    constructor(options: ManagerOptions<CustomPlayerT>);
     /**
      * Get a Player from Lava
      * @param guildId The guildId of the player
@@ -2937,7 +2940,7 @@ declare class LavalinkManager extends EventEmitter {
      * ```
      * @returns
      */
-    getPlayer(guildId: string): Player | undefined;
+    getPlayer(guildId: string): CustomPlayerT | undefined;
     /**
      * Create a Music-Player. If a player exists, then it returns it before creating a new one
      * @param options
@@ -2962,7 +2965,7 @@ declare class LavalinkManager extends EventEmitter {
      * });
      * ```
      */
-    createPlayer(options: PlayerOptions): Player;
+    createPlayer(options: PlayerOptions): CustomPlayerT;
     /**
      * Destroy a player with optional destroy reason and disconnect it from the voice channel
      * @param guildId
@@ -2975,7 +2978,7 @@ declare class LavalinkManager extends EventEmitter {
      * // recommend to do it on the player tho: player.destroy("forcefully destroyed the player");
      * ```
      */
-    destroyPlayer(guildId: string, destroyReason?: string): Promise<void | Player>;
+    destroyPlayer(guildId: string, destroyReason?: string): Promise<void | CustomPlayerT>;
     /**
      * Delete's a player from the cache without destroying it on lavalink (only works when it's disconnected)
      * @param guildId
@@ -3013,7 +3016,7 @@ declare class LavalinkManager extends EventEmitter {
      * });
      * ```
      */
-    init(clientData: BotClientOptions): Promise<LavalinkManager>;
+    init(clientData: BotClientOptions): Promise<this>;
     /**
      * Sends voice data to the Lavalink server.
      * ! Without this the library won't work

package/dist/index.js

@@ -4463,7 +4463,6 @@ var LavalinkManager = class extends import_events2.EventEmitter {
   applyOptions(options) {
     const optionsToAssign = {
       ...options,
-      // allow users to apply other options if they need to.
       client: {
         ...options?.client,
         id: options?.client?.id,
@@ -4472,6 +4471,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
       sendToShard: options?.sendToShard,
       autoMove: options?.autoMove ?? false,
       nodes: options?.nodes,
+      playerClass: options?.playerClass ?? Player,
       playerOptions: {
         applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
         clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
@@ -4654,7 +4654,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
   createPlayer(options) {
     const oldPlayer = this.getPlayer(options?.guildId);
     if (oldPlayer) return oldPlayer;
-    const newPlayer = new Player(options, this, true);
+    const newPlayer = new this.options.playerClass(options, this, true);
     this.players.set(newPlayer.guildId, newPlayer);
     this.emit("playerCreate", newPlayer);
     return newPlayer;

package/dist/index.mjs

@@ -4403,7 +4403,6 @@ var LavalinkManager = class extends EventEmitter2 {
   applyOptions(options) {
     const optionsToAssign = {
       ...options,
-      // allow users to apply other options if they need to.
       client: {
         ...options?.client,
         id: options?.client?.id,
@@ -4412,6 +4411,7 @@ var LavalinkManager = class extends EventEmitter2 {
       sendToShard: options?.sendToShard,
       autoMove: options?.autoMove ?? false,
       nodes: options?.nodes,
+      playerClass: options?.playerClass ?? Player,
       playerOptions: {
         applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
         clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
@@ -4594,7 +4594,7 @@ var LavalinkManager = class extends EventEmitter2 {
   createPlayer(options) {
     const oldPlayer = this.getPlayer(options?.guildId);
     if (oldPlayer) return oldPlayer;
-    const newPlayer = new Player(options, this, true);
+    const newPlayer = new this.options.playerClass(options, this, true);
     this.players.set(newPlayer.guildId, newPlayer);
     this.emit("playerCreate", newPlayer);
     return newPlayer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "2.5.10",
+  "version": "2.6.1",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",