Adds a plugin update checker

LavalinkServer/build.gradle.kts

@@ -65,11 +65,12 @@ dependencies {
     implementation(libs.kotlin.reflect)
     implementation(libs.logback)
     implementation(libs.sentry.logback)
+    implementation(libs.semver)
     implementation(libs.oshi) {
         // This version of SLF4J does not recognise Logback 1.2.3
         exclude(group = "org.slf4j", module = "slf4j-api")
     }
-
+    
     testImplementation(libs.spring.boot.test)
 }
 

LavalinkServer/src/main/java/lavalink/server/bootstrap/PluginManager.kt

@@ -9,9 +9,11 @@ import java.io.FileOutputStream
 import java.io.InputStream
 import java.net.URL
 import java.net.URLClassLoader
+import java.net.HttpURLConnection
 import java.nio.channels.Channels
 import java.util.*
 import java.util.jar.JarFile
+import io.github.z4kn4fein.semver.toVersion
 
 @SpringBootApplication
 class PluginManager(val config: PluginsConfig) {
@@ -83,6 +85,37 @@ class PluginManager(val config: PluginsConfig) {
                 val file = File(directory, declaration.canonicalJarName)
                 downloadJar(file, url)
             }
+
+            checkPluginForUpdates(declaration)
+        }
+    }
+
+    private fun checkPluginForUpdates(declaration: Declaration) {
+        val splitPath = declaration.url.split('/')
+
+        val baseSplitPath = splitPath.dropLast(2)
+        val basePath = baseSplitPath.joinToString("/") + "/maven-metadata.xml"
+
+        val connection = URL(basePath).openConnection() as HttpURLConnection
+        connection.inputStream.bufferedReader().use {
+            val lines = it.readLines()
+            for (line in lines) {
+                val regex = "<latest>(.*?)</latest>".toRegex()
+                val match = regex.find(line)
+                val latest = match?.groups?.get(1)?.value
+                if (latest != null) {
+                    val latestVersion = latest.toVersion()
+                    val currentVersion = declaration.version.toVersion()
+
+                    if(latestVersion > currentVersion) {
+                        log.warn("A newer version of ${declaration.name} was found: $latestVersion. " +
+                                "The current version is $currentVersion.")
+                    } else {
+                        log.info("Plugin ${declaration.name} is up to date")
+                    }
+                    break
+                }
+            }
         }
     }
 

docs/api/rest.md

@@ -751,7 +751,7 @@ When `identifier` is used, Lavalink will try to resolve the identifier as a sing
 
 Response:
 
-[Player](#Player) object
+[Player](#player) object
 
 <details markdown="1">
 <summary>Example Payload</summary>

docs/changelog/v3.md

@@ -1,10 +1,17 @@
+## v3.7.13
+!!! danger
+    This is the last Lavalink `v3` release, see [here](https://github.com/lavalink-devs/Lavalink/discussions/1100) for more info.
+
+* Updated Lavaplayer to [`1.5.6`](https://github.com/lavalink-devs/lavaplayer/releases/tag/1.5.6)
+* Updated koe to [`2.0.3-rc2`](https://github.com/KyokoBot/koe/releases/tag/2.0.3-rc2) & use voice gateway v8 in [#1098](https://github.com/lavalink-devs/Lavalink/pull/1098)
+
 ## v3.7.12
 * Updated Lavaplayer to [`1.5.4`](https://github.com/lavalink-devs/lavaplayer/releases/tag/1.5.4)
 * Updated Koe to [`2.0.1`](https://github.com/KyokoBot/koe/releases/tag/2.0.1) (fixes the `IndexOutOfBoundsException` when playing a YouTube track)
 
 !!! warning
 
-  The default Youtube source is now deprecated and won't receive further updates. Please use https://github.com/lavalink-devs/youtube-source#plugin instead.
+    The default Youtube source is now deprecated and won't receive further updates. Please use https://github.com/lavalink-devs/youtube-source#plugin instead.
 
 ## v3.7.11
 * Fixed not being able to seek when player is paused 
@@ -42,7 +49,7 @@
 
 !!! info
 
-  Lavalink Docker images are now found in the GitHub Container Registry instead of DockerHub
+    Lavalink Docker images are now found in the GitHub Container Registry instead of DockerHub
 
 ## v3.7.4
 

docs/changelog/v4.md

@@ -1,3 +1,9 @@
+## v4.0.8
+* Updated koe to [`2.0.3-rc2`](https://github.com/KyokoBot/koe/releases/tag/2.0.3-rc2) & use voice gateway `v8` in [#1097](https://github.com/lavalink-devs/Lavalink/pull/1097)
+* Updated Lavaplayer to [`2.2.2`](https://github.com/lavalink-devs/lavaplayer/releases/tag/2.2.2) in [#1105](https://github.com/lavalink-devs/Lavalink/pull/1105)
+* Allow usage of non-allocating frame buffers in [#1095](https://github.com/lavalink-devs/Lavalink/pull/1095)
+* Added shutdown handling to close sessions cleanly in [#1102](https://github.com/lavalink-devs/Lavalink/pull/1102)
+
 ## v4.0.7
 * Updated Lavaplayer to [`2.2.1`](https://github.com/lavalink-devs/lavaplayer/releases/tag/2.2.1)
 * Updated spring-boot to `3.3.0` & spring-websocket to `6.1.9`

docs/getting-started/troubleshooting.md

@@ -34,14 +34,15 @@ In general there are 6 log levels: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR` and
 ```yaml title="application.yml"
 logging:
   level:
-    # Set this to DEBUG to enable more detailed logging. Please note that this will log probably spam your console.
     root: INFO
     # Set this to DEBUG to enable more detailed logging from Lavalink
     lavalink: DEBUG
-    # Set this to TRACE to see all WebSocket messages
+    # Set this to TRACE to see all WebSocket messages sent
     lavalink.server.io.SocketContext: TRACE
     # Log all track exceptions (COMMON, SUSPICIOUS & FAULT)
     com.sedmelluq.discord.lavaplayer.tools.ExceptionTools: DEBUG
+    # Log YouTube Plugin stuff (only needed if you have issues with YouTube)
+    dev.lavalink.youtube: DEBUG
 
   # This will log all requests to the REST API
   request:

docs/overrides/main.html

@@ -1,3 +1,7 @@
+{%- block extrahead -%}
+    <meta name="darkreader" content="">
+{%- endblock -%}
+
 {% extends "base.html" %}
 
 {% block announce %}

settings.gradle.kts

@@ -76,6 +76,7 @@ fun VersionCatalogBuilder.common() {
     library("logback",        "ch.qos.logback",       "logback-classic").version("1.5.6")
     library("sentry-logback", "io.sentry",            "sentry-logback").version("7.10.0")
     library("oshi",           "com.github.oshi",      "oshi-core").version("6.4.11")
+    library("semver",         "io.github.z4kn4fein",  "semver").version("2.0.0")
 }
 
 fun VersionCatalogBuilder.other() {