Merge pull request #412 from MiniPlaceholders/renovate/org.spongepowered.gradle.plugin-2.x

chore(deps): update plugin spongegradle to v2.5.1

.github/workflows/build.yml

@@ -8,24 +8,24 @@ jobs:
 
     steps:
     - name: Checkout Repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v7
 
-    - name: Set up JDK 21
-      uses: actions/setup-java@v5
+    - name: Set up JDK 25
+      uses: actions/setup-java@v6
       with:
-        java-version: 21
-        distribution: 'temurin'
+        java-version: 25
+        distribution: 'zulu'
         cache: 'gradle'
 
     - name: Build with Gradle
-      uses: nick-invision/retry@v3
+      uses: nick-invision/retry@v4
       with:
         timeout_minutes: 10
         max_attempts: 2
         command: gradle build
 
     - name: Upload Artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: MiniPlaceholders
         path: jar/MiniPlaceholders-*.jar

CHANGELOG.md

@@ -2,19 +2,34 @@
 MiniPlaceholders Changelog
 -->
 
-## 3.1.1 (unreleased)
+# 3.2.2 (unreleased)
 
 ### Features
 
 
-
 ### Fixes
 
 
-
 ### API Additions
 
 
+<!--                                 -->
+
+# 3.2.1 (07/09/2026)
+
+### Fixes
+
+- Fixed Fabric 26.2 support
+
+
+## 3.2.0 (27/03/2026)
+
+### Features
+
+- Added support to Fabric 26.1+
+- Added Minestom support
+- Updated to Java 25
+
 
 ## 3.1.0 (10/10/2025)
 

README.md

@@ -12,9 +12,10 @@ MiniMessage Component-based Placeholders API for Minecraft Platforms.
 
 ## Compatibility
 - Paper 1.21+
-- Velocity 3.4+
-- Fabric 1.21.6+
+- Velocity 3.5+
+- Fabric 26.1+
 - Sponge API 12+
+- Minestom 1.21.11+
 
 ## User Usage
 

api/build.gradle.kts

@@ -39,9 +39,7 @@ tasks {
         val o = options as StandardJavadocDocletOptions
         o.encoding = Charsets.UTF_8.name()
         o.links(
-            "https://jd.advntr.dev/api/${libs.versions.adventure.get()}/",
-            "https://jd.advntr.dev/text-minimessage/${libs.versions.adventure.get()}/",
-            "https://javadoc.io/doc/org.jspecify/jspecify/latest/index.html"
+            "https://jd.papermc.io/adventure/${libs.versions.adventure.get()}/",
         )
         o.tags(
             "apiNote:a:API Note:",

api/src/main/java/io/github/miniplaceholders/api/MiniPlaceholders.java

@@ -45,6 +45,7 @@ public final class MiniPlaceholders {
             case VELOCITY -> Platform.VELOCITY;
             case FABRIC -> Platform.FABRIC;
             case SPONGE -> Platform.SPONGE;
+            case MINESTOM -> Platform.MINESTOM;
         };
     }
 

api/src/main/java/io/github/miniplaceholders/api/placeholder/AudiencePlaceholder.java

@@ -72,7 +72,6 @@ public record AudiencePlaceholder<A extends Audience>(
             : null;
   }
 
-  @SuppressWarnings("OverrideOnly")
   private @Nullable A forwardingFilter(final Pointered source) {
     //noinspection DataFlowIssue
     if (targetClass.isInstance(source)) {

api/src/main/java/io/github/miniplaceholders/api/placeholder/GlobalPlaceholder.java

@@ -33,7 +33,7 @@ public record GlobalPlaceholder(@TagPattern String key, String name, GlobalTagRe
     if (this == obj) {
       return true;
     }
-    if (obj instanceof GlobalPlaceholder(var oKey, var __, var ___)) {
+    if (obj instanceof GlobalPlaceholder(var oKey, var _, var _)) {
       return Objects.equals(oKey, this.key);
     }
     return false;

api/src/main/java/io/github/miniplaceholders/api/placeholder/RelationalPlaceholder.java

@@ -96,7 +96,6 @@ public record RelationalPlaceholder<A extends Audience>(
         : null;
   }
 
-  @SuppressWarnings("OverrideOnly")
   private @Nullable A forwardingFilter(final Pointered source) {
     //noinspection DataFlowIssue
     if (targetClass.isInstance(source)) {

api/src/main/java/io/github/miniplaceholders/api/types/Platform.java

@@ -29,5 +29,11 @@ public enum Platform {
    *
    * @since 2.2.0
    */
-  SPONGE
+  SPONGE,
+  /**
+   * Minestom Platform
+   *
+   * @since 3.2.0
+   */
+  MINESTOM,
 }

api/src/main/java/module-info.java

@@ -7,13 +7,13 @@ import org.jspecify.annotations.NullMarked;
 open module io.github.miniplaceholders.api {
   requires io.github.miniplaceholders.connect;
 
-  requires net.kyori.adventure;
+  requires net.kyori.adventure.api;
   requires net.kyori.adventure.text.minimessage;
   requires net.kyori.adventure.text.serializer.legacy;
-  requires net.kyori.examination.api;
 
   requires static org.jetbrains.annotations;
   requires static org.jspecify;
+  requires static team.unnamed.inject;
 
   exports io.github.miniplaceholders.api;
   exports io.github.miniplaceholders.api.types;

api/src/test/java/io/github/miniplaceholders/test/MiniPlaceholdersTest.java

@@ -13,7 +13,7 @@ class MiniPlaceholdersTest implements MiniTest {
     void methodEquality(){
         Expansion.builder("equality")
             .audiencePlaceholder("audience", Tags.emptyAudienceResolver())
-            .globalPlaceholder("global", (queue, ctx) -> Tags.EMPTY_TAG)
+            .globalPlaceholder("global", (_, _) -> Tags.EMPTY_TAG)
             .build()
         .register();
 

build-logic/build.gradle.kts

@@ -14,6 +14,6 @@ repositories {
 
 kotlin {
     jvmToolchain {
-        languageVersion = JavaLanguageVersion.of(21)
+        languageVersion = JavaLanguageVersion.of(25)
     }
 }

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

@@ -1,4 +1,4 @@
-import java.util.Date
+import java.util.*
 
 plugins {
     java
@@ -7,7 +7,7 @@ plugins {
 tasks {
     compileJava {
         options.encoding = Charsets.UTF_8.name()
-        options.release.set(21)
+        options.release.set(25)
     }
     jar {
         manifest {
@@ -22,7 +22,7 @@ tasks {
 
 java{
     toolchain{
-        languageVersion.set(JavaLanguageVersion.of(21))
+        languageVersion.set(JavaLanguageVersion.of(25))
         vendor.set(JvmVendorSpec.AZUL)
     }
 }

build.gradle.kts

@@ -1,5 +1,5 @@
 plugins {
-    kotlin("jvm") version "2.2.20" apply false
+    kotlin("jvm") version "2.4.21" apply false
 }
 
 tasks {

common/src/main/java/io/github/miniplaceholders/common/PlaceholdersPlugin.java

@@ -10,6 +10,7 @@ import io.github.miniplaceholders.common.loader.ExpansionProviderLoader;
 import io.github.miniplaceholders.common.loader.FailedToLoadExpansion;
 import io.github.miniplaceholders.common.loader.ProviderLoadResult;
 import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.ComponentLike;
 import net.kyori.adventure.text.TextComponent;
 import net.kyori.adventure.text.format.NamedTextColor;
 import net.kyori.adventure.text.format.TextColor;
@@ -51,11 +52,13 @@ public interface PlaceholdersPlugin {
 
     final Component expansionsInfo = loadedExpansions.stream()
         .map(this::expansionInfo)
+        // Adventure 5.x/4.x support
+        .map(ComponentLike::asComponent)
         .collect(Component.toComponent(Component.text(", ", NamedTextColor.WHITE)));
     logInfo(Component.text("Loaded expansions: ", NamedTextColor.GREEN).append(expansionsInfo));
   }
 
-  private Component expansionInfo(Expansion expansion) {
+  private ComponentLike expansionInfo(Expansion expansion) {
     final TextComponent.Builder builder = Component.text();
     builder.append(Component.text(expansion.name(), NamedTextColor.AQUA));
     final String author = expansion.author();
@@ -84,7 +87,7 @@ public interface PlaceholdersPlugin {
       );
     }
     builder.append(Component.text(']', NamedTextColor.DARK_GRAY));
-    return builder.build();
+    return builder;
   }
 
   default ProviderLoadResult tryLoad(final ExpansionProvider provider, final LoadRequirement loadRequirement) {

common/src/main/java/io/github/miniplaceholders/common/command/CommandConstants.java

@@ -80,7 +80,7 @@ public final class CommandConstants {
         )
         .append(newline(), miniMessage().deserialize(
             "<gradient:aqua:#94d1ff>" + command + "</gradient> <aqua>expansions</aqua>")
-            .clickEvent(ClickEvent.runCommand(command + " help"))
+            .clickEvent(ClickEvent.runCommand(command + " expansions"))
         )
         .append(newline(), FOOTER)
         .build();

connect/src/main/java/io/github/miniplaceholders/connect/InternalPlatform.java

@@ -3,7 +3,7 @@ package io.github.miniplaceholders.connect;
 public enum InternalPlatform {
 
     PAPER, VELOCITY,
-    FABRIC, SPONGE;
+    FABRIC, SPONGE, MINESTOM;
 
     private static InternalPlatform actualPlatform;
 

example-expansion-provider/build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
     alias(libs.plugins.blossom)
 }
 
-version = "1.3.5"
+version = "1.4.0"
 
 dependencies {
     compileOnly(projects.miniplaceholdersApi)

example-expansion-provider/src/main/java/io/miniplaceholders/provider/example/ExampleProvider.java

@@ -25,6 +25,24 @@ public record ExampleProvider(PlatformData platformData) implements ExpansionPro
                 platformData.serverInstance(),
                 platformData.complementInstance()
             )))
+            .audiencePlaceholder("audience", (audience, queue, ctx) -> Tag.preProcessParsed("""
+                    Audience Instance Class: %s
+                    MiniPlaceholders Instance Class: %s
+                    """.formatted(
+                    audience,
+                    platformData.complementInstance()
+            )))
+            .relationalPlaceholder("test", (audience, relational, queue, ctx) -> Tag.preProcessParsed("""
+                    Audience Instance Class: %s
+                    Relational Instance Class: %s
+                    Is Audience equals Relational? %s
+                    MiniPlaceholders Instance Class: %s
+                    """.formatted(
+                    audience,
+                    relational,
+                    audience.equals(relational),
+                    platformData.complementInstance()
+            )))
         .version(ExpansionConstants.VERSION)
         .build();
   }

fabric/build.gradle.kts

@@ -3,25 +3,33 @@ import java.nio.file.StandardCopyOption
 import kotlin.io.path.deleteIfExists
 
 plugins {
+    alias(libs.plugins.fabric.loom)
     id("miniplaceholders.auto.module")
-    id("quiet-fabric-loom")
-    alias(libs.plugins.shadow)
+}
+
+repositories {
+    maven("https://central.sonatype.com/repository/maven-snapshots/") {
+        name = "sonatype-snapshots"
+            mavenContent {
+                snapshotsOnly()
+            }
+    }
+    maven("https://jitpack.io")
 }
 
 val shade: Configuration by configurations.creating
 
 dependencies {
     minecraft(libs.minecraft)
-    mappings(loom.officialMojangMappings())
-    modImplementation(libs.fabric.loader)
-    modImplementation(libs.fabric.api)
+    compileOnly(libs.fabric.loader)
+    compileOnly(libs.fabric.api)
 
     includeDependency(libs.adventure.platform.fabric)
     includeDependency(libs.adventure.serializer.legacy)
     includeDependency(libs.adventure.minimessage)
     includeDependency(libs.luckopermissionsapi)
-    includeDependency(libs.desertwell)
     includeDependency(libs.unnamedinject)
+    includeDependency(libs.desertwell)
 
     shadeModule(projects.miniplaceholdersApi)
     shadeModule(projects.miniplaceholdersCommon)
@@ -29,16 +37,16 @@ dependencies {
 }
 
 fun DependencyHandlerScope.shadeModule(module: ProjectDependency) {
-    shade(module) {
+    implementation(module) {
         isTransitive = false
     }
-    implementation(module) {
+    include(module) {
         isTransitive = false
     }
 }
 
 fun DependencyHandlerScope.includeDependency(dependency: Any) {
-    modImplementation(dependency)
+    implementation(dependency)
     include(dependency)
 }
 
@@ -51,14 +59,10 @@ tasks {
             expand("version" to projectVersion)
         }
     }
-    remapJar {
-        inputFile.set(shadowJar.get().archiveFile)
+    jar {
         archiveFileName.set("MiniPlaceholders-Fabric-${projectVersion}.jar")
         destinationDirectory.set(file("${rootDir}/jar"))
     }
-    shadowJar {
-        configurations = listOf(shade)
-    }
     // I know it's exactly the same logic for all modules,
     // but for some reason in this module it only works
     // if it's declared in the same project configuration

fabric/src/main/java/io/github/miniplaceholders/fabric/FabricMod.java

@@ -54,7 +54,9 @@ public final class FabricMod implements DedicatedServerModInitializer, Placehold
           return switch (Permissions.getPermissionValue(commandSourceStack, permission)) {
             case TRUE -> TriState.TRUE;
             case FALSE -> TriState.FALSE;
-            case DEFAULT -> commandSourceStack.hasPermission(3) ? TriState.TRUE : TriState.NOT_SET;
+            case DEFAULT -> commandSourceStack.permissions()
+                .hasPermission(net.minecraft.server.permissions.Permissions.COMMANDS_GAMEMASTER)
+                ? TriState.TRUE : TriState.NOT_SET;
           };
         }
     );

fabric/src/main/resources/fabric.mod.json

@@ -20,11 +20,11 @@
     ]
   },
   "depends": {
-    "fabricloader": ">=0.14.19",
-    "fabric": "*",
-    "java": ">=21",
-    "adventure-platform-fabric": "~6.6.0",
-    "minecraft": ">=1.21.6 <=1.21.8",
-    "fabric-permissions-api-v0": "~0.4.1"
+    "fabricloader": ">=0.18.0",
+    "fabric-api": "*",
+    "java": ">=25",
+    "adventure-platform-fabric": ">6.8.0",
+    "minecraft": ">=26.2",
+    "fabric-permissions-api-v0": ">=0.7.0"
   }
 }

gradle.properties

@@ -1,5 +1,5 @@
 group = io.github.miniplaceholders
-version = 3.1.1-SNAPSHOT
+version = 3.2.2-SNAPSHOT
 description = MiniMessage Component-based Placeholders API
 
 org.gradle.jvmargs=-Xmx2G

gradle/libs.versions.toml

@@ -2,55 +2,61 @@ metadata.format.version = "1.1"
 
 [versions]
 
-velocity = "3.4.0-SNAPSHOT"
-paper = "1.21.8-R0.1-SNAPSHOT"
-minecraft = "1.21.8"
-
-runtask = "3.0.1"
-blossom = "2.1.0"
-shadow = "9.2.2"
-jmh = "0.7.3"
-dokka = "2.0.0"
-
-adventure = "4.24.0"
-adventureModded = "6.6.0"
-kotlin = "2.2.20"
-
-fabric-api = "0.134.0+1.21.8"
-fabric-loader = "0.17.3"
+# Platform
+minecraft = "26.1"
+paper = "1.21.11-R0.1-SNAPSHOT"
+velocity = "4.3.0"
+minestom = "2026.10.07-26.2"
+fabric-loader = "0.20.1"
+fabric-api = "0.145.0+26.1"
 
+# Libraries
+kotlin = "2.4.21"
+adventure = "5.2.0"
+adventureModded = "7.2.0"
 desertwell = "2.0.4"
-bstats = "3.1.0"
+bstats = "3.2.1"
+jspecify = "1.0.1"
+
+# Gradle Plugins
+runtask = "3.1.0"
+blossom = "2.2.0"
+shadow = "9.6.1"
+jmh = "0.7.3"
+dokka = "2.2.0"
 
 [libraries]
 
-velocity = { group = "com.velocitypowered", name = "velocity-api", version.ref = "velocity" }
-paper = { group = "io.papermc.paper", name = "paper-api", version.ref = "paper" }
+# Platforms
 minecraft = { group = "com.mojang", name = "minecraft", version.ref = "minecraft" }
-
-fabric-api = { group = "net.fabricmc.fabric-api", name = "fabric-api", version.ref = "fabric-api" }
+paper = { group = "io.papermc.paper", name = "paper-api", version.ref = "paper" }
+velocity = { group = "com.velocitypowered", name = "velocity-api", version.ref = "velocity" }
+minestom = { group = "net.minestom", name = "minestom", version.ref = "minestom" }
 fabric-loader = { group = "net.fabricmc", name = "fabric-loader", version.ref = "fabric-loader" }
-luckopermissionsapi = { group = "me.lucko", name = "fabric-permissions-api", version = "0.4.1" }
+fabric-api = { group = "net.fabricmc.fabric-api", name = "fabric-api", version.ref = "fabric-api" }
 
+# Adventure
 adventure-api = { group = "net.kyori", name = "adventure-api", version.ref = "adventure" }
 adventure-minimessage = { group = "net.kyori", name = "adventure-text-minimessage", version.ref = "adventure" }
 adventure-platform-fabric = { group = "net.kyori", name = "adventure-platform-fabric", version.ref = "adventureModded" }
 adventure-serializer-legacy = { group = "net.kyori", name = "adventure-text-serializer-legacy", version.ref = "adventure" }
 adventure-serializer-plain = { group = "net.kyori", name = "adventure-text-serializer-plain", version.ref = "adventure" }
 
+# Build-Logic Gradle Plugins
 plugin-shadow = { module = "com.gradleup.shadow:shadow-gradle-plugin", version.ref = "shadow" }
 plugin-kotlin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" }
-plugin-dokka = { module = "org.jetbrains.dokka:dokka-gradle-plugin", version.ref = "dokka" }
 plugin-runtask = { module = "xyz.jpenilla.run-velocity:xyz.jpenilla.run-velocity.gradle.plugin", version.ref = "runtask" }
 
+# Libraries
 desertwell = { group = "net.william278", name = "DesertWell", version.ref = "desertwell" }
-
-junit-bom = "org.junit:junit-bom:6.0.0"
-jspecify = "org.jspecify:jspecify:1.0.0"
-
+junit-bom = "org.junit:junit-bom:6.1.3"
+jspecify = { module = "org.jspecify:jspecify", version.ref = "jspecify" }
+luckopermissionsapi = { group = "me.lucko", name = "fabric-permissions-api", version = "0.7.0" }
 unnamedinject = "team.unnamed:inject:2.0.1"
 brigadier = "com.mojang:brigadier:1.0.500"
+slf4j = "org.slf4j:slf4j-api:2.0.20"
 
+# Bstats
 bstats-core = { group = "org.bstats", name = "bstats-base", version.ref = "bstats" }
 bstats-velocity = { group = "org.bstats", name = "bstats-velocity", version.ref = "bstats" }
 bstats-sponge = { group = "org.bstats", name = "bstats-sponge", version.ref = "bstats" }
@@ -58,10 +64,14 @@ bstats-bukkit = { group = "org.bstats", name = "bstats-bukkit", version.ref = "b
 
 [plugins]
 
+# Platform Plugins
 runpaper = { id = "xyz.jpenilla.run-paper", version.ref = "runtask" }
 runvelocity = { id = "xyz.jpenilla.run-velocity", version.ref = "runtask" }
+fabric-loom = { id = "net.fabricmc.fabric-loom", version = "1.18.4"}
+spongegradle = { id = "org.spongepowered.gradle.plugin", version = "2.5.1" }
+
+# General Plugins
 blossom = { id = "net.kyori.blossom", version.ref = "blossom" }
-shadow = { id = "com.gradleup.shadow", version.ref = "shadow" }
 jmh = { id = "me.champeau.jmh", version.ref = "jmh" }
-idea-ext = { id = "org.jetbrains.gradle.plugin.idea-ext", version = "1.3" }
 dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }
+idea-ext = { id = "org.jetbrains.gradle.plugin.idea-ext", version = "1.4.1" }

gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,9 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.8.2-bin.zip
 networkTimeout=10000
+retries=0
+retryBackOffMs=500
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

gradlew

@@ -20,7 +20,7 @@
 
 ##############################################################################
 #
-#   Gradle start up script for POSIX generated by Gradle.
+#   gradlew start up script for POSIX generated by Gradle.
 #
 #   Important for running:
 #
@@ -29,7 +29,7 @@
 #       bash, then to run this script, type that shell name before the whole
 #       command line, like:
 #
-#           ksh Gradle
+#           ksh gradlew
 #
 #       Busybox and similar reduced shells will NOT work, because this script
 #       requires all of these POSIX shell features:
@@ -57,7 +57,7 @@
 #       Darwin, MinGW, and NonStop.
 #
 #   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       https://github.com/gradle/gradle/blob/3d91ce3b8caaf77ad09f381f43615b715b53f72c/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
 #       within the Gradle project.
 #
 #       You can find Gradle at https://github.com/gradle/gradle/.

gradlew.bat

@@ -19,12 +19,39 @@
 @if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
-@rem  Gradle startup script for Windows
+@rem  gradlew startup script for Windows
 @rem
 @rem ##########################################################################
 
-@rem Set local scope for the variables with windows NT shell
-if "%OS%"=="Windows_NT" setlocal
+@rem Set local scope for the variables, and ensure extensions are enabled
+setlocal EnableExtensions
+
+@rem Catch executions from older scripts and ensure they exit cleanly.
+@rem This can be removed once we can be reasonably confident that few people
+@rem will be migrating directly to this new wrapper.
+goto afterSafetyNet
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+goto exitWithErrorLevel
+:afterSafetyNet
 
 set DIRNAME=%~dp0
 if "%DIRNAME%"=="" set DIRNAME=.
@@ -45,13 +72,14 @@ set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
 if %ERRORLEVEL% equ 0 goto execute
 
-echo. 1>&2
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
-echo. 1>&2
-echo Please set the JAVA_HOME variable in your environment to match the 1>&2
-echo location of your Java installation. 1>&2
+1>&2 echo.
+1>&2 echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+1>&2 echo.
+1>&2 echo Please set the JAVA_HOME variable in your environment to match the
+1>&2 echo location of your Java installation.
 
-goto fail
+"%COMSPEC%" /c exit 1
+goto exitWithErrorLevel
 
 :findJavaFromJavaHome
 set JAVA_HOME=%JAVA_HOME:"=%
@@ -59,35 +87,26 @@ set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
 if exist "%JAVA_EXE%" goto execute
 
-echo. 1>&2
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
-echo. 1>&2
-echo Please set the JAVA_HOME variable in your environment to match the 1>&2
-echo location of your Java installation. 1>&2
+1>&2 echo.
+1>&2 echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+1>&2 echo.
+1>&2 echo Please set the JAVA_HOME variable in your environment to match the
+1>&2 echo location of your Java installation.
 
-goto fail
+"%COMSPEC%" /c exit 1
+goto exitWithErrorLevel
 
 :execute
 @rem Setup the command line
 
 
 
-@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+@rem Execute gradlew
+@rem endlocal doesn't take effect until after the line is parsed and variables are expanded
+@rem which allows us to clear the local environment before executing the java command
+endlocal & "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* & call :exitWithErrorLevel & goto exitWithErrorLevel
 
-:end
-@rem End local scope for the variables with windows NT shell
-if %ERRORLEVEL% equ 0 goto mainEnd
-
-:fail
-rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
-rem the _cmd.exe /c_ return code!
-set EXIT_CODE=%ERRORLEVEL%
-if %EXIT_CODE% equ 0 set EXIT_CODE=1
-if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
-exit /b %EXIT_CODE%
-
-:mainEnd
-if "%OS%"=="Windows_NT" endlocal
-
-:omega
+@rem This label must not be changed. We rely on old scripts being able to jump to this point.
+:exitWithErrorLevel
+@rem Use "%COMSPEC%" /c exit to allow operators to work properly in scripts
+"%COMSPEC%" /c exit %ERRORLEVEL%

kotlin-ext/build.gradle.kts

@@ -1,11 +1,12 @@
 import com.vanniktech.maven.publish.KotlinJvm
 import com.vanniktech.maven.publish.JavadocJar
+import com.vanniktech.maven.publish.SourcesJar
 import java.time.LocalDate
 
 plugins {
     kotlin("jvm")
     id("com.vanniktech.maven.publish")
-    id("org.jetbrains.dokka") version "2.0.0"
+    alias(libs.plugins.dokka)
 }
 
 dependencies {
@@ -18,7 +19,7 @@ dependencies {
 kotlin {
     explicitApi()
     jvmToolchain {
-        languageVersion.set(JavaLanguageVersion.of(21))
+        languageVersion.set(JavaLanguageVersion.of(25))
     }
 }
 
@@ -75,12 +76,8 @@ mavenPublishing {
         }
     }
     configure(KotlinJvm(
-        // configures the -javadoc artifact, possible values:
-        // - `JavadocJar.None()` don't publish this artifact
-        // - `JavadocJar.Empty()` publish an empty jar
-        // - `JavadocJar.Dokka("dokkaHtml")` when using Kotlin with Dokka, where `dokkaHtml` is the name of the Dokka task that should be used as input
         javadocJar = JavadocJar.Dokka("dokkaGeneratePublicationHtml"),
-        sourcesJar = true,
+        sourcesJar = SourcesJar.Sources(),
     ))
 }
 

minestom/.gitignore

@@ -0,0 +1,3 @@
+#run minestom files
+/run
+/test

minestom/build.gradle.kts

@@ -0,0 +1,96 @@
+import java.time.LocalDate
+
+plugins {
+    id("miniplaceholders.shadow")
+    id("miniplaceholders.auto.module")
+    id("miniplaceholders.runtask")
+    `java-library`
+    id("com.vanniktech.maven.publish")
+}
+
+val shadowInclude by configurations.creating
+
+configurations {
+    compileOnly.get().extendsFrom(shadowInclude)
+    testImplementation.get().extendsFrom(shadowInclude)
+}
+
+dependencies {
+    compileOnly(libs.minestom)
+    compileOnly(libs.adventure.api)
+    compileOnly(libs.slf4j)
+    annotationProcessor(libs.minestom)
+    shadowInclude(projects.miniplaceholdersCommon)
+    api(projects.miniplaceholdersApi)
+    shadowInclude(projects.miniplaceholdersConnect)
+
+    testImplementation(libs.minestom)
+    testImplementation(libs.adventure.api)
+    testImplementation(libs.adventure.minimessage)
+    testImplementation("ch.qos.logback:logback-classic:1.6.6") // logger
+    testImplementation("com.google.guava:guava:33.7.2-jre")
+}
+
+tasks {
+    shadowJar {
+        configurations = listOf(shadowInclude)
+    }
+    test {
+        failOnNoDiscoveredTests = false
+    }
+}
+
+mavenPublishing {
+    publishToMavenCentral()
+    signAllPublications()
+    coordinates(project.group as String, "miniplaceholders-minestom", project.version as String)
+
+    pom {
+        name.set(project.name)
+        description.set(project.description)
+        inceptionYear.set(LocalDate.now().year.toString())
+        url.set("https://github.com/MiniPlaceholders/MiniPlaceholders")
+        licenses {
+            license {
+                name.set("The Apache License, Version 2.0")
+                url.set("http://www.apache.org/licenses/LICENSE-2.0.txt")
+                distribution.set("http://www.apache.org/licenses/LICENSE-2.0.txt")
+            }
+        }
+        developers {
+            developer {
+                id.set("4drian3d")
+                name.set("Adrian Gonzales")
+                email.set("adriangonzalesval@gmail.com")
+            }
+        }
+        scm {
+            connection.set("scm:git:https://github.com/MiniPlaceholders/MiniPlaceholders.git")
+            developerConnection.set("scm:git:ssh://git@github.com/MiniPlaceholders/MiniPlaceholders.git")
+            url.set("https://github.com/MiniPlaceholders/MiniPlaceholders")
+        }
+        ciManagement {
+            name.set("GitHub Actions")
+            url.set("https://github.com/MiniPlaceholders/MiniPlaceholders/actions")
+        }
+        issueManagement {
+            name.set("GitHub")
+            url.set("https://github.com/MiniPlaceholders/MiniPlaceholders/issues")
+        }
+    }
+
+    configurations {
+        named("runtimeElements") {
+            outgoing {
+                artifacts.clear()
+                artifact(tasks.shadowJar)
+            }
+        }
+        named("apiElements") {
+            outgoing {
+                artifacts.clear()
+                artifact(tasks.shadowJar)
+            }
+        }
+    }
+}

minestom/src/main/java/io/github/miniplaceholders/minestom/MinestomMiniPlaceholders.java

@@ -0,0 +1,69 @@
+package io.github.miniplaceholders.minestom;
+
+import io.github.miniplaceholders.common.PlaceholdersPlugin;
+import io.github.miniplaceholders.common.command.PermissionTester;
+import io.github.miniplaceholders.connect.InternalPlatform;
+import io.github.miniplaceholders.minestom.command.MinestomCommand;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.NamedTextColor;
+import net.kyori.adventure.text.logger.slf4j.ComponentLogger;
+import net.minestom.server.MinecraftServer;
+
+import java.nio.file.Path;
+
+public final class MinestomMiniPlaceholders implements PlaceholdersPlugin {
+    private static final ComponentLogger LOGGER = ComponentLogger.logger("miniplaceholders");
+    private final PermissionTester permissionTester;
+
+    private MinestomMiniPlaceholders(PermissionTester permissionTester) {
+        this.permissionTester = permissionTester;
+    }
+
+    public static MinestomMiniPlaceholders initialize(Path dataDirectory, PermissionTester permissionTester) {
+        InternalPlatform.platform(InternalPlatform.MINESTOM);
+        LOGGER.info(Component.text("Initializing MiniPlaceholders", NamedTextColor.GREEN));
+        final MinestomMiniPlaceholders miniPlaceholders = new MinestomMiniPlaceholders(permissionTester);
+        miniPlaceholders.registerPlatformCommand();
+
+        try {
+            miniPlaceholders.loadProvidedExpansions(dataDirectory.resolve("expansions"));
+        } catch (Throwable e) {
+            LOGGER.error("Unable to load expansion providers", e);
+        }
+
+        return miniPlaceholders;
+    }
+
+    /**
+     * Initializes MiniPlaceholders with a default no-op permission tester.
+     * This is not recommended for production use!
+     */
+    public static MinestomMiniPlaceholders initialize(final Path dataDirectory) {
+        return MinestomMiniPlaceholders.initialize(dataDirectory, PermissionTester.NO_OP);
+    }
+
+    @Override
+    public void registerPlatformCommand() {
+        MinecraftServer.getCommandManager().register(new MinestomCommand(permissionTester));
+    }
+
+    @Override
+    public boolean platformHasComplementLoaded(String complementName) {
+        return false; // Minestom doesn't plugins.
+    }
+
+    @Override
+    public Object platformServerInstance() {
+        return MinecraftServer.getServer();
+    }
+
+    @Override
+    public void logInfo(Component component) {
+        LOGGER.info(component);
+    }
+
+    @Override
+    public void logError(Component component) {
+        LOGGER.error(component);
+    }
+}

minestom/src/main/java/io/github/miniplaceholders/minestom/command/MinestomCommand.java

@@ -0,0 +1,148 @@
+package io.github.miniplaceholders.minestom.command;
+
+import io.github.miniplaceholders.common.command.AudienceConverter;
+import io.github.miniplaceholders.common.command.PermissionTester;
+import io.github.miniplaceholders.common.command.PlaceholderCommandExecutor;
+import io.github.miniplaceholders.common.command.PlayersNameProvider;
+import io.github.miniplaceholders.common.command.node.*;
+import net.kyori.adventure.audience.Audience;
+import net.kyori.adventure.text.serializer.plain.PlainTextComponentSerializer;
+import net.minestom.server.MinecraftServer;
+import net.minestom.server.command.CommandSender;
+import net.minestom.server.command.builder.Command;
+import net.minestom.server.command.builder.CommandContext;
+import net.minestom.server.command.builder.CommandExecutor;
+import net.minestom.server.command.builder.arguments.Argument;
+import net.minestom.server.command.builder.arguments.ArgumentType;
+import net.minestom.server.command.builder.condition.CommandCondition;
+import net.minestom.server.command.builder.suggestion.SuggestionEntry;
+import net.minestom.server.entity.Player;
+import org.jetbrains.annotations.Nullable;
+import org.jspecify.annotations.NonNull;
+
+import java.util.ArrayList;
+import java.util.function.Predicate;
+import java.util.stream.Collectors;
+
+public class MinestomCommand extends Command {
+    private final PermissionTester permissionTester;
+    private final PlayersNameProvider playerSuggestions;
+    private final AudienceConverter audienceConverter;
+
+    public MinestomCommand(PermissionTester permissionTester) {
+        super("miniplaceholders");
+
+        this.permissionTester = permissionTester;
+        this.playerSuggestions = () -> MinecraftServer.getConnectionManager().getOnlinePlayers()
+                .stream()
+                .map(Player::getName)
+                .map(PlainTextComponentSerializer.plainText()::serialize)
+                .collect(Collectors.toCollection(ArrayList::new));
+        this.audienceConverter = string -> MinecraftServer.getConnectionManager().getOnlinePlayerByUsername(string);
+
+        final RootNode rootNode = new RootNode(permissionTester);
+
+        this.setCondition(new WrappingCondition(rootNode::hasPermission));
+        this.setDefaultExecutor(new WrappingExecutor(rootNode::execute));
+
+        this.addSubcommands(new ExpansionsCommand(), new HelpCommand(), new ParseCommand(), new ParseRelCommand());
+    }
+
+    private class ExpansionsCommand extends Command {
+        public ExpansionsCommand() {
+            super("expansions");
+
+            final ExpansionsNode expansionsNode = new ExpansionsNode(permissionTester);
+
+            this.setCondition(new WrappingCondition(expansionsNode::hasPermission));
+            this.setDefaultExecutor(new WrappingExecutor(expansionsNode::showExpansions));
+        }
+    }
+
+    private class HelpCommand extends Command {
+        public HelpCommand() {
+            super("help");
+
+            final HelpNode helpNode = new HelpNode(permissionTester);
+
+            this.setCondition(new WrappingCondition(helpNode::hasPermission));
+            this.setDefaultExecutor(new WrappingExecutor(helpNode::execute));
+        }
+    }
+
+    private class ParseCommand extends Command {
+        public ParseCommand() {
+            super("parse");
+
+            final ParseNode parseNode = new ParseNode(playerSuggestions, audienceConverter, permissionTester);
+            final Argument<String> sourceArgument = ArgumentType.String("source")
+                    .setSuggestionCallback((_, _, suggestion) -> parseNode.providePlayerSuggestions()
+                            .stream()
+                            .filter(s -> {
+                                final String[] args = suggestion.getInput().replace("\0", "").split(" ");
+                                return args.length < 3 || s.toLowerCase().startsWith(args[2].toLowerCase());
+                            })
+                            .map(SuggestionEntry::new)
+                            .forEach(suggestion::addEntry));
+            final Argument<String[]> messageArgument = ArgumentType.StringArray("message");
+
+            this.setCondition(new WrappingCondition(parseNode::hasPermission));
+            this.addSyntax((sender, context) -> {
+                final String source = context.get(sourceArgument);
+                final String[] message = context.get(messageArgument);
+
+                parseNode.parseString(sender, source, String.join(" ", message));
+            }, sourceArgument, messageArgument);
+        }
+    }
+
+    private class ParseRelCommand extends Command {
+        public ParseRelCommand() {
+            super("parserel");
+
+            final ParseRelNode parseRelNode = new ParseRelNode(playerSuggestions, audienceConverter, permissionTester);
+            final Argument<String> sourceArgument = ArgumentType.String("source")
+                    .setSuggestionCallback((_, _, suggestion) -> parseRelNode.providePlayerSuggestions()
+                            .stream()
+                            .filter(s -> {
+                                final String[] args = suggestion.getInput().replace("\0", "").split(" ");
+                                return args.length < 3 || s.toLowerCase().startsWith(args[2].toLowerCase());
+                            })
+                            .map(SuggestionEntry::new)
+                            .forEach(suggestion::addEntry));
+            final Argument<String> relationalSourceArgument = ArgumentType.String("relational")
+                    .setSuggestionCallback((_, _, suggestion) -> parseRelNode.providePlayerSuggestions()
+                            .stream()
+                            .filter(s -> {
+                                final String[] args = suggestion.getInput().replace("\0", "").split(" ");
+                                return args.length < 4 || s.toLowerCase().startsWith(args[3].toLowerCase());
+                            })
+                            .map(SuggestionEntry::new)
+                            .forEach(suggestion::addEntry));
+            final Argument<String[]> messageArgument = ArgumentType.StringArray("message");
+
+            this.setCondition(new WrappingCondition(parseRelNode::hasPermission));
+            this.addSyntax((sender, context) -> {
+                final String source = context.get(sourceArgument);
+                final String relationalSource = context.get(relationalSourceArgument);
+                final String[] message = context.get(messageArgument);
+
+                parseRelNode.parseString(sender, source, relationalSource, String.join(" ", message));
+            }, sourceArgument, relationalSourceArgument, messageArgument);
+        }
+    }
+
+    private record WrappingCondition(Predicate<Audience> predicate) implements CommandCondition {
+        @Override
+        public boolean canUse(@NonNull CommandSender sender, @Nullable String commandString) {
+            return predicate.test(sender);
+        }
+    }
+
+    private record WrappingExecutor(PlaceholderCommandExecutor executor) implements CommandExecutor {
+        @Override
+        public void apply(@NonNull CommandSender sender, @NonNull CommandContext context) {
+            executor.execute(sender);
+        }
+    }
+}

minestom/src/test/java/io/github/miniplaceholders/minestom/MinestomServer.java

@@ -0,0 +1,89 @@
+package io.github.miniplaceholders.minestom;
+
+import io.github.miniplaceholders.minestom.listener.AsyncPlayerConfigurationListener;
+import net.kyori.adventure.util.TriState;
+import net.minestom.server.Auth;
+import net.minestom.server.MinecraftServer;
+import net.minestom.server.extras.lan.OpenToLAN;
+
+import java.io.IOException;
+import java.nio.file.DirectoryStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+import java.time.Duration;
+
+public class MinestomServer {
+
+  private static final Path MINIPLACEHOLDERS_TEST_FOLDER = Path.of("minestom", "test", "miniplaceholders");
+  private static final Path TEST_EXPANSION_FOLDER = Path.of("example-expansion-provider", "build", "libs");
+
+  static void main() throws IOException {
+    final MinecraftServer server = MinecraftServer.init(new Auth.Online());
+    MinecraftServer.getGlobalEventHandler().addListener(new AsyncPlayerConfigurationListener());
+    MinestomServer.copyTestExpansion();
+
+    MinestomMiniPlaceholders.initialize(
+        MINIPLACEHOLDERS_TEST_FOLDER,
+        (_, _) -> TriState.TRUE
+    );
+
+    OpenToLAN.open();
+    server.start("0.0.0.0", 25565);
+
+    Thread.ofPlatform().start(() -> {
+      try {
+        Thread.sleep(Duration.ofMinutes(2));
+      } catch (InterruptedException e) {
+        throw new RuntimeException(e);
+      }
+      System.exit(0);
+    });
+  }
+
+  private static void copyTestExpansion() throws IOException {
+    if (!Files.exists(TEST_EXPANSION_FOLDER)) {
+      return;
+    }
+
+    final Path expansionsFolder = MINIPLACEHOLDERS_TEST_FOLDER.resolve("expansions");
+    // Delete previous expansions files
+    try (DirectoryStream<Path> stream = Files.newDirectoryStream(
+        expansionsFolder,
+        file -> file.getFileName().toString().endsWith(".jar"))
+    ) {
+      stream.forEach(file -> {
+        try {
+          Files.delete(file);
+        } catch (IOException e) {
+          throw new RuntimeException(e);
+        }
+      });
+    }
+
+    // Copy latest example expansion file
+    try (final DirectoryStream<Path> stream = Files.newDirectoryStream(
+        TEST_EXPANSION_FOLDER,
+        file -> file.getFileName()
+            .toString().startsWith("miniplaceholders-example-expansion-provider"))
+    ) {
+      stream.forEach(file -> {
+        if (!Files.exists(expansionsFolder)) {
+          try {
+            Files.createDirectories(expansionsFolder);
+          } catch (IOException e) {
+            throw new RuntimeException(e);
+          }
+        }
+        try {
+          Files.copy(file, expansionsFolder.resolve(file.getFileName()), StandardCopyOption.REPLACE_EXISTING);
+        } catch (IOException e) {
+          throw new RuntimeException(e);
+        }
+      });
+    } catch (IOException e) {
+      System.out.println("An error occurred while loading expansion provider" + e);
+    }
+  }
+
+}

minestom/src/test/java/io/github/miniplaceholders/minestom/listener/AsyncPlayerConfigurationListener.java

@@ -0,0 +1,34 @@
+package io.github.miniplaceholders.minestom.listener;
+
+import net.minestom.server.MinecraftServer;
+import net.minestom.server.coordinate.Pos;
+import net.minestom.server.entity.Player;
+import net.minestom.server.event.EventListener;
+import net.minestom.server.event.player.AsyncPlayerConfigurationEvent;
+import net.minestom.server.instance.Instance;
+import net.minestom.server.instance.block.Block;
+import org.jspecify.annotations.NonNull;
+
+public class AsyncPlayerConfigurationListener implements EventListener<AsyncPlayerConfigurationEvent> {
+
+    private final Instance instance;
+
+    public AsyncPlayerConfigurationListener() {
+        this.instance = MinecraftServer.getInstanceManager().createInstanceContainer();
+        instance.setGenerator(unit -> unit.modifier().fillHeight(0, 32, Block.GRASS_BLOCK));
+    }
+
+    @Override
+    public @NonNull Class<AsyncPlayerConfigurationEvent> eventType() {
+        return AsyncPlayerConfigurationEvent.class;
+    }
+
+    @Override
+    public @NonNull Result run(AsyncPlayerConfigurationEvent event) {
+        final Player player = event.getPlayer();
+
+        event.setSpawningInstance(instance);
+        player.setRespawnPoint(new Pos(0, 33, 0));
+        return Result.SUCCESS;
+    }
+}

paper/build.gradle.kts

@@ -17,7 +17,7 @@ dependencies {
 tasks {
     runServer {
         jvmArgs("-Dcom.mojang.eula.agree=true")
-        minecraftVersion(libs.versions.minecraft.get())
+        minecraftVersion(libs.versions.paper.get().substringBefore('-'))
     }
     val projectVersion = project.version
     processResources {

settings.gradle.kts

@@ -16,31 +16,19 @@ pluginManagement {
 }
 
 dependencyResolutionManagement {
-    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
-        maven("https://central.sonatype.com/repository/maven-snapshots/") {
-            name = "sonatype-snapshots"
-            mavenContent {
-                snapshotsOnly()
-            }
-        }
         maven("https://repo.papermc.io/repository/maven-public/")
         maven("https://repo.maven.apache.org/maven2/")
         maven("https://repo.spongepowered.org/repository/")
-        maven("https://jitpack.io") {
-            mavenContent {
-                includeGroup("net.william278")
-            }
-        }
+        maven("https://jitpack.io")
         maven("https://repo.jpenilla.xyz/snapshots/")
     }
 }
 
 plugins {
-    id("quiet-fabric-loom") version "1.11.325"
     id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
-    id("com.vanniktech.maven.publish") version "0.34.0" apply false
-    kotlin("jvm") version "2.2.20" apply false
+    id("com.vanniktech.maven.publish") version "0.37.0" apply false
+    kotlin("jvm") version "2.4.21" apply false
 }
 
 arrayOf(
@@ -49,6 +37,7 @@ arrayOf(
     "kotlin-ext",
     "common",
     "paper",
+    "minestom",
     "velocity",
     "fabric",
     "sponge",
@@ -56,4 +45,4 @@ arrayOf(
 ).forEach {
     include("miniplaceholders-$it")
     project(":miniplaceholders-$it").projectDir = file(it)
-}
+}

sponge/build.gradle.kts

@@ -7,7 +7,7 @@ import kotlin.io.path.deleteIfExists
 plugins {
     id("miniplaceholders.auto.module")
     id("miniplaceholders.shadow")
-    id("org.spongepowered.gradle.plugin") version "2.3.0"
+    alias(libs.plugins.spongegradle)
 }
 
 dependencies {