lavalink-client 2.0.1 → 2.1.1

package/README.md

@@ -180,4 +180,31 @@ Check out the [Documentation](https://lc4.gitbook.io/lavalink-client) for **Exam
 ```
 In one of the next updates, there will be more queueWatcher options and more custom nodeevents to trace 
 
-Most features of this update got tested, but if you encounter any bugs feel free to open an issue!
+Most features of this update got tested, but if you encounter any bugs feel free to open an issue!
+
+## **Version 2.1.0**
+- Fixed that, if you skip and have trackloop enabled, it doesn't skip the track
+  - I fixed that in the past, but for some reason i removed the fix on accident ig.
+- Reworked the Filter Manager for custom filters via [LavalinkFilterPlugin](https://github.com/rohank05/lavalink-filter-plugin) / [LavalinkLavaDSPX-Plugin](https://github.com/devoxin/LavaDSPX-Plugin/)
+- Note that the [LavalinkLavaDSPX-Plugin](https://github.com/devoxin/LavaDSPX-Plugin/) is by a Community Member of Lavalink and UNOFFICIAL
+  - They now have individual state-variabels (booleans): `player.filterManager.filters.lavalinkLavaDspxPlugin`
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.echo`
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.normalization`
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.highPass`
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.lowPass`
+  - and for: `player.filterManager.filters.lavalinkFilterPlugin` (this plugins seems to not work on v4 at the moment)
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.echo`
+    - `player.filterManager.filters.lavalinkLavaDspxPlugin.reverb`
+  - They also now have individual state-changing-methods: `player.filterManager.lavalinkLavaDspxPlugin`
+    - `player.filterManager.lavalinkLavaDspxPlugin.toggleEcho(decay:number, echoLength:number)`
+    - `player.filterManager.lavalinkLavaDspxPlugin.toggleNormalization(maxAmplitude:number, adaptive:boolean)`
+    - `player.filterManager.lavalinkLavaDspxPlugin.toggleHighPass(boostFactor:number, cutoffFrequency:number)`
+    - `player.filterManager.lavalinkLavaDspxPlugin.toggleLowPass(boostFactor:number, cutoffFrequency:number)`
+  - and for: `player.filterManager.lavalinkFilterPlugin`
+    - `player.filterManager.lavalinkFilterPlugin.toggleEcho(delay:number, decay:number)`
+    - `player.filterManager.lavalinkFilterPlugin.toggleReverb(delays:number[], gains:number[])`
+
+## **Version 2.1.1**
+- Enforce link searches for users with following searchPlatform Options: "http" | "https" | "link" | "uri"
+  - Additionally strongend the code behind that
+- Added searchPlatform for local tracks (aka files on the lavalink server...): "local"

package/dist/cjs/structures/Filters.d.ts

@@ -86,20 +86,28 @@ export declare class FilterManager {
      * @returns
      */
     toggleLowPass(smoothing?: number): Promise<boolean>;
-    /**
-     * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
-     * @returns
-     */
-    toggleEcho(delay?: number, decay?: number): Promise<boolean>;
-    /**
-     * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delays
-     * @param gains
-     * @returns
-     */
-    toggleReverb(delays?: number[], gains?: number[]): Promise<boolean>;
+    lavalinkLavaDspxPlugin: {
+        toggleLowPass: (boostFactor?: number, cutoffFrequency?: number) => Promise<boolean>;
+        toggleHighPass: (boostFactor?: number, cutoffFrequency?: number) => Promise<boolean>;
+        toggleNormalization: (maxAmplitude?: number, adaptive?: boolean) => Promise<boolean>;
+        toggleEcho: (decay?: number, echoLength?: number) => Promise<boolean>;
+    };
+    lavalinkFilterPlugin: {
+        /**
+         * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param delay
+         * @param decay
+         * @returns
+         */
+        toggleEcho: (delay?: number, decay?: number) => Promise<boolean>;
+        /**
+         * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param delays
+         * @param gains
+         * @returns
+         */
+        toggleReverb: (delays?: number[], gains?: number[]) => Promise<boolean>;
+    };
     /**
      * Enables / Disabels a Nightcore-like filter Effect. Disables/Overwrides both: custom and Vaporwave Filter
      * @param speed
@@ -160,10 +168,23 @@ export interface PlayerFilters {
     audioOutput: AudioOutputs;
     /** Lavalink Volume FILTER (not player Volume, think of it as a gain booster) */
     volume: boolean;
-    /** only with the custom lavalink filter plugin */
-    echo: boolean;
-    /** only with the custom lavalink filter plugin */
-    reverb: boolean;
+    /** Filters for the Lavalink Filter Plugin */
+    lavalinkFilterPlugin: {
+        /** if echo filter is enabled / not */
+        echo: boolean;
+        /** if reverb filter is enabled / not */
+        reverb: boolean;
+    };
+    lavalinkLavaDspxPlugin: {
+        /** if lowPass filter is enabled / not */
+        lowPass: boolean;
+        /** if highPass filter is enabled / not */
+        highPass: boolean;
+        /** if normalization filter is enabled / not */
+        normalization: boolean;
+        /** if echo filter is enabled / not */
+        echo: boolean;
+    };
 }
 /**
  * There are 15 bands (0-14) that can be changed.
@@ -174,9 +195,9 @@ export interface PlayerFilters {
  */
 export interface EQBand {
     /** On what band position (0-14) it should work */
-    band: IntegerNumber;
+    band: IntegerNumber | number;
     /** The gain (-0.25 to 1.0) */
-    gain: FloatNumber;
+    gain: FloatNumber | number;
 }
 /**
  * Uses equalization to eliminate part of a band, usually targeting vocals.
@@ -265,20 +286,6 @@ export interface LowPassFilter {
     /** The smoothing factor (1.0 < x) */
     smoothing?: number;
 }
-/**
- * A Plugin Filter
- */
-export interface EchoFilter {
-    delay: number;
-    decay: number;
-}
-/**
- * A Plugin Filter
- */
-export interface ReverbFilter {
-    delays: number[];
-    gains: number[];
-}
 /**
  * Filter Data stored in the Client and partially sent to Lavalink
  */
@@ -292,15 +299,34 @@ export interface FilterData {
     distortion?: DistortionFilter;
     channelMix?: ChannelMixFilter;
     lowPass?: LowPassFilter;
-    pluginFilters?: Record<PluginFiltersKey, PluginFiltersValues>;
-}
-export type PluginFiltersKey = "lavalink-filter-plugin" | string;
-export interface PluginFiltersValues extends LavalinkFiltersPlugin {
-    [key: string]: string | number | string[] | number[] | EchoFilter | ReverbFilter;
-}
-export interface LavalinkFiltersPlugin {
-    "echo": EchoFilter;
-    "reverb": ReverbFilter;
+    pluginFilters?: {
+        "lavalink-filter-plugin"?: {
+            "echo"?: {
+                delay?: number;
+                decay?: number;
+            };
+            "reverb"?: {
+                delays?: number[];
+                gains?: number[];
+            };
+        };
+        "high-pass"?: {
+            cutoffFrequency?: number;
+            boostFactor?: number;
+        };
+        "low-pass"?: {
+            cutoffFrequency?: number;
+            boostFactor?: number;
+        };
+        normalization?: {
+            maxAmplitude?: number;
+            adaptive?: boolean;
+        };
+        echo?: {
+            echoLength?: number;
+            decay?: number;
+        };
+    };
 }
 /**
  * Actual Filter Data sent to Lavalink

package/dist/cjs/structures/Filters.js

@@ -15,13 +15,21 @@ class FilterManager {
         vaporwave: false,
         custom: false,
         nightcore: false,
-        echo: false,
-        reverb: false,
         rotation: false,
         karaoke: false,
         tremolo: false,
         vibrato: false,
         lowPass: false,
+        lavalinkFilterPlugin: {
+            echo: false,
+            reverb: false,
+        },
+        lavalinkLavaDspxPlugin: {
+            lowPass: false,
+            highPass: false,
+            normalization: false,
+            echo: false,
+        },
         audioOutput: "stereo",
     };
     /** The Filter Data sent to Lavalink, only if the filter is enabled (ofc.) */
@@ -61,7 +69,23 @@ class FilterManager {
                     delays: [],
                     gains: [] // [0.84, 0.83, 0.82, 0.81]
                 }
-            }
+            },
+            "high-pass": { // Cuts off frequencies lower than the specified {cutoffFrequency}.
+            // "cutoffFrequency": 1475, // Integer, higher than zero, in Hz.
+            // "boostFactor": 1.0    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
+            },
+            "low-pass": { // Cuts off frequencies higher than the specified {cutoffFrequency}.
+            // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
+            // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
+            },
+            "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+            // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
+            // "adaptive": true    // false 
+            },
+            "echo": { // Self-explanatory; provides an echo effect.
+            // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).
+            // "decay": 0.4649       // Float, within the range of 0.0 - 1.0. A value of 1.0 means no decay, and a value of 0.0 means
+            },
         },
         channelMix: exports.audioOutputsData.stereo,
         /*distortion: {
@@ -94,10 +118,18 @@ class FilterManager {
             delete sendData.tremolo;
         if (!this.filters.vibrato)
             delete sendData.vibrato;
-        if (!this.filters.echo)
+        if (!this.filters.lavalinkFilterPlugin.echo)
             delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.echo;
-        if (!this.filters.reverb)
+        if (!this.filters.lavalinkFilterPlugin.reverb)
             delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.reverb;
+        if (!this.filters.lavalinkLavaDspxPlugin.echo)
+            delete sendData.pluginFilters?.echo;
+        if (!this.filters.lavalinkLavaDspxPlugin.normalization)
+            delete sendData.pluginFilters?.normalization;
+        if (!this.filters.lavalinkLavaDspxPlugin.highPass)
+            delete sendData.pluginFilters?.["high-pass"];
+        if (!this.filters.lavalinkLavaDspxPlugin.lowPass)
+            delete sendData.pluginFilters?.["low-pass"];
         if (sendData.pluginFilters?.["lavalink-filter-plugin"] && Object.values(sendData.pluginFilters?.["lavalink-filter-plugin"]).length === 0)
             delete sendData.pluginFilters["lavalink-filter-plugin"];
         if (sendData.pluginFilters && Object.values(sendData.pluginFilters).length === 0)
@@ -121,7 +153,7 @@ class FilterManager {
             // delete disabled filters
             if (key === "pluginFilters") {
                 // for(const key of [...Object.keys(sendData.pluginFilters)]) {
-                // if (this.player.node.info && !this.player.node.info?.plugins?.find?.(v => v.name === key)) delete sendData[key];
+                //     // if (this.player.node.info && !this.player.node.info?.plugins?.find?.(v => v.name === key)) delete sendData[key];
                 // }
             }
             else if (this.player.node.info && !this.player.node.info?.filters?.includes?.(key))
@@ -148,9 +180,13 @@ class FilterManager {
         this.filters.rotation = this.data.rotation.rotationHz !== 0;
         this.filters.vibrato = this.data.vibrato.frequency !== 0 || this.data.vibrato.depth !== 0;
         this.filters.tremolo = this.data.tremolo.frequency !== 0 || this.data.tremolo.depth !== 0;
-        const lavalinkFilterData = (this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: 0, delay: 0 }, reverb: { gains: [], delays: [] } });
-        this.filters.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
-        this.filters.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
+        const lavalinkFilterData = (this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters.echo.decay : 0, delay: this.data.pluginFilters?.echo?.delay || 0 }, reverb: { gains: [], delays: [], ...((this.data.pluginFilters.reverb) || {}) } });
+        this.filters.lavalinkFilterPlugin.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
+        this.filters.lavalinkFilterPlugin.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
+        this.filters.lavalinkLavaDspxPlugin.highPass = Object.values(this.data.pluginFilters["high-pass"] || {}).length > 0;
+        this.filters.lavalinkLavaDspxPlugin.lowPass = Object.values(this.data.pluginFilters["low-pass"] || {}).length > 0;
+        this.filters.lavalinkLavaDspxPlugin.normalization = Object.values(this.data.pluginFilters.normalization || {}).length > 0;
+        this.filters.lavalinkLavaDspxPlugin.echo = Object.values(this.data.pluginFilters.echo || {}).length > 0 && typeof this.data.pluginFilters?.echo?.delay === "undefined";
         this.filters.lowPass = this.data.lowPass.smoothing !== 0;
         this.filters.karaoke = Object.values(this.data.karaoke).some(v => v !== 0);
         if ((this.filters.nightcore || this.filters.vaporwave) && oldFilterTimescale) {
@@ -166,8 +202,12 @@ class FilterManager {
      * Reset all Filters
      */
     async resetFilters() {
-        this.filters.echo = false;
-        this.filters.reverb = false;
+        this.filters.lavalinkLavaDspxPlugin.echo = false;
+        this.filters.lavalinkLavaDspxPlugin.normalization = false;
+        this.filters.lavalinkLavaDspxPlugin.highPass = false;
+        this.filters.lavalinkLavaDspxPlugin.lowPass = false;
+        this.filters.lavalinkFilterPlugin.echo = false;
+        this.filters.lavalinkFilterPlugin.reverb = false;
         this.filters.nightcore = false;
         this.filters.lowPass = false;
         this.filters.rotation = false;
@@ -197,14 +237,30 @@ class FilterManager {
             pluginFilters: {
                 "lavalink-filter-plugin": {
                     echo: {
-                        delay: 0,
-                        decay: 0
+                    // delay: 0, // in seconds
+                    // decay: 0 // 0 < 1
                     },
                     reverb: {
-                        delays: [],
-                        gains: []
-                    },
-                }
+                    // delays: [], // [0.037, 0.042, 0.048, 0.053]
+                    // gains: [] // [0.84, 0.83, 0.82, 0.81]
+                    }
+                },
+                "high-pass": { // Cuts off frequencies lower than the specified {cutoffFrequency}.
+                // "cutoffFrequency": 1475, // Integer, higher than zero, in Hz.
+                // "boostFactor": 1.0    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
+                },
+                "low-pass": { // Cuts off frequencies higher than the specified {cutoffFrequency}.
+                // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
+                // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
+                },
+                "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+                // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
+                // "adaptive": true    // false 
+                },
+                "echo": { // Self-explanatory; provides an echo effect.
+                // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).
+                // "decay": 0.4649       // Float, within the range of 0.0 - 1.0. A value of 1.0 means no decay, and a value of 0.0 means
+                },
             },
             rotation: {
                 rotationHz: 0
@@ -372,52 +428,156 @@ class FilterManager {
         await this.applyPlayerFilters();
         return this.filters.lowPass;
     }
-    /**
-     * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
-     * @returns
-     */
-    async toggleEcho(delay = 4, decay = 0.8) {
-        if (this.player.node.info && !this.player.node.info?.filters?.includes("echo"))
-            throw new Error("Node#Info#filters does not include the 'echo' Filter (Node has it not enable aka not installed!)");
-        if (!this.data)
-            this.data = {};
-        if (!this.data.pluginFilters)
-            this.data.pluginFilters = {};
-        if (!this.data.pluginFilters["lavalink-filter-plugin"])
-            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
-        if (!this.data.pluginFilters["lavalink-filter-plugin"].echo)
-            this.data.pluginFilters["lavalink-filter-plugin"].echo = { decay: 0, delay: 0 };
-        this.data.pluginFilters["lavalink-filter-plugin"].echo.delay = this.filters.echo ? 0 : delay;
-        this.data.pluginFilters["lavalink-filter-plugin"].echo.decay = this.filters.echo ? 0 : decay;
-        this.filters.echo = !this.filters.echo;
-        await this.applyPlayerFilters();
-        return this.filters.echo;
-    }
-    /**
-     * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delays
-     * @param gains
-     * @returns
-     */
-    async toggleReverb(delays = [0.037, 0.042, 0.048, 0.053], gains = [0.84, 0.83, 0.82, 0.81]) {
-        if (this.player.node.info && !this.player.node.info?.filters?.includes("reverb"))
-            throw new Error("Node#Info#filters does not include the 'reverb' Filter (Node has it not enable aka not installed!)");
-        if (!this.data)
-            this.data = {};
-        if (!this.data.pluginFilters)
-            this.data.pluginFilters = {};
-        if (!this.data.pluginFilters["lavalink-filter-plugin"])
-            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
-        if (!this.data.pluginFilters["lavalink-filter-plugin"].reverb)
-            this.data.pluginFilters["lavalink-filter-plugin"].reverb = { delays: [], gains: [] };
-        this.data.pluginFilters["lavalink-filter-plugin"].reverb.delays = this.filters.reverb ? [] : delays;
-        this.data.pluginFilters["lavalink-filter-plugin"].reverb.gains = this.filters.reverb ? [] : gains;
-        this.filters.reverb = !this.filters.reverb;
-        await this.applyPlayerFilters();
-        return this.filters.reverb;
-    }
+    lavalinkLavaDspxPlugin = {
+        toggleLowPass: async (boostFactor = 1.0, cutoffFrequency = 80) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavadspx plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("low-pass"))
+                throw new Error("Node#Info#filters does not include the 'low-pass' Filter (Node has it not enable)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters["low-pass"])
+                this.data.pluginFilters["low-pass"] = {};
+            if (this.filters.lavalinkLavaDspxPlugin.lowPass) {
+                delete this.data.pluginFilters["low-pass"];
+            }
+            else {
+                this.data.pluginFilters["low-pass"] = {
+                    boostFactor: boostFactor,
+                    cutoffFrequency: cutoffFrequency
+                };
+            }
+            this.filters.lavalinkLavaDspxPlugin.lowPass = !this.filters.lavalinkLavaDspxPlugin.lowPass;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkLavaDspxPlugin.lowPass;
+        },
+        toggleHighPass: async (boostFactor = 1.0, cutoffFrequency = 80) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavadspx plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("high-pass"))
+                throw new Error("Node#Info#filters does not include the 'high-pass' Filter (Node has it not enable)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters["high-pass"])
+                this.data.pluginFilters["high-pass"] = {};
+            if (this.filters.lavalinkLavaDspxPlugin.highPass) {
+                delete this.data.pluginFilters["high-pass"];
+            }
+            else {
+                this.data.pluginFilters["high-pass"] = {
+                    boostFactor: boostFactor,
+                    cutoffFrequency: cutoffFrequency
+                };
+            }
+            this.filters.lavalinkLavaDspxPlugin.highPass = !this.filters.lavalinkLavaDspxPlugin.highPass;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkLavaDspxPlugin.highPass;
+        },
+        toggleNormalization: async (maxAmplitude = 0.75, adaptive = true) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavadspx plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("normalization"))
+                throw new Error("Node#Info#filters does not include the 'normalization' Filter (Node has it not enable)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters.normalization)
+                this.data.pluginFilters.normalization = {};
+            if (this.filters.lavalinkLavaDspxPlugin.normalization) {
+                delete this.data.pluginFilters.normalization;
+            }
+            else {
+                this.data.pluginFilters.normalization = {
+                    adaptive: adaptive,
+                    maxAmplitude: maxAmplitude
+                };
+            }
+            this.filters.lavalinkLavaDspxPlugin.normalization = !this.filters.lavalinkLavaDspxPlugin.normalization;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkLavaDspxPlugin.normalization;
+        },
+        toggleEcho: async (decay = 0.5, echoLength = 0.5) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavadspx plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("echo"))
+                throw new Error("Node#Info#filters does not include the 'echo' Filter (Node has it not enable)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters.echo)
+                this.data.pluginFilters.echo = {};
+            if (this.filters.lavalinkLavaDspxPlugin.echo) {
+                delete this.data.pluginFilters.echo;
+            }
+            else {
+                this.data.pluginFilters.echo = {
+                    decay: decay,
+                    echoLength: echoLength
+                };
+            }
+            this.filters.lavalinkLavaDspxPlugin.echo = !this.filters.lavalinkLavaDspxPlugin.echo;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkLavaDspxPlugin.echo;
+        }
+    };
+    lavalinkFilterPlugin = {
+        /**
+         * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param delay
+         * @param decay
+         * @returns
+         */
+        toggleEcho: async (delay = 4, decay = 0.8) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavalink-filter-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavalink-filter-plugin plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("echo"))
+                throw new Error("Node#Info#filters does not include the 'echo' Filter (Node has it not enable aka not installed!)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters["lavalink-filter-plugin"])
+                this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+            if (!this.data.pluginFilters["lavalink-filter-plugin"].echo)
+                this.data.pluginFilters["lavalink-filter-plugin"].echo = { decay: 0, delay: 0 };
+            this.data.pluginFilters["lavalink-filter-plugin"].echo.delay = this.filters.lavalinkFilterPlugin.echo ? 0 : delay;
+            this.data.pluginFilters["lavalink-filter-plugin"].echo.decay = this.filters.lavalinkFilterPlugin.echo ? 0 : decay;
+            this.filters.lavalinkFilterPlugin.echo = !this.filters.lavalinkFilterPlugin.echo;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkFilterPlugin.echo;
+        },
+        /**
+         * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param delays
+         * @param gains
+         * @returns
+         */
+        toggleReverb: async (delays = [0.037, 0.042, 0.048, 0.053], gains = [0.84, 0.83, 0.82, 0.81]) => {
+            if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavalink-filter-plugin"))
+                throw new Error("Node#Info#plugins does not include the lavalink-filter-plugin plugin");
+            if (this.player.node.info && !this.player.node.info?.filters?.includes("reverb"))
+                throw new Error("Node#Info#filters does not include the 'reverb' Filter (Node has it not enable aka not installed!)");
+            if (!this.data)
+                this.data = {};
+            if (!this.data.pluginFilters)
+                this.data.pluginFilters = {};
+            if (!this.data.pluginFilters["lavalink-filter-plugin"])
+                this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+            if (!this.data.pluginFilters["lavalink-filter-plugin"].reverb)
+                this.data.pluginFilters["lavalink-filter-plugin"].reverb = { delays: [], gains: [] };
+            this.data.pluginFilters["lavalink-filter-plugin"].reverb.delays = this.filters.lavalinkFilterPlugin.reverb ? [] : delays;
+            this.data.pluginFilters["lavalink-filter-plugin"].reverb.gains = this.filters.lavalinkFilterPlugin.reverb ? [] : gains;
+            this.filters.lavalinkFilterPlugin.reverb = !this.filters.lavalinkFilterPlugin.reverb;
+            await this.applyPlayerFilters();
+            return this.filters.lavalinkFilterPlugin.reverb;
+        }
+    };
     /**
      * Enables / Disabels a Nightcore-like filter Effect. Disables/Overwrides both: custom and Vaporwave Filter
      * @param speed

package/dist/cjs/structures/LavalinkManager.d.ts

@@ -173,7 +173,7 @@ export interface LavalinkManager {
     emit<U extends keyof LavalinkManagerEvents>(event: U, ...args: Parameters<LavalinkManagerEvents[U]>): boolean;
 }
 export declare class LavalinkManager extends EventEmitter {
-    static DefaultSources: Record<SearchPlatform, import("./Utils").LavalinkSearchPlatform>;
+    static DefaultSources: Record<SearchPlatform, import("./Utils").LavalinkSearchPlatform | import("./Utils").ClientCustomSearchPlatformUtils>;
     static SourceLinksRegexes: Record<import("./Utils").SourcesRegex, RegExp>;
     initiated: boolean;
     readonly players: MiniMap<string, Player>;

package/dist/cjs/structures/LavalinkManagerStatics.d.ts

@@ -1,5 +1,5 @@
-import { LavalinkSearchPlatform, SearchPlatform, SourcesRegex } from "./Utils";
-export declare const DefaultSources: Record<SearchPlatform, LavalinkSearchPlatform>;
+import { ClientCustomSearchPlatformUtils, LavalinkSearchPlatform, SearchPlatform, SourcesRegex } from "./Utils";
+export declare const DefaultSources: Record<SearchPlatform, LavalinkSearchPlatform | ClientCustomSearchPlatformUtils>;
 export declare const LavalinkPlugins: {
     DuncteBot_Plugin: string;
     LavaSrc: string;

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -47,10 +47,20 @@ exports.DefaultSources = {
     "speak": "speak",
     "tts": "tts",
     "ftts": "ftts",
+    "flowery": "ftts",
+    "flowery.tts": "ftts",
+    "flowerytts": "ftts",
     // Client sided search platforms
     "bandcamp": "bcsearch",
     "bc": "bcsearch",
     "bcsearch": "bcsearch",
+    // local files
+    "local": "local",
+    // http requests
+    "http": "http",
+    "https": "https",
+    "link": "link",
+    "uri": "uri"
 };
 exports.LavalinkPlugins = {
     DuncteBot_Plugin: "DuncteBot-plugin",

package/dist/cjs/structures/Node.js

@@ -124,12 +124,17 @@ class LavalinkNode {
             throw new Error("Bandcamp Search only works on the player!");
         }
         let uri = `/loadtracks?identifier=`;
-        if (!/^https?:\/\//.test(Query.query))
-            uri += `${Query.source}:`;
-        if (Query.source === "ftts")
-            uri += `//${encodeURIComponent(encodeURI(decodeURIComponent(Query.query)))}`;
-        else
+        if (/^https?:\/\//.test(Query.query) || ["http", "https", "link", "uri"].includes(Query.source)) { // if it's a link simply encode it
             uri += encodeURIComponent(decodeURIComponent(Query.query));
+        }
+        else { // if not make a query out of it
+            if (Query.source !== "local")
+                uri += `${Query.source}:`; // only add the query source string if it's not a local track
+            if (Query.source === "ftts")
+                uri += `//${encodeURIComponent(encodeURI(decodeURIComponent(Query.query)))}`;
+            else
+                uri += encodeURIComponent(decodeURIComponent(Query.query));
+        }
         const res = await this.request(uri);
         // transform the data which can be Error, Track or Track[] to enfore [Track]
         const resTracks = res.loadType === "playlist" ? res.data?.tracks : res.loadType === "track" ? [res.data] : res.loadType === "search" ? Array.isArray(res.data) ? res.data : [res.data] : [];
@@ -663,7 +668,7 @@ class LavalinkNode {
             return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
         }
         // remove tracks from the queue
-        if (player.repeatMode !== "track")
+        if (player.repeatMode !== "track" || player.get("internal_skipped"))
             await (0, Utils_1.queueTrackEnd)(player);
         else if (player.queue.current) { // If there was a current Track already and repeatmode === true, add it to the queue.
             player.queue.previous.unshift(player.queue.current);
@@ -671,6 +676,7 @@ class LavalinkNode {
                 player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
             await player.queue.utils.save();
         }
+        player.set("internal_skipped", false);
         // if no track available, end queue
         if (!player.queue.current)
             return this.queueEnd(player, track, payload);

package/dist/cjs/structures/Player.js

@@ -333,6 +333,7 @@ class Player {
         if (!this.playing)
             return await this.play();
         const now = performance.now();
+        this.set("internal_skipped", true);
         await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { track: { encoded: null } } });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
         return this;

package/dist/cjs/structures/Utils.d.ts

@@ -18,7 +18,9 @@ export type DuncteSearchPlatform = "speak" | "tts";
 export type LavalinkClientSearchPlatform = "bcsearch";
 export type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
 export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | LavalinkClientSearchPlatform;
-export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform;
+export type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
+export type ClientSearchPlatform = ClientCustomSearchPlatformUtils | // for file/link requests
+"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform;
 export type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
 export type SourcesRegex = "YoutubeRegex" | "YoutubeMusicRegex" | "SoundCloudRegex" | "SoundCloudMobileRegex" | "DeezerTrackRegex" | "DeezerArtistRegex" | "DeezerEpisodeRegex" | "DeezerMixesRegex" | "DeezerPageLinkRegex" | "DeezerPlaylistRegex" | "DeezerAlbumRegex" | "AllDeezerRegex" | "AllDeezerRegexWithoutPageLink" | "SpotifySongRegex" | "SpotifyPlaylistRegex" | "SpotifyArtistRegex" | "SpotifyEpisodeRegex" | "SpotifyShowRegex" | "SpotifyAlbumRegex" | "AllSpotifyRegex" | "mp3Url" | "m3uUrl" | "m3u8Url" | "mp4Url" | "m4aUrl" | "wavUrl" | "aacpUrl" | "tiktok" | "mixcloud" | "musicYandex" | "radiohost" | "bandcamp" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {