Update to the latest Minecraft version with Velocity migration

.editorconfig

@@ -2,12 +2,14 @@ root = true
 
 [*]
 charset = utf-8
+end_of_line = lf
+tab_width = 4
 indent_size = 4
 indent_style = space
-tab_width = 4
 insert_final_newline = true
+trim_trailing_whitespace = true
 max_line_length = 120
-ij_visual_guides = 80
+ij_visual_guides = 80, 120
 ij_continuation_indent_size = 8
 
 [*.java]
@@ -264,5 +266,5 @@ ij_json_space_before_colon = false
 ij_json_space_before_comma = false
 ij_json_wrap_long_lines = false
 
-[{*.yml,*.md}]
+[*.{yml,md}]
 indent_size = 2

.github/ISSUE_TEMPLATE/config.yml

@@ -1,3 +1,5 @@
+#file: noinspection YAMLSchemaValidation
+
 blank_issues_enabled: false
 contact_links:
   - name: Issue with site (whomine.net)

.github/workflows/build.yml

@@ -1,3 +1,5 @@
+#file: noinspection Annotator
+
 name: Java CI with Gradle
 
 on:
@@ -13,7 +15,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        java: [ '17' ]
+        java: [ '21' ]
     steps:
       - if: ${{ github.event_name == 'push' }}
         uses: actions/checkout@v4

.github/workflows/codeql.yml

@@ -1,3 +1,5 @@
+#file: noinspection Annotator
+
 name: "CodeQL"
 
 on:
@@ -27,7 +29,7 @@ jobs:
       uses: actions/checkout@v4
       with:
         ref: ${{ github.event.pull_request.head.sha }}
-      
+
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v3
       with:

build-logic/build.gradle.kts

@@ -0,0 +1,17 @@
+plugins {
+    `kotlin-dsl`
+}
+
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
+
+    maven("https://repo.papermc.io/repository/maven-public/")
+}
+
+dependencies {
+    compileOnly(gradleApi())
+    implementation(files(libs.javaClass.superclass.protectionDomain.codeSource.location))
+    implementation(libs.shadow)
+    implementation(libs.paper.userdev)
+}

build-logic/settings.gradle.kts

@@ -0,0 +1,11 @@
+@file:Suppress("UnstableApiUsage")
+
+dependencyResolutionManagement {
+    versionCatalogs {
+        register("libs") {
+            from(files("../gradle/libs.versions.toml"))
+        }
+    }
+}
+
+rootProject.name = "build-logic"

build-logic/src/main/kotlin/Dependencies.kt

@@ -0,0 +1,18 @@
+@file:Suppress("unused")
+
+import com.github.jengelman.gradle.plugins.shadow.internal.DependencyFilter
+import org.gradle.api.artifacts.ExternalModuleDependency
+import org.gradle.api.provider.Provider
+
+fun DependencyFilter.exclude(provider: Provider<ExternalModuleDependency>): DependencyFilter? =
+    exclude(provider.get())
+
+fun DependencyFilter.exclude(dependency: ExternalModuleDependency): DependencyFilter? =
+    exclude(dependency("${dependency.group}:${dependency.name}:.*"))
+
+fun DependencyFilter.include(provider: Provider<ExternalModuleDependency>): DependencyFilter? =
+    include(provider.get())
+
+fun DependencyFilter.include(dependency: ExternalModuleDependency): DependencyFilter? =
+    include(dependency("${dependency.group}:${dependency.name}:.*"))
+

build-logic/src/main/kotlin/LibsAccessor.kt

@@ -0,0 +1,6 @@
+import org.gradle.accessors.dm.LibrariesForLibs
+import org.gradle.api.Project
+import org.gradle.kotlin.dsl.getByType
+
+val Project.libs: LibrariesForLibs
+    get() = rootProject.extensions.getByType()

build-logic/src/main/kotlin/Projects.kt

@@ -0,0 +1,52 @@
+@file:Suppress("MemberVisibilityCanBePrivate", "unused")
+
+import org.gradle.api.Project
+
+const val WHOMINE_PREFIX = "WhoMine"
+const val WHOLIB_PREFIX = "WhoLib"
+
+interface Projects {
+    val projectName: String
+    val projectPath: String
+    val projectDir: String
+        get() = projectName
+    val buildDir: String
+        get() = "build/$projectDir"
+
+    fun asProject(root: Project): Project =
+        root.project(projectPath)
+
+    fun exists(root: Project): Boolean =
+        root.findProject(projectPath) != null
+
+    companion object {
+        fun fromName(name: String): Projects? =
+            Libs.fromName(name) ?: Platforms.fromName(name)
+    }
+}
+
+enum class Libs(prefix: String = WHOLIB_PREFIX) : Projects {
+    Common, Paper, Velocity;
+
+    override val projectName: String = "$prefix-${name.lowercase()}"
+    override val projectPath: String = ":$projectName"
+    override val projectDir:  String = "lib/$projectName"
+
+    companion object {
+        fun fromName(name: String): Projects? =
+            values().find { it.projectName == name }
+    }
+}
+
+enum class Platforms(prefix: String = WHOMINE_PREFIX) : Projects {
+    Paper, Velocity;
+
+    override val projectName: String = "$prefix-${name.lowercase()}"
+    override val projectPath: String = ":$projectName"
+    override val projectDir:  String = "platform/$projectName"
+
+    companion object {
+        fun fromName(name: String): Projects? =
+            values().find { it.projectName == name }
+    }
+}

build-logic/src/main/kotlin/Properties.kt

@@ -0,0 +1,86 @@
+import org.gradle.api.JavaVersion
+import org.gradle.api.Project
+import org.gradle.jvm.toolchain.JavaLanguageVersion
+
+val utf8: String = Charsets.UTF_8.name()
+
+val Project.javaVersionInt: Int
+    get() = (
+                getProperty("java.version")
+                ?: throw IllegalStateException("Java version not set")
+            ).toString().toInt()
+
+val Project.javaVersion: JavaVersion
+    get() = JavaVersion.toVersion(javaVersionInt)
+
+val Project.javaLanguageVersion: JavaLanguageVersion
+    get() = JavaLanguageVersion.of(javaVersionInt)
+
+val Project.javaCompilerArgs: String
+    get() = (
+                getProperty("java.compilerArgs")
+                ?: throw IllegalStateException("Java compiler args not set")
+            ).toString()
+
+val Project.projectGroup: String
+    get() = (
+                getProperty("project.group")
+                ?: throw IllegalStateException("Project group not set")
+            ).toString()
+
+val Project.projectVersion: Any
+    get() = (
+                getProperty("project.version")
+                ?: throw IllegalStateException("Project version not set")
+            )
+
+val Project.projectDescription: String
+    get() = (
+                getProperty("project.description")
+                ?: throw IllegalStateException("Project description not set")
+            ).toString()
+
+val Project.paperVersion: String
+    get() = (
+                getProperty("paper.version")
+                ?: throw IllegalStateException("Paper version not set")
+            ).toString()
+
+val Project.projectAuthor: String
+    get() = (
+                getProperty("project.author")
+                ?: throw IllegalStateException("Author not set")
+            ).toString()
+
+val Project.projectContributors: String
+    get() = (
+                getProperty("project.contributors")
+                ?: throw IllegalStateException("Contributors not set")
+            ).toString()
+
+val Project.projectWebsite: String
+    get() = (
+                getProperty("project.website")
+                ?: throw IllegalStateException("Website not set")
+            ).toString()
+
+fun apiVersion(minecraftVersion: String): String {
+    val parts = minecraftVersion.split('.')
+
+    return if (parts.size < 2) {
+        throw IllegalStateException("Invalid Minecraft version: '$minecraftVersion'")
+    } else {
+        "'${parts[0]}.${parts[1]}'"
+    }
+}
+
+fun Project.getProperty(name: String): Any? {
+    return rootProject.property(name)
+}
+
+fun Project.getProperty(
+    name: String,
+    default: Any
+): Any {
+    return rootProject.property(name) ?: default
+}

build-logic/src/main/kotlin/whomine.base.gradle.kts

@@ -0,0 +1,71 @@
+plugins {
+    `java-library`
+}
+
+group       = projectGroup
+version     = projectVersion
+description = projectDescription
+
+java {
+    toolchain {
+        languageVersion.set(javaLanguageVersion)
+    }
+
+    sourceCompatibility = javaVersion
+    targetCompatibility = javaVersion
+}
+
+repositories {
+    mavenCentral()
+
+    maven("https://repo.papermc.io/repository/maven-public/")
+    maven("https://repo.codemc.org/repository/maven-public/")
+    maven("https://maven.playpro.com")
+}
+
+dependencies {
+    if (project.name != Libs.Common.projectName) {
+        compileOnlyApi(Libs.Common.asProject(rootProject))
+    }
+
+    compileOnlyApi(libs.adventure.api)
+    compileOnlyApi(libs.adventure.ansi)
+    compileOnlyApi(libs.adventure.gson)
+    compileOnlyApi(libs.adventure.legacy)
+    compileOnlyApi(libs.adventure.plain)
+    compileOnlyApi(libs.adventure.minimessage)
+    compileOnlyApi(libs.asm.api)
+    compileOnlyApi(libs.asm.commons)
+    compileOnlyApi(libs.fastutil)
+    compileOnlyApi(libs.google.guava)
+    compileOnlyApi(libs.google.gson)
+    compileOnlyApi(libs.google.jsr305)
+    compileOnlyApi(libs.jackson.annotations)
+    compileOnlyApi(libs.jda)
+    compileOnlyApi(libs.jetbrains.annotations)
+    compileOnlyApi(libs.netty.buffer)
+}
+
+sourceSets {
+    main {
+        java.srcDir(Libs.Common.asProject(rootProject).sourceSets.main.get().java.srcDirs)
+    }
+}
+
+tasks {
+    compileJava {
+        options.encoding = utf8
+
+        options.release.set(javaVersionInt)
+        options.compilerArgs.add(javaCompilerArgs)
+    }
+
+    javadoc {
+        options.encoding = utf8
+        setDestinationDir(file("$rootDir/build/javadoc"))
+    }
+
+    processResources {
+        filteringCharset = utf8
+    }
+}

build-logic/src/main/kotlin/whomine.library.gradle.kts

@@ -0,0 +1,34 @@
+import org.gradle.kotlin.dsl.invoke
+
+plugins {
+    id("whomine.shadow")
+}
+
+dependencies {
+    runtimeClasspath(libs.adventure.api)
+    runtimeClasspath(libs.adventure.ansi)
+    runtimeClasspath(libs.adventure.gson)
+    runtimeClasspath(libs.adventure.legacy)
+    runtimeClasspath(libs.adventure.plain)
+    runtimeClasspath(libs.adventure.minimessage)
+    runtimeClasspath(libs.asm.api)
+    runtimeClasspath(libs.asm.commons)
+    runtimeClasspath(libs.fastutil)
+    runtimeClasspath(libs.google.guava)
+    runtimeClasspath(libs.google.gson)
+    runtimeClasspath(libs.google.jsr305)
+    runtimeClasspath(libs.jackson.annotations)
+    runtimeClasspath(libs.jda)
+    runtimeClasspath(libs.jetbrains.annotations)
+    runtimeClasspath(libs.netty.buffer)
+}
+
+tasks {
+    jar {
+        destinationDirectory.set(file("$rootDir/build/lib"))
+    }
+
+    shadowJar {
+        destinationDirectory.set(file("$rootDir/build/lib"))
+    }
+}

build-logic/src/main/kotlin/whomine.paperweight.gradle.kts

@@ -0,0 +1,8 @@
+plugins {
+    id("whomine.base")
+    id("io.papermc.paperweight.userdev")
+}
+
+dependencies {
+    paperweight.paperDevBundle(paperVersion)
+}

build-logic/src/main/kotlin/whomine.platform.gradle.kts

@@ -0,0 +1,17 @@
+import org.gradle.kotlin.dsl.invoke
+
+plugins {
+    id("whomine.shadow")
+}
+
+tasks {
+    jar {
+        enabled = false
+    }
+
+    shadowJar {
+        destinationDirectory.set(file("$rootDir/build/platform"))
+
+        archiveClassifier.set("")
+    }
+}