2.2.6-SNAPSHOT

release: Version 2.2.5
chore(deps): Update dependency org.junit.jupiter:junit-jupiter to v6.1.3
2026-11-06 09:32:33 -05:00 · 2026-09-17 17:57:18 -07:00 · 2026-09-17 17:56:43 -07:00 · 2026-09-17 17:51:34 -07:00 · 2026-09-17 17:51:27 -07:00 · 2026-09-17 17:51:16 -07:00
93 changed files with 1696 additions and 382 deletions
@@ -6,3 +6,4 @@ indent_size = 2
 indent_style = space
 insert_final_newline = true
 max_line_length = off
+ij_java_imports_layout=*,|,$*
@@ -17,4 +17,4 @@ jobs:
      modrinth-publish: true
      hangar-publish: true
      loom: true
-      jdk-version: 21
+      jdk-version: 25
@@ -117,3 +117,5 @@ run/

 # Ignore Gradle build output directory
 build/
+
+.kotlin/
@@ -1,30 +1,37 @@
-![MiniMOTD logo](https://i.imgur.com/CXWwjOJ.png)
+![MiniMOTD logo](resources/minimotd-logo.png)

 [![build](https://img.shields.io/github/checks-status/jpenilla/MiniMOTD/master?label=build)](https://github.com/jpenilla/MiniMOTD/actions) [![latest release](https://img.shields.io/github/v/release/jpenilla/MiniMOTD)](https://github.com/jpenilla/MiniMOTD/releases)

 ### MiniMOTD is a basic server list MOTD plugin/mod for Minecraft servers and proxies

- MiniMOTD supports RGB colors and gradients through [MiniMessage](https://github.com/KyoriPowered/adventure-text-minimessage), which is also where MiniMOTD gets it's name.
- For more detailed info on formatting text, refer to the [MiniMessage docs](https://docs.adventure.kyori.net/minimessage.html).
+- MiniMOTD supports RGB colors and gradients through [MiniMessage](https://docs.papermc.io/adventure/minimessage/), which is also where MiniMOTD gets its name.
+- For more detailed info on formatting text, refer to the [MiniMessage docs](https://docs.papermc.io/adventure/minimessage/format/).
 - RGB colors are automatically downsampled for outdated clients.
 - RGB colors are only able to be sent by proxies and 1.16+ servers, and can only be seen by 1.16+ clients.

 #### Server Platforms
- [Paper](https://papermc.io/) / Spigot
-  - MiniMOTD is compatible with Spigot, however many features will not work. It is recommended to use Paper for full compatibility.
+- [Paper](https://papermc.io/)
 - [Sponge API 8](https://www.spongepowered.org/)
 - [Sponge API 7](https://www.spongepowered.org/)
- [Fabric](https://fabricmc.net/) (requires [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api))
+- [Fabric](https://fabricmc.net/) (requires [Fabric API](https://modrinth.com/mod/fabric-api))
+- [NeoForge](https://neoforged.net/)

 #### Proxy Platforms
 - [Velocity](https://velocitypowered.com/)
 - [Waterfall](https://papermc.io/downloads#Waterfall) / Bungeecord

 #### Downloads
-Downloads can be obtained from [GitHub releases](https://github.com/jpenilla/MiniMOTD/releases). There is a separate jar for each platform, as well as a universal jar for all platforms. Paper and Spigot share the same jar, as do Waterfall and Bungeecord.
+Downloads can be obtained from any of:
+ - [Modrinth](https://modrinth.com/plugin/minimotd)
+ - [Hangar](https://hangar.papermc.io/jmp/MiniMOTD)
+ - [GitHub releases](https://github.com/jpenilla/MiniMOTD/releases)
+
+There is a separate jar for each platform. Waterfall and Bungeecord share the same jar.
+There are two distributions for Bukkit-based servers: one for Paper >=1.21.8 only (`-paper` jar),
+and one for all other supported versions (1.8.8 - 1.21.7, Spigot and Paper) (`-bukkit` jar).

 #### Configuration
 See the [wiki](https://github.com/jpenilla/MiniMOTD/wiki) for configuration details

 #### Screenshots
-![demo motd image](https://i.ibb.co/1LRCV8b/minimotd-demo.png)
+![demo motd image](resources/minimotd-demo.png)
@@ -1,3 +1,4 @@
 plugins {
  id("minimotd.build-logic")
+  alias(libs.plugins.run.paper) apply false
 }
@@ -19,9 +19,11 @@ dependencies {
  }
  api(libs.minimessage)
  compileOnlyApi(libs.slf4jApi)
-  compileOnlyApi(libs.checkerQual)
+  compileOnlyApi(libs.jspecify)
  compileOnlyApi(libs.gson)
  testImplementation(libs.gson)
+  compileOnly(libs.brigadier)
+  compileOnly(libs.miniplaceholders)
 }

 sourceSets.main {
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -27,8 +27,7 @@ import java.util.stream.Stream;
 import net.kyori.adventure.audience.Audience;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.minimessage.MiniMessage;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;

 import static net.kyori.adventure.text.Component.space;
 import static net.kyori.adventure.text.Component.text;
@@ -42,7 +41,7 @@ import static net.kyori.adventure.text.format.NamedTextColor.WHITE;
 import static net.kyori.adventure.text.format.TextColor.color;
 import static net.kyori.adventure.text.format.TextDecoration.STRIKETHROUGH;

-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class CommandHandler {
  private final MiniMOTD<?> miniMOTD;

@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -34,8 +34,8 @@ import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.stream.Stream;
 import javax.imageio.ImageIO;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;

 public final class IconManager<I> {
  private final Map<String, I> icons = new ConcurrentHashMap<>();
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -29,16 +29,15 @@ import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.minimessage.MiniMessage;
 import net.kyori.adventure.text.minimessage.tag.resolver.Placeholder;
 import net.kyori.adventure.text.minimessage.tag.resolver.TagResolver;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;
 import org.slf4j.Logger;
 import xyz.jpenilla.minimotd.common.config.ConfigManager;
 import xyz.jpenilla.minimotd.common.config.MOTDConfig;
+import xyz.jpenilla.minimotd.common.util.MiniPlaceholdersUtil;

 import static net.kyori.adventure.text.Component.newline;

-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class MiniMOTD<I> {
  private final ConfigManager configManager;
  private final IconManager<I> iconManager;
@@ -83,7 +82,7 @@ public final class MiniMOTD<I> {
      .disablePlayerListHover(config.disablePlayerListHover())
      .hidePlayerCount(config.hidePlayerCount());

-    @Nullable String iconString = null;
+    String iconString = null;
    if (config.motdEnabled()) {
      if (config.motds().isEmpty()) {
        throw new IllegalStateException("MOTD is enabled, but there are no MOTDs in the config file?");
@@ -111,7 +110,11 @@ public final class MiniMOTD<I> {
    final String max = Integer.toString(count.maxPlayers());
    return MiniMessage.miniMessage().deserialize(
      replacePlayerCount(input, online, max),
-      TagResolver.resolver(Placeholder.unparsed("online_players", online), Placeholder.unparsed("max_players", max))
+      TagResolver.resolver(
+        Placeholder.unparsed("online_players", online),
+        Placeholder.unparsed("max_players", max),
+        MiniPlaceholdersUtil.tagResolver()
+      )
    );
  }

@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@ package xyz.jpenilla.minimotd.common;

 import java.awt.image.BufferedImage;
 import java.nio.file.Path;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.slf4j.Logger;

 public interface MiniMOTDPlatform<I> {
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -26,13 +26,12 @@ package xyz.jpenilla.minimotd.common;
 import java.util.function.Consumer;
 import java.util.function.IntConsumer;
 import net.kyori.adventure.text.Component;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;

 import static java.util.Objects.requireNonNull;

-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class PingResponse<I> {
  private final @Nullable I icon;
  private final @Nullable Component motd;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -29,8 +29,7 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.function.Consumer;
 import java.util.function.UnaryOperator;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;
 import org.spongepowered.configurate.CommentedConfigurationNode;
 import org.spongepowered.configurate.ConfigurateException;
 import org.spongepowered.configurate.ConfigurationOptions;
@@ -39,7 +38,7 @@ import org.spongepowered.configurate.objectmapping.ObjectMapper;
 import org.spongepowered.configurate.serialize.SerializationException;
 import org.spongepowered.configurate.serialize.TypeSerializerCollection;

-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class ConfigLoader<C> {
  private static final TypeSerializerCollection SERIALIZERS;

@@ -94,13 +93,13 @@ public final class ConfigLoader<C> {
  }

  public ConfigLoader(
-    final @NonNull Class<C> configClass,
-    final @NonNull Path configPath
+    final Class<C> configClass,
+    final Path configPath
  ) {
    this(configClass, configPath, options -> options);
  }

-  public @NonNull C load() throws ConfigurateException {
+  public C load() throws ConfigurateException {
    final CommentedConfigurationNode node = this.loader.load();
    final C config = this.mapper.load(node);
    for (final Consumer<C> processor : this.postProcess) {
@@ -109,7 +108,7 @@ public final class ConfigLoader<C> {
    return config;
  }

-  public void save(final @NonNull C config) throws ConfigurateException {
+  public void save(final C config) throws ConfigurateException {
    final CommentedConfigurationNode node = this.loader.createNode();
    this.mapper.save(config, node);
    this.loader.save(node);
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -34,8 +34,8 @@ import java.util.List;
 import java.util.Map;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
 import org.spongepowered.configurate.ConfigurateException;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.util.Pair;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -26,7 +26,7 @@ package xyz.jpenilla.minimotd.common.config;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.spongepowered.configurate.objectmapping.ConfigSerializable;
 import org.spongepowered.configurate.objectmapping.meta.Comment;
 import xyz.jpenilla.minimotd.common.PingResponse;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -26,8 +26,8 @@ package xyz.jpenilla.minimotd.common.config;
 import java.lang.reflect.Type;
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.function.Predicate;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
 import org.spongepowered.configurate.serialize.ScalarSerializer;
 import org.spongepowered.configurate.serialize.SerializationException;
 import xyz.jpenilla.minimotd.common.util.Int2IntFunction;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -26,9 +26,9 @@ package xyz.jpenilla.minimotd.common.config;
 import java.util.LinkedHashMap;
 import java.util.Locale;
 import java.util.Map;
-import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import java.util.Objects;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
 import org.spongepowered.configurate.objectmapping.ConfigSerializable;
 import org.spongepowered.configurate.objectmapping.meta.Comment;

@@ -63,7 +63,7 @@ public final class PluginSettings {
      + "checked in the order they are declared if there are no exact matches.")
    private final Map<String, String> virtualHostConfigs = new LinkedHashMap<>();

-    private transient @MonotonicNonNull Map<String[], String> splitVirtualHostConfigs;
+    private transient @Nullable Map<String[], String> splitVirtualHostConfigs;

    @Comment("Set whether to enable virtual host testing mode.\n"
      + "When enabled, MiniMOTD will print virtual host debug info to the console on each server ping.")
@@ -74,6 +74,7 @@ public final class PluginSettings {
    }

    public @Nullable String findConfigStringForHost(@NonNull String host, final int port) {
+      Objects.requireNonNull(this.splitVirtualHostConfigs, "processVirtualHosts must be called first");
      host = processTcpShieldHostname(host).toLowerCase(Locale.ENGLISH) + ':' + port;

      final @Nullable String exactMatch = this.virtualHostConfigs.get(host);
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -0,0 +1,66 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.common.util;
+
+import com.mojang.brigadier.Command;
+import com.mojang.brigadier.builder.LiteralArgumentBuilder;
+import com.mojang.brigadier.context.CommandContext;
+import java.util.function.Function;
+import java.util.function.Predicate;
+import net.kyori.adventure.audience.Audience;
+import org.jspecify.annotations.NullMarked;
+import xyz.jpenilla.minimotd.common.CommandHandler;
+
+@NullMarked
+public final class BrigadierUtil {
+  private BrigadierUtil() {
+  }
+
+  public static <S> LiteralArgumentBuilder<S> buildTree(
+    final CommandHandler handler,
+    final Function<S, Audience> audienceExtractor,
+    final Predicate<S> permissionChecker
+  ) {
+    final class WrappingExecutor implements Command<S> {
+      private final CommandHandler.Executor handler;
+
+      WrappingExecutor(final CommandHandler.Executor handler) {
+        this.handler = handler;
+      }
+
+      @Override
+      public int run(final CommandContext<S> context) {
+        this.handler.execute(audienceExtractor.apply(context.getSource()));
+        return Command.SINGLE_SUCCESS;
+      }
+    }
+
+    return LiteralArgumentBuilder.<S>literal("minimotd")
+      .requires(permissionChecker)
+      .executes(new WrappingExecutor(handler::help))
+      .then(LiteralArgumentBuilder.<S>literal("help").executes(new WrappingExecutor(handler::help)))
+      .then(LiteralArgumentBuilder.<S>literal("about").executes(new WrappingExecutor(handler::about)))
+      .then(LiteralArgumentBuilder.<S>literal("reload").executes(new WrappingExecutor(handler::reload)));
+  }
+}
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@ package xyz.jpenilla.minimotd.common.util;

 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.serializer.gson.GsonComponentSerializer;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;

 public interface ComponentColorDownsampler {
  static @NonNull ComponentColorDownsampler downsampler() {
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -0,0 +1,68 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.common.util;
+
+import io.github.miniplaceholders.api.MiniPlaceholders;
+import java.util.Objects;
+import net.kyori.adventure.text.minimessage.tag.resolver.TagResolver;
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+public final class MiniPlaceholdersUtil {
+  private static final String KYORI_PREFIX = new String(new char[]{'n', 'e', 't', '.', 'k', 'y', 'o', 'r', 'i'});
+  private static byte miniPlaceholdersLoaded = -1;
+
+  private MiniPlaceholdersUtil() {
+  }
+
+  private static boolean miniPlaceholdersLoaded() {
+    if (miniPlaceholdersLoaded == -1) {
+      if (!TagResolver.class.getName().startsWith(KYORI_PREFIX)) {
+        miniPlaceholdersLoaded = 0;
+        return false;
+      }
+
+      try {
+        final String name = MiniPlaceholders.class.getName();
+        Objects.requireNonNull(name);
+        miniPlaceholdersLoaded = 1;
+      } catch (final NoClassDefFoundError error) {
+        miniPlaceholdersLoaded = 0;
+      }
+    }
+
+    return miniPlaceholdersLoaded == 1;
+  }
+
+  public static TagResolver tagResolver() {
+    if (!miniPlaceholdersLoaded()) {
+      return TagResolver.empty();
+    }
+    return tagResolver_();
+  }
+
+  private static TagResolver tagResolver_() {
+    return MiniPlaceholders.globalPlaceholders();
+  }
+}
@@ -0,0 +1,129 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.common.util;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import org.jspecify.annotations.Nullable;
+
+public abstract class Nag {
+  private static final String EQUALS_LINE = "====================================================";
+
+  private final List<String> lines = new ArrayList<>();
+  private boolean exception = false;
+  private boolean error = false;
+
+  public Nag lines(final String... lines) {
+    this.lines.addAll(Arrays.asList(lines));
+    return this;
+  }
+
+  public Nag line(final String line) {
+    this.lines.add(line);
+    return this;
+  }
+
+  public Nag error(final boolean withException) {
+    this.error = true;
+    this.exception = withException;
+    return this;
+  }
+
+  protected abstract void logError(String message, @Nullable Throwable throwable);
+
+  protected abstract void logWarn(String message, @Nullable Throwable throwable);
+
+  public void logBanner() {
+    final List<String> toLog = new ArrayList<>();
+    toLog.add(EQUALS_LINE);
+    toLog.addAll(this.lines);
+    toLog.add(EQUALS_LINE);
+
+    for (final String line : toLog) {
+      if (this.error) {
+        this.logError(line, null);
+      } else {
+        this.logWarn(line, null);
+      }
+    }
+
+    if (this.exception) {
+      // this.exception implies this.error
+      this.logError("Please see the above notice.", new RuntimeException("Please see the above notice."));
+    }
+  }
+
+  public static final class Slf4J extends Nag {
+    private final org.slf4j.Logger logger;
+
+    public Slf4J(final org.slf4j.Logger logger) {
+      this.logger = logger;
+    }
+
+    @Override
+    protected void logError(final String message, @Nullable final Throwable throwable) {
+      if (throwable != null) {
+        this.logger.error(message, throwable);
+      } else {
+        this.logger.error(message);
+      }
+    }
+
+    @Override
+    protected void logWarn(final String message, @Nullable final Throwable throwable) {
+      if (throwable != null) {
+        this.logger.warn(message, throwable);
+      } else {
+        this.logger.warn(message);
+      }
+    }
+  }
+
+  public static final class JavaUtilLogging extends Nag {
+    private final java.util.logging.Logger logger;
+
+    public JavaUtilLogging(final java.util.logging.Logger logger) {
+      this.logger = logger;
+    }
+
+    @Override
+    protected void logError(final String message, @Nullable final Throwable throwable) {
+      if (throwable != null) {
+        this.logger.log(java.util.logging.Level.SEVERE, message, throwable);
+      } else {
+        this.logger.severe(message);
+      }
+    }
+
+    @Override
+    protected void logWarn(final String message, @Nullable final Throwable throwable) {
+      if (throwable != null) {
+        this.logger.log(java.util.logging.Level.WARNING, message, throwable);
+      } else {
+        this.logger.warning(message);
+      }
+    }
+  }
+}
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -24,8 +24,8 @@
 package xyz.jpenilla.minimotd.common.util;

 import java.util.Objects;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;

 public final class Pair<L, R> {
  private final L left;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -36,7 +36,7 @@ import java.util.LinkedHashMap;
 import java.util.LinkedList;
 import java.util.List;
 import java.util.Map;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.Constants;

 public final class UpdateChecker {
@@ -67,8 +67,8 @@ public final class UpdateChecker {
    return Arrays.asList(
      "There is an update available for " + Constants.PluginMetadata.NAME + "!",
      "This server is running version " + currentVersion + ", which is " + (versionsBehind == -1 ? "UNKNOWN" : versionsBehind) + " versions outdated.",
-      "Download the latest version, " + versionList.get(0) + " from GitHub at the link below:",
-      versionMap.get(versionList.get(0))
+      "Download the latest version, " + versionList.get(0) + " from Modrinth at the link below:",
+      "https://modrinth.com/plugin/minimotd"
    );
  }
 }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,27 +0,0 @@
-plugins {
-  id("minimotd.platform-conventions")
-}
-
-tasks.jar {
-  archiveClassifier.set("empty")
-}
-
-val platforms = setOf(
-  projects.minimotdBukkit,
-  projects.minimotdBungeecord,
-).map { it.dependencyProject }
-
-val dist = tasks.register<Jar>("bukkitAndBungeeJar") {
-  artifacts.add("archives", this)
-  archiveClassifier.set(null as String?)
-  duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-
-  for (platform in platforms) {
-    val jarTask = platform.miniMOTDPlatform.jarTask
-    from(zipTree(jarTask.flatMap { it.archiveFile }))
-  }
-}
-
-miniMOTDPlatform {
-  jarTask.set(dist)
-}
@@ -1,8 +1,7 @@
 group=xyz.jpenilla
-version=2.1.1
+version=2.2.6-SNAPSHOT
 description=Use MiniMessage text formatting in the server list MOTD.

 org.gradle.caching=true
-org.gradle.configureondemand=true
 org.gradle.jvmargs=-Xmx2G
 org.gradle.parallel=true
@@ -2,5 +2,5 @@ object Constants {
  const val GITHUB_USER = "jpenilla"
  const val GITHUB_REPO = "MiniMOTD"
  const val GITHUB_URL = "https://github.com/$GITHUB_USER/$GITHUB_REPO"
-  const val RELOCATION_BASE_PACKAGE = "xyz.jpenilla.minimotd.lib"
+  const val RELOCATION_BASE_PACKAGE = "minimotd"
 }
@@ -1,11 +1,12 @@
 import net.kyori.indra.git.IndraGitExtension
 import org.gradle.accessors.dm.LibrariesForLibs
 import org.gradle.api.Project
+import org.gradle.api.attributes.Attribute
 import org.gradle.api.provider.Provider
 import org.gradle.kotlin.dsl.getByType

 fun Project.lastCommitHash(): String =
-  extensions.getByType<IndraGitExtension>().commit()?.name?.substring(0, 7) ?: "unknown"
+  extensions.getByType<IndraGitExtension>().commit().orNull?.name?.substring(0, 7) ?: "unknown"

 val Project.libs: LibrariesForLibs
  get() = extensions.getByType()
@@ -30,5 +31,28 @@ val bukkitVersions = listOf(
  "1.17.1",
  "1.18.2",
  "1.19.4",
-  "1.20.4"
+  "1.20.4",
+  "1.20.5",
+  "1.20.6",
+  "1.21.1",
+  "1.21.2",
+  "1.21.3",
+  "1.21.4",
+  "1.21.5",
+  "1.21.6",
+  "1.21.7",
 )
+
+val paperVersions = listOf(
+  "1.21.8",
+  "1.21.9",
+  "1.21.10",
+  "1.21.11",
+  "26.1",
+  "26.1.1",
+  "26.1.2",
+  "26.2",
+  "26.3",
+)
+
+val productionJarAttribute = Attribute.of("minimotd.productionJar", String::class.java)
@@ -11,15 +11,35 @@ version = (version as String)

 indra {
  javaVersions {
-    minimumToolchain(17)
-    target(8)
+    target(17)
+    minimumToolchain(25)
+    testWith(17, 21, 25)
  }
  github(Constants.GITHUB_USER, Constants.GITHUB_REPO)
  mitLicense()
 }

+java.disableAutoTargetJvm()
+
+repositories {
+  mavenCentral {
+    mavenContent { releasesOnly() }
+  }
+  maven("https://repo.jpenilla.xyz/snapshots/") {
+    mavenContent {
+      snapshotsOnly()
+      includeGroup("xyz.jpenilla")
+    }
+  }
+  maven("https://central.sonatype.com/repository/maven-snapshots/") {
+    mavenContent { snapshotsOnly() }
+  }
+  maven("https://repo.papermc.io/repository/maven-public/")
+  maven("https://repo.spongepowered.org/repository/maven-public/")
+}
+
 dependencies {
-  testImplementation(libs.jupiterEngine)
+  testImplementation(libs.junitJupiter)
  testRuntimeOnly("org.junit.platform:junit-platform-launcher")
 }

@@ -14,20 +14,22 @@ hangarPublish.publications.register("plugin") {
  apiKey.set(providers.environmentVariable("HANGAR_UPLOAD_KEY"))
  platforms {
    paper {
-      jar.set(jar("bukkit"))
-      val vers = bukkitVersions.toMutableList()
-      vers -= "1.8.8"
-      vers -= "1.8.9"
-      vers += "1.8"
-      platformVersions.addAll(vers)
+      jar.set(jar("paper"))
+      platformVersions = paperVersions
+      dependencies.hangar("MiniPlaceholders") {
+        required = false
+      }
    }
    velocity {
      jar.set(jar("velocity"))
-      platformVersions.addAll("3.2")
+      platformVersions.addAll("3.4")
+      dependencies.hangar("MiniPlaceholders") {
+        required = false
+      }
    }
    waterfall {
      jar.set(jar("bungeecord"))
-      platformVersions.addAll("1.20")
+      platformVersions.addAll("1.21")
    }
  }
 }
@@ -32,3 +32,10 @@ if (name != "minimotd-bukkit-bungeecord") {
    }
  }
 }
+
+configurations.consumable("productionJar") {
+  outgoing {
+    artifact(platformExtension.jarTask)
+  }
+  attributes.attribute(productionJarAttribute, "true")
+}
@@ -1,6 +1,6 @@
 plugins {
  id("minimotd.platform-conventions")
-  id("io.github.goooler.shadow")
+  id("com.gradleup.shadow")
 }

 tasks {
@@ -1,14 +1,17 @@
 import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
+import org.gradle.api.file.DuplicatesStrategy

 fun ShadowJar.commonRelocation(pkg: String) {
  relocate(pkg, "${Constants.RELOCATION_BASE_PACKAGE}.$pkg")
 }

-fun ShadowJar.platformRelocation(platform: String, pkg: String) {
-  relocate(pkg, "${Constants.RELOCATION_BASE_PACKAGE}.platform_$platform.$pkg")
-}
-
 fun ShadowJar.commonConfiguration() {
+  mergeServiceFiles()
+  // Needed for mergeServiceFiles to work properly in Shadow 9+
+  filesMatching("META-INF/services/**") {
+    duplicatesStrategy = DuplicatesStrategy.INCLUDE
+  }
+
  commonRelocation("org.spongepowered.configurate")
  commonRelocation("com.typesafe.config")
  dependencies {
@@ -1,33 +1,37 @@
-[plugins]
-blossom = { id = "net.kyori.blossom", version = "2.1.0" }
-sponge-gradle-plugin = { id = "org.spongepowered.gradle.plugin", version = "2.2.0" }
-run-paper = { id = "xyz.jpenilla.run-paper", version.ref = "run-task" }
-run-velocity = { id = "xyz.jpenilla.run-velocity", version.ref = "run-task" }
-run-waterfall = { id = "xyz.jpenilla.run-waterfall", version.ref = "run-task" }
-
 [versions]
-run-task = "2.3.0"
-mod-publish-plugin = "0.5.1"
-hangarPublishPlugin = "0.1.2"
-indra = "3.1.3"
-shadow = "8.1.7"
-adventure = "4.17.0"
-adventurePlatform = "4.3.3"
-adventurePlatformFabric = "5.13.0"
-configurate = "4.1.2"
-checkerQual = "3.43.0"
-slf4j = "1.7.32"
+run-task = "3.1.0"
+resource-factory = "1.3.1"
+mod-publish-plugin = "2.2.0"
+hangarPublishPlugin = "0.1.4"
+indra = "4.1.0"
+shadow = "9.6.1"
+adventure = "4.26.1"
+adventurePlatform = "4.4.1"
+adventurePlatformMod = "7.2.0"
+configurate = "4.2.0"
+slf4j = "1.7.36"
 gson = "2.8.0"
-bstats = "3.0.2"
-paperApi = "1.16.5-R0.1-SNAPSHOT"
+bstats = "3.2.1"
+paperApiLegacy = "1.16.5-R0.1-SNAPSHOT"
+paperApi = "1.21.11-R0.1-SNAPSHOT"
 paperlib = "1.0.8"
 waterfallApi = "1.16-R0.5-SNAPSHOT"
-fabricApi = "0.99.4+1.20.6"
-fabricLoader = "0.15.11"
-minecraft = "1.20.6"
-spongeApi7 = "7.2.0"
-velocityApi = "3.2.0-SNAPSHOT"
-jupiterEngine = "5.10.2"
+fabricApi = "0.160.7+26.3"
+fabricLoader = "0.19.5"
+minecraft = "26.3"
+spongeApi7 = "7.4.0"
+velocityApi = "3.4.0"
+neoforge = "26.3.0.4-beta"
+
+[plugins]
+blossom = { id = "net.kyori.blossom", version = "2.2.0" }
+sponge-gradle-plugin = { id = "org.spongepowered.gradle.plugin", version = "2.3.0" }
+run-paper = { id = "xyz.jpenilla.run-paper", version.ref = "run-task" }
+run-velocity = { id = "xyz.jpenilla.run-velocity" }
+run-waterfall = { id = "xyz.jpenilla.run-waterfall" }
+resource-factory-bukkit = { id = "xyz.jpenilla.resource-factory-bukkit-convention", version.ref = "resource-factory" }
+resource-factory-paper = { id = "xyz.jpenilla.resource-factory-paper-convention", version.ref = "resource-factory" }
+resource-factory-velocity = { id = "xyz.jpenilla.resource-factory-velocity-convention", version.ref = "resource-factory" }

 [libraries]
 adventureBom = { group = "net.kyori", name = "adventure-bom", version.ref = "adventure" }
@@ -36,13 +40,17 @@ adventureTextSerializerPlain = { group = "net.kyori", name = "adventure-text-ser
 adventureTextSerializerGson = { group = "net.kyori", name = "adventure-text-serializer-gson" }
 adventurePlatformBungeecord = { group = "net.kyori", name = "adventure-platform-bungeecord", version.ref = "adventurePlatform" }
 adventurePlatformBukkit = { group = "net.kyori", name = "adventure-platform-bukkit", version.ref = "adventurePlatform" }
-adventurePlatformFabric = { group = "net.kyori", name = "adventure-platform-fabric", version.ref = "adventurePlatformFabric" }
+adventurePlatformFabric = { group = "net.kyori", name = "adventure-platform-fabric", version.ref = "adventurePlatformMod" }
+adventurePlatformNeoforge = { group = "net.kyori", name = "adventure-platform-neoforge", version.ref = "adventurePlatformMod" }
 adventurePlatformSpongeApi = { group = "net.kyori", name = "adventure-platform-spongeapi", version.ref = "adventurePlatform" }
 minimessage = { group = "net.kyori", name = "adventure-text-minimessage" }
+miniplaceholders = "io.github.miniplaceholders:miniplaceholders-api:3.2.0"
+
+brigadier = "com.mojang:brigadier:1.3.10"

 configurateHocon = { group = "org.spongepowered", name = "configurate-hocon", version.ref = "configurate" }

-checkerQual = { group = "org.checkerframework", name = "checker-qual", version.ref = "checkerQual" }
+jspecify = "org.jspecify:jspecify:1.0.0"

 slf4jApi = { group = "org.slf4j", name = "slf4j-api", version.ref = "slf4j" }
 slf4jJdk14 = { group = "org.slf4j", name = "slf4j-jdk14", version.ref = "slf4j" }
@@ -54,7 +62,8 @@ bstatsBungeecord = { group = "org.bstats", name = "bstats-bungeecord", version.r
 bstatsVelocity = { group = "org.bstats", name = "bstats-velocity", version.ref = "bstats" }
 bstatsSponge = { group = "org.bstats", name = "bstats-sponge", version.ref = "bstats" }

-paperApi = { group = "com.destroystokyo.paper", name = "paper-api", version.ref = "paperApi" }
+paperApiLegacy = { group = "com.destroystokyo.paper", name = "paper-api", version.ref = "paperApiLegacy" }
+paperApi = { group = "io.papermc.paper", name = "paper-api", version.ref = "paperApi" }
 paperlib = { group = "io.papermc", name = "paperlib", version.ref = "paperlib" }

 waterfallApi = { group = "io.github.waterfallmc", name = "waterfall-api", version.ref = "waterfallApi" }
@@ -63,16 +72,19 @@ fabricApi = { group = "net.fabricmc.fabric-api", name = "fabric-api", version.re
 fabricLoader = { group = "net.fabricmc", name = "fabric-loader", version.ref = "fabricLoader" }
 minecraft = { group = "com.mojang", name = "minecraft", version.ref = "minecraft" }

+# for renovate
+zNeoforge = { module = "net.neoforged:neoforge", version.ref = "neoforge" }
+
 spongeApi7 = { group = "org.spongepowered", name = "spongeapi", version.ref = "spongeApi7" }

 velocityApi = { group = "com.velocitypowered", name = "velocity-api", version.ref = "velocityApi" }

-jupiterEngine = { group = "org.junit.jupiter", name = "junit-jupiter-engine", version.ref = "jupiterEngine" }
+junitJupiter = "org.junit.jupiter:junit-jupiter:6.1.3"

 # build-logic
 indraCommon = { group = "net.kyori", name = "indra-common", version.ref = "indra" }
 indraLicenser = { group = "net.kyori", name = "indra-licenser-spotless", version.ref = "indra" }
-shadow = { group = "io.github.goooler.shadow", name = "shadow-gradle-plugin", version.ref = "shadow" }
+shadow = { group = "com.gradleup.shadow", name = "shadow-gradle-plugin", version.ref = "shadow" }
 mod-publish-plugin = { module = "me.modmuss50:mod-publish-plugin", version.ref = "mod-publish-plugin" }
 hangarPublishPlugin = { group = "io.papermc", name = "hangar-publish-plugin", version.ref = "hangarPublishPlugin" }

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

 #
-# Copyright © 2015-2021 the original authors.
+# Copyright © 2015 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,10 +15,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+# SPDX-License-Identifier: Apache-2.0
+#

 ##############################################################################
 #
-#   Gradle start up script for POSIX generated by Gradle.
+#   gradlew start up script for POSIX generated by Gradle.
 #
 #   Important for running:
 #
@@ -27,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:
@@ -55,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/.
@@ -84,7 +86,7 @@ done
 # shellcheck disable=SC2034
 APP_BASE_NAME=${0##*/}
 # Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
-APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit

 # Use the maximum available, or set MAX_FD != -1 to use that value.
 MAX_FD=maximum
@@ -112,7 +114,6 @@ case "$( uname )" in                #(
  NONSTOP* )        nonstop=true ;;
 esac

-CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar


 # Determine the Java command to use to start the JVM.
@@ -170,7 +171,6 @@ fi
 # For Cygwin or MSYS, switch paths to Windows format before running java
 if "$cygwin" || "$msys" ; then
    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
-    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )

    JAVACMD=$( cygpath --unix "$JAVACMD" )

@@ -203,15 +203,14 @@ fi
 DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'

 # Collect all arguments for the java command:
-#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
 #     and any embedded shellness will be escaped.
 #   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
 #     treated as '${Hostname}' itself on the command line.

 set -- \
        "-Dorg.gradle.appname=$APP_BASE_NAME" \
-        -classpath "$CLASSPATH" \
-        org.gradle.wrapper.GradleWrapperMain \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
        "$@"

 # Stop when "xargs" is not available.
@@ -13,16 +13,18 @@
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem

@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

 set DIRNAME=%~dp0
 if "%DIRNAME%"=="" set DIRNAME=.
@@ -49,7 +51,7 @@ 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

-goto fail
+"%COMSPEC%" /c exit 1

 :findJavaFromJavaHome
 set JAVA_HOME=%JAVA_HOME:"=%
@@ -63,30 +65,18 @@ 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

-goto fail
+"%COMSPEC%" /c exit 1

 :execute
@rem Setup the command line

-set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar


-@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+@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

-: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
+:exitWithErrorLevel
+@rem Use "%COMSPEC%" /c exit to allow operators to work properly in scripts
+"%COMSPEC%" /c exit %ERRORLEVEL%
@@ -1,6 +1,6 @@
 MIT License

-Copyright (c) 2020-2024 Jason Penilla
+Copyright (c) 2020-2025 Jason Penilla

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1,6 +1,6 @@
 This file is part of MiniMOTD, licensed under the MIT License.

-Copyright (c) 2020-2024 Jason Penilla
+Copyright (c) 2020-2025 Jason Penilla

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1,6 +1,7 @@
 plugins {
  id("minimotd.shadow-platform")
  alias(libs.plugins.run.paper)
+  alias(libs.plugins.resource.factory.bukkit)
 }

 dependencies {
@@ -9,15 +10,14 @@ dependencies {
  implementation(libs.adventurePlatformBukkit)
  implementation(libs.bstatsBukkit)
  implementation(libs.paperlib)
-  compileOnly(libs.paperApi)
+  compileOnly(libs.paperApiLegacy)
 }

 tasks {
  runServer {
-    minecraftVersion(minecraftVersion)
+    minecraftVersion("1.21.7")
  }
  shadowJar {
-    platformRelocation("bukkit", "xyz.jpenilla.minimotd.common")
    commonRelocation("org.slf4j")
    commonRelocation("io.leangen.geantyref")
    commonRelocation("net.kyori")
@@ -27,22 +27,26 @@ tasks {
      attributes("paperweight-mappings-namespace" to "mojang")
    }
  }
-  processResources {
-    val props = mapOf(
-      "version" to project.version,
-      "website" to Constants.GITHUB_URL,
-      "description" to project.description
-    )
-    inputs.properties(props)
-    filesMatching("plugin.yml") {
-      expand(props)
-    }
+}
+
+bukkitPluginYaml {
+  name = "MiniMOTD"
+  main = "xyz.jpenilla.minimotd.bukkit.MiniMOTDBukkit"
+  foliaSupported = true
+  authors = listOf("jmp")
+  website = Constants.GITHUB_URL
+  commands.register("minimotd") {
+    description = "MiniMOTD Command"
+    permission = "minimotd.admin"
+    usage = "/minimotd help"
  }
+  apiVersion = "1.13"
+  softDepend = listOf("ViaVersion")
 }

 runPaper.folia.registerTask()

 publishMods.modrinth {
  modLoaders.addAll("paper", "folia")
-  minecraftVersions.addAll(bukkitVersions)
+  minecraftVersions = bukkitVersions
 }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -31,7 +31,7 @@ import org.bukkit.command.Command;
 import org.bukkit.command.CommandExecutor;
 import org.bukkit.command.CommandSender;
 import org.bukkit.command.TabCompleter;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.CommandHandler;

 import static net.kyori.adventure.text.Component.text;
@@ -39,10 +39,10 @@ import static net.kyori.adventure.text.event.ClickEvent.runCommand;
 import static net.kyori.adventure.text.format.NamedTextColor.RED;

 final class BukkitCommand implements CommandExecutor, TabCompleter {
-  private final MiniMOTDPlugin plugin;
+  private final MiniMOTDBukkit plugin;
  private final CommandHandler handler;

-  BukkitCommand(final @NonNull MiniMOTDPlugin plugin) {
+  BukkitCommand(final @NonNull MiniMOTDBukkit plugin) {
    this.plugin = plugin;
    this.handler = new CommandHandler(plugin.miniMOTD());
  }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -29,18 +29,20 @@ import java.nio.file.Path;
 import java.util.concurrent.CompletableFuture;
 import net.kyori.adventure.platform.bukkit.BukkitAudiences;
 import org.bstats.bukkit.Metrics;
+import org.bstats.charts.SimplePie;
 import org.bukkit.command.PluginCommand;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.bukkit.util.CachedServerIcon;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.MiniMOTDPlatform;
+import xyz.jpenilla.minimotd.common.util.Nag;
 import xyz.jpenilla.minimotd.common.util.UpdateChecker;

-public final class MiniMOTDPlugin extends JavaPlugin implements MiniMOTDPlatform<CachedServerIcon> {
+public final class MiniMOTDBukkit extends JavaPlugin implements MiniMOTDPlatform<CachedServerIcon> {
  private static final boolean PAPER_PING_EVENT_EXISTS = findClass("com.destroystokyo.paper.event.server.PaperServerListPingEvent") != null;

  private Logger logger;
@@ -50,6 +52,21 @@ public final class MiniMOTDPlugin extends JavaPlugin implements MiniMOTDPlatform
  @Override
  public void onEnable() {
    this.logger = LoggerFactory.getLogger(this.getName());
+
+    if (PaperLib.getMinecraftVersion() > 21 || PaperLib.getMinecraftVersion() == 21 && PaperLib.getMinecraftPatchVersion() > 7) {
+      new Nag.Slf4J(this.logger).lines(
+        "You are using the incorrect MiniMOTD build for your server software.",
+        "This build is for Spigot/Paper 1.8.8 through 1.21.7.",
+        "Builds for Paper 1.21.8+ are available on Modrinth (https://modrinth.com/plugin/minimotd)",
+        "and Hangar (https://hangar.papermc.io/jmp/MiniMOTD).",
+        "When downloading be sure to check the supported versions/platforms",
+        "field on the versions page, and/or make the correct selections in",
+        "the download menu."
+      ).error(true).logBanner();
+      this.getServer().getPluginManager().disablePlugin(this);
+      return;
+    }
+
    this.miniMOTD = new MiniMOTD<>(this);
    this.audiences = BukkitAudiences.create(this);

@@ -70,6 +87,7 @@ public final class MiniMOTDPlugin extends JavaPlugin implements MiniMOTDPlatform
    }

    final Metrics metrics = new Metrics(this, 8132);
+    metrics.addCustomChart(new SimplePie("variant", () -> "bukkit"));

    if (this.miniMOTD.configManager().pluginSettings().updateChecker()) {
      try {
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -25,17 +25,32 @@ package xyz.jpenilla.minimotd.bukkit;

 import com.destroystokyo.paper.event.server.PaperServerListPingEvent;
 import io.papermc.lib.PaperLib;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.List;
 import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.util.CachedServerIcon;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.Constants;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.PingResponse;
 import xyz.jpenilla.minimotd.common.config.MOTDConfig;

 public final class PaperPingListener implements Listener {
+  private static final Method WORK_AROUND_PAPER_BUG;
+
+  static {
+    Method paperWorkaround;
+    try {
+      paperWorkaround = PaperServerListPingEvent.class.getMethod("getListedPlayers");
+    } catch (final NoSuchMethodException e) {
+      paperWorkaround = null;
+    }
+    WORK_AROUND_PAPER_BUG = paperWorkaround;
+  }
+
  private final LegacyComponentSerializer unusualHexSerializer = LegacyComponentSerializer.builder().hexColors().useUnusualXRepeatedCharacterHexFormat().build();
  private final MiniMOTD<CachedServerIcon> miniMOTD;

@@ -60,7 +75,17 @@ public final class PaperPingListener implements Listener {
    response.icon(event::setServerIcon);

    if (response.disablePlayerListHover()) {
-      event.getPlayerSample().clear();
+      if (WORK_AROUND_PAPER_BUG != null) {
+        // Newer Paper replaces getPlayerSample with getListedPlayers,
+        // the old method is supposed to still work, but it just silently does nothing on 1.20.6 (fixed in 1.21.1)
+        try {
+          ((List) WORK_AROUND_PAPER_BUG.invoke(event)).clear();
+        } catch (final IllegalAccessException | InvocationTargetException e) {
+          throw new RuntimeException("Failed to invoke " + WORK_AROUND_PAPER_BUG.getName(), e);
+        }
+      } else {
+        event.getPlayerSample().clear();
+      }
    }
    if (response.hidePlayerCount()) {
      event.setHidePlayers(true);
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -29,7 +29,7 @@ import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.server.ServerListPingEvent;
 import org.bukkit.util.CachedServerIcon;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.PingResponse;
 import xyz.jpenilla.minimotd.common.config.MOTDConfig;
@@ -1,16 +0,0 @@
-name: MiniMOTD
-version: $version
-main: xyz.jpenilla.minimotd.bukkit.MiniMOTDPlugin
-folia-supported: true
-description: $description
-authors:
-  - jmp
-website: $website
-commands:
-  minimotd:
-    description: MiniMOTD Command
-    permission: minimotd.admin
-    usage: /minimotd help
-api-version: 1.13
-softdepend:
-  - ViaVersion
@@ -12,13 +12,12 @@ dependencies {

 tasks {
  shadowJar {
-    platformRelocation("bungee", "xyz.jpenilla.minimotd.common")
    commonRelocation("io.leangen.geantyref")
    commonRelocation("net.kyori")
    commonRelocation("org.bstats")
  }
  runWaterfall {
-    waterfallVersion("1.20")
+    waterfallVersion("1.21")
  }
  processResources {
    val props = mapOf(
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -26,7 +26,7 @@ package xyz.jpenilla.minimotd.bungee;
 import net.kyori.adventure.audience.Audience;
 import net.md_5.bungee.api.CommandSender;
 import net.md_5.bungee.api.plugin.Command;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.CommandHandler;

 import static net.kyori.adventure.text.Component.text;
@@ -34,10 +34,10 @@ import static net.kyori.adventure.text.event.ClickEvent.runCommand;
 import static net.kyori.adventure.text.format.NamedTextColor.RED;

 final class BungeeCommand extends Command {
-  private final MiniMOTDPlugin plugin;
+  private final MiniMOTDBungee plugin;
  private final CommandHandler handler;

-  BungeeCommand(final @NonNull MiniMOTDPlugin plugin) {
+  BungeeCommand(final @NonNull MiniMOTDBungee plugin) {
    super("minimotd");
    this.plugin = plugin;
    this.handler = new CommandHandler(plugin.miniMOTD());
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -33,8 +33,8 @@ import net.md_5.bungee.api.Favicon;
 import net.md_5.bungee.api.ProxyServer;
 import net.md_5.bungee.api.plugin.Plugin;
 import org.bstats.bungeecord.Metrics;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
@@ -43,7 +43,7 @@ import xyz.jpenilla.minimotd.common.PingResponse;
 import xyz.jpenilla.minimotd.common.config.MOTDConfig;
 import xyz.jpenilla.minimotd.common.util.UpdateChecker;

-public final class MiniMOTDPlugin extends Plugin implements MiniMOTDPlatform<Favicon> {
+public final class MiniMOTDBungee extends Plugin implements MiniMOTDPlatform<Favicon> {
  private Logger logger;
  private BungeeAudiences audiences;
  private MiniMOTD<Favicon> miniMOTD;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -31,7 +31,7 @@ import net.md_5.bungee.api.chat.TextComponent;
 import net.md_5.bungee.api.event.ProxyPingEvent;
 import net.md_5.bungee.api.plugin.Listener;
 import net.md_5.bungee.event.EventHandler;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import xyz.jpenilla.minimotd.common.Constants;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.PingResponse;
@@ -1,5 +1,5 @@
 name: MiniMOTD
-main: xyz.jpenilla.minimotd.bungee.MiniMOTDPlugin
+main: xyz.jpenilla.minimotd.bungee.MiniMOTDBungee
 version: $version
 author: jmp
 description: $description
@@ -1,44 +1,44 @@
+import me.modmuss50.mpp.platforms.modrinth.ModrinthEnvironment
+
 plugins {
-  id("quiet-fabric-loom")
+  id("xyz.jpenilla.quiet-fabric-loom")
  id("minimotd.platform-conventions")
-  id("io.github.goooler.shadow")
+  id("com.gradleup.shadow")
 }

 val shade: Configuration by configurations.creating

 dependencies {
  minecraft(libs.minecraft)
-  mappings(loom.officialMojangMappings())
-  modImplementation(libs.fabricLoader)
-  modImplementation(libs.fabricApi)
+  implementation(libs.fabricLoader)
+  implementation(libs.fabricApi)

  shade(implementation(projects.minimotdCommon) {
    exclude("net.kyori")
+    exclude("com.google.errorprone")
  })

-  modImplementation(libs.adventurePlatformFabric)
+  implementation(libs.adventurePlatformFabric)
  include(libs.adventurePlatformFabric)
 }

 miniMOTDPlatform {
-  jarTask.set(tasks.remapJar)
+  jarTask.set(tasks.shadowJar)
 }

 indra {
  javaVersions {
-    target(21)
+    target(25)
  }
 }

 tasks {
  shadowJar {
+    archiveFileName.set("${project.name}-mc$minecraftVersion-${project.version}.jar")
    configurations = listOf(shade)
    commonConfiguration()
    commonRelocation("io.leangen.geantyref")
  }
-  remapJar {
-    archiveFileName.set("${project.name}-mc$minecraftVersion-${project.version}.jar")
-  }
  processResources {
    val replacements = mapOf(
      "modid" to project.name,
@@ -55,6 +55,8 @@ tasks {
 }

 publishMods.modrinth {
+  environment = ModrinthEnvironment.DEDICATED_SERVER_ONLY
  modLoaders.add("fabric")
  minecraftVersions.addAll(minecraftVersion)
+  optional("miniplaceholders")
 }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -34,21 +34,21 @@ import net.fabricmc.api.ModInitializer;
 import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
 import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
 import net.fabricmc.loader.api.FabricLoader;
-import net.kyori.adventure.platform.fabric.FabricServerAudiences;
+import net.kyori.adventure.platform.modcommon.MinecraftServerAudiences;
 import net.minecraft.commands.CommandSourceStack;
+import net.minecraft.commands.Commands;
 import net.minecraft.network.protocol.status.ServerStatus;
 import net.minecraft.server.MinecraftServer;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import xyz.jpenilla.minimotd.common.CommandHandler;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.MiniMOTDPlatform;
+import xyz.jpenilla.minimotd.common.util.BrigadierUtil;
 import xyz.jpenilla.minimotd.common.util.UpdateChecker;
 import xyz.jpenilla.minimotd.fabric.access.ServerStatusFaviconAccess;

-import static net.minecraft.commands.Commands.literal;
-
 public final class MiniMOTDFabric implements ModInitializer, MiniMOTDPlatform<ServerStatus.Favicon> {
  private static MiniMOTDFabric instance = null;

@@ -57,7 +57,7 @@ public final class MiniMOTDFabric implements ModInitializer, MiniMOTDPlatform<Se
  private final MiniMOTD<ServerStatus.Favicon> miniMOTD = new MiniMOTD<>(this);

  private MinecraftServer server;
-  private FabricServerAudiences audiences;
+  private MinecraftServerAudiences audiences;

  public MiniMOTDFabric() {
    if (instance != null) {
@@ -75,7 +75,7 @@ public final class MiniMOTDFabric implements ModInitializer, MiniMOTDPlatform<Se
    this.registerCommand();
    ServerLifecycleEvents.SERVER_STARTING.register(minecraftServer -> {
      this.server = minecraftServer;
-      this.audiences = FabricServerAudiences.of(minecraftServer);
+      this.audiences = MinecraftServerAudiences.of(minecraftServer);
    });
    ServerLifecycleEvents.SERVER_STARTED.register(minecraftServer -> {
      if (this.miniMOTD.configManager().pluginSettings().updateChecker()) {
@@ -104,17 +104,16 @@ public final class MiniMOTDFabric implements ModInitializer, MiniMOTDPlatform<Se
      }
    }

-    final CommandHandler handler = new CommandHandler(this.miniMOTD);
    CommandRegistrationCallback.EVENT.register((dispatcher, commandBuildContext, commandSelection) -> dispatcher.register(
-      literal("minimotd")
-        .requires(source -> source.hasPermission(4))
-        .then(literal("reload").executes(new WrappingExecutor(handler::reload)))
-        .then(literal("about").executes(new WrappingExecutor(handler::about)))
-        .then(literal("help").executes(new WrappingExecutor(handler::help)))
+      BrigadierUtil.buildTree(
+        new CommandHandler(this.miniMOTD),
+        sourceStack -> this.audiences().audience(sourceStack),
+        Commands.hasPermission(Commands.LEVEL_ADMINS)
+      )
    ));
  }

-  public @NonNull FabricServerAudiences audiences() {
+  public @NonNull MinecraftServerAudiences audiences() {
    return this.audiences;
  }

@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -23,7 +23,7 @@
 */
 package xyz.jpenilla.minimotd.fabric.access;

-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.Nullable;

 public interface ServerStatusFaviconAccess {
  @Nullable String cachedEncodedIcon();
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -28,7 +28,7 @@ import com.mojang.serialization.DataResult;
 import com.mojang.serialization.codecs.PrimitiveCodec;
 import java.util.function.Function;
 import net.minecraft.network.protocol.status.ServerStatus;
-import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jspecify.annotations.Nullable;
 import org.spongepowered.asm.mixin.Mixin;
 import org.spongepowered.asm.mixin.Unique;
 import org.spongepowered.asm.mixin.injection.At;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -69,9 +69,9 @@ abstract class ServerStatusPacketListenerImplMixin {
    final MutableServerStatus modifiedStatus = new MutableServerStatus(vanillaStatus);
    response.motd(motd -> {
      if (((ConnectionAccess) this.connection).protocolVersion() >= Constants.MINECRAFT_1_16_PROTOCOL_VERSION) {
-        modifiedStatus.description(miniMOTDFabric.audiences().toNative(motd));
+        modifiedStatus.description(miniMOTDFabric.audiences().asNative(motd));
      } else {
-        modifiedStatus.description(miniMOTDFabric.audiences().toNative(ComponentColorDownsampler.downsampler().downsample(motd)));
+        modifiedStatus.description(miniMOTDFabric.audiences().asNative(ComponentColorDownsampler.downsampler().downsample(motd)));
      }
    });
    response.icon(favicon -> modifiedStatus.favicon(Optional.of(favicon)));
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -27,11 +27,10 @@ import java.util.Objects;
 import java.util.Optional;
 import net.minecraft.network.chat.Component;
 import net.minecraft.network.protocol.status.ServerStatus;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;

@SuppressWarnings({"OptionalUsedAsFieldOrParameterType", "unused"})
-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class MutableServerStatus {
  private Component description;
  private Optional<ServerStatus.Players> players;
@@ -23,8 +23,9 @@
    "minimotd-fabric.mixins.json"
  ],
  "depends": {
-    "fabricloader": ">=0.15.10",
-    "fabric": "*",
-    "minecraft": "~1.20.5"
+    "fabricloader": ">=0.19.5",
+    "fabric-api": "*",
+    "minecraft": ">=26.3",
+    "adventure-platform-fabric": "*"
  }
 }
@@ -2,7 +2,7 @@
  "required": true,
  "minVersion": "0.8.4",
  "package": "xyz.jpenilla.minimotd.fabric.mixin",
-  "compatibilityLevel": "JAVA_16",
+  "compatibilityLevel": "JAVA_21",
  "mixins": [
    "ConnectionMixin",
    "ServerHandshakePacketListenerImplMixin",
@@ -0,0 +1,68 @@
+import me.modmuss50.mpp.platforms.modrinth.ModrinthEnvironment
+
+plugins {
+  id("net.neoforged.moddev")
+  id("minimotd.platform-conventions")
+  id("com.gradleup.shadow")
+}
+
+neoForge {
+  enable {
+    version = libs.versions.neoforge.get()
+  }
+}
+
+val shade: Configuration by configurations.creating
+
+dependencies {
+  shade(implementation(projects.minimotdCommon) {
+    exclude("net.kyori")
+    exclude("com.google.errorprone")
+  })
+
+  implementation(libs.adventurePlatformNeoforge)
+  jarJar(libs.adventurePlatformNeoforge)
+}
+
+indra {
+  javaVersions {
+    target(25)
+  }
+}
+
+tasks {
+  shadowJar {
+    configurations = listOf(shade)
+    commonConfiguration()
+    commonRelocation("io.leangen.geantyref")
+  }
+  processResources {
+    val replacements = mapOf(
+      "version" to project.version.toString(),
+      "description" to project.description.toString(),
+      "github_url" to Constants.GITHUB_URL
+    )
+    inputs.properties(replacements)
+    filesMatching("META-INF/neoforge.mods.toml") {
+      expand(replacements)
+    }
+  }
+}
+
+val productionJar = tasks.register<Zip>("productionJar") {
+  archiveFileName = "${project.name}-mc$minecraftVersion-${project.version}.jar"
+  destinationDirectory = layout.buildDirectory.dir("libs")
+  from(zipTree(tasks.shadowJar.flatMap { it.archiveFile }))
+  from(tasks.jarJar.flatMap { it.outputDirectory })
+}
+
+miniMOTDPlatform {
+  jarTask.set(productionJar)
+}
+
+publishMods.modrinth {
+  environment = ModrinthEnvironment.DEDICATED_SERVER_ONLY
+  modLoaders.add("neoforge")
+  minecraftVersions.addAll(minecraftVersion)
+  optional("miniplaceholders")
+}
@@ -0,0 +1,134 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge;
+
+import java.awt.image.BufferedImage;
+import java.io.ByteArrayOutputStream;
+import java.nio.file.Path;
+import java.util.concurrent.CompletableFuture;
+import javax.imageio.ImageIO;
+import net.kyori.adventure.platform.modcommon.MinecraftServerAudiences;
+import net.minecraft.commands.Commands;
+import net.minecraft.network.protocol.status.ServerStatus;
+import net.minecraft.server.MinecraftServer;
+import net.neoforged.fml.common.Mod;
+import net.neoforged.neoforge.common.NeoForge;
+import net.neoforged.neoforge.event.RegisterCommandsEvent;
+import net.neoforged.neoforge.event.server.ServerStartedEvent;
+import net.neoforged.neoforge.event.server.ServerStartingEvent;
+import net.neoforged.neoforge.event.server.ServerStoppedEvent;
+import org.jspecify.annotations.NonNull;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import xyz.jpenilla.minimotd.common.CommandHandler;
+import xyz.jpenilla.minimotd.common.MiniMOTD;
+import xyz.jpenilla.minimotd.common.MiniMOTDPlatform;
+import xyz.jpenilla.minimotd.common.util.BrigadierUtil;
+import xyz.jpenilla.minimotd.common.util.UpdateChecker;
+import xyz.jpenilla.minimotd.neoforge.access.ServerStatusFaviconAccess;
+
+@Mod("minimotd")
+public final class MiniMOTDNeoForge implements MiniMOTDPlatform<ServerStatus.Favicon> {
+  private static MiniMOTDNeoForge instance = null;
+
+  private final Logger logger = LoggerFactory.getLogger(MiniMOTD.class);
+  private final Path dataDirectory = Path.of("config", "MiniMOTD");
+  private final MiniMOTD<ServerStatus.Favicon> miniMOTD = new MiniMOTD<>(this);
+
+  private MinecraftServer server;
+  private MinecraftServerAudiences audiences;
+
+  public MiniMOTDNeoForge() {
+    if (instance != null) {
+      throw new IllegalStateException("Cannot create a second instance of " + this.getClass().getName());
+    }
+    instance = this;
+
+    this.registerCommand();
+    NeoForge.EVENT_BUS.addListener((ServerStartingEvent event) -> {
+      this.server = event.getServer();
+      this.audiences = MinecraftServerAudiences.of(event.getServer());
+    });
+    NeoForge.EVENT_BUS.addListener((ServerStartedEvent event) -> {
+      if (this.miniMOTD.configManager().pluginSettings().updateChecker()) {
+        CompletableFuture.runAsync(() -> new UpdateChecker().checkVersion().forEach(this.logger()::info));
+      }
+    });
+    NeoForge.EVENT_BUS.addListener((ServerStoppedEvent event) -> {
+      this.server = null;
+      this.audiences = null;
+    });
+    this.miniMOTD.logger().info("Done initializing MiniMOTD");
+  }
+
+  public @NonNull MiniMOTD<ServerStatus.Favicon> miniMOTD() {
+    return this.miniMOTD;
+  }
+
+  private void registerCommand() {
+    NeoForge.EVENT_BUS.addListener((RegisterCommandsEvent event) -> {
+      event.getDispatcher().register(
+        BrigadierUtil.buildTree(
+          new CommandHandler(this.miniMOTD),
+          sourceStack -> this.audiences().audience(sourceStack),
+          Commands.hasPermission(Commands.LEVEL_ADMINS)
+        )
+      );
+    });
+  }
+
+  public @NonNull MinecraftServerAudiences audiences() {
+    return this.audiences;
+  }
+
+  public static @NonNull MiniMOTDNeoForge get() {
+    return instance;
+  }
+
+  public @NonNull MinecraftServer requireServer() {
+    if (this.server == null) {
+      throw new IllegalStateException("Server requested before started");
+    }
+    return this.server;
+  }
+
+  @Override
+  public @NonNull Path dataDirectory() {
+    return this.dataDirectory;
+  }
+
+  @Override
+  public @NonNull Logger logger() {
+    return this.logger;
+  }
+
+  @Override
+  public ServerStatus.@NonNull Favicon loadIcon(final @NonNull BufferedImage bufferedImage) throws Exception {
+    final ByteArrayOutputStream out = new ByteArrayOutputStream();
+    ImageIO.write(bufferedImage, "PNG", out);
+    final ServerStatus.Favicon favicon = new ServerStatus.Favicon(out.toByteArray());
+    ((ServerStatusFaviconAccess) (Object) favicon).cacheEncodedIcon();
+    return favicon;
+  }
+}
@@ -0,0 +1,30 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.access;
+
+public interface ConnectionAccess {
+  void protocolVersion(int protocolVersion);
+
+  int protocolVersion();
+}
@@ -0,0 +1,32 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.access;
+
+import org.jspecify.annotations.Nullable;
+
+public interface ServerStatusFaviconAccess {
+  @Nullable String cachedEncodedIcon();
+
+  void cacheEncodedIcon();
+}
@@ -0,0 +1,46 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.mixin;
+
+import net.minecraft.network.Connection;
+import org.spongepowered.asm.mixin.Implements;
+import org.spongepowered.asm.mixin.Interface;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Unique;
+import xyz.jpenilla.minimotd.neoforge.access.ConnectionAccess;
+
+@Unique
+@Mixin(Connection.class)
+@Implements({@Interface(iface = ConnectionAccess.class, prefix = "miniMOTD$")})
+abstract class ConnectionMixin {
+  private int miniMOTD$protocolVersion = -1;
+
+  public void miniMOTD$protocolVersion(final int protocolVersion) {
+    this.miniMOTD$protocolVersion = protocolVersion;
+  }
+
+  public int miniMOTD$protocolVersion() {
+    return this.miniMOTD$protocolVersion;
+  }
+}
@@ -0,0 +1,45 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.mixin;
+
+import net.minecraft.network.Connection;
+import net.minecraft.network.protocol.handshake.ClientIntentionPacket;
+import net.minecraft.server.network.ServerHandshakePacketListenerImpl;
+import org.spongepowered.asm.mixin.Final;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Shadow;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+import xyz.jpenilla.minimotd.neoforge.access.ConnectionAccess;
+
+@Mixin(ServerHandshakePacketListenerImpl.class)
+abstract class ServerHandshakePacketListenerImplMixin {
+  @Shadow @Final private Connection connection;
+
+  @Inject(method = "handleIntention", at = @At("HEAD"))
+  public void injectHandleIntention(final ClientIntentionPacket packet, final CallbackInfo ci) {
+    ((ConnectionAccess) this.connection).protocolVersion(packet.protocolVersion());
+  }
+}
@@ -0,0 +1,78 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.mixin;
+
+import com.mojang.serialization.Codec;
+import com.mojang.serialization.DataResult;
+import com.mojang.serialization.codecs.PrimitiveCodec;
+import java.util.function.Function;
+import net.minecraft.network.protocol.status.ServerStatus;
+import org.jspecify.annotations.Nullable;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Unique;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Redirect;
+import xyz.jpenilla.minimotd.neoforge.access.ServerStatusFaviconAccess;
+
+@Mixin(ServerStatus.Favicon.class)
+abstract class ServerStatusFaviconMixin implements ServerStatusFaviconAccess {
+  @Unique
+  private static Function<ServerStatus.Favicon, String> VANILLA_ENCODE_TO_STRING;
+
+  @Redirect(
+    method = "<clinit>",
+    at = @At(
+      target = "Lcom/mojang/serialization/codecs/PrimitiveCodec;comapFlatMap(Ljava/util/function/Function;Ljava/util/function/Function;)Lcom/mojang/serialization/Codec;",
+      value = "INVOKE"
+    ),
+    remap = false
+  )
+  private static Codec<ServerStatus.Favicon> makeCodec(
+    final PrimitiveCodec<String> stringCodec,
+    final Function<String, DataResult<ServerStatus.Favicon>> decode,
+    final Function<ServerStatus.Favicon, String> encode
+  ) {
+    VANILLA_ENCODE_TO_STRING = encode;
+    return stringCodec.comapFlatMap(decode, favicon -> {
+      final @Nullable String encodedIcon = ((ServerStatusFaviconAccess) (Object) favicon).cachedEncodedIcon();
+      if (encodedIcon != null) {
+        return encodedIcon;
+      }
+      return encode.apply(favicon);
+    });
+  }
+
+  @Unique
+  private String encodedIcon;
+
+  @Override
+  public @Nullable String cachedEncodedIcon() {
+    return this.encodedIcon;
+  }
+
+  @Override
+  public void cacheEncodedIcon() {
+    this.encodedIcon = VANILLA_ENCODE_TO_STRING.apply((ServerStatus.Favicon) (Object) this);
+  }
+}
@@ -0,0 +1,94 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.mixin;
+
+import java.util.Collections;
+import java.util.Objects;
+import java.util.Optional;
+import net.minecraft.network.Connection;
+import net.minecraft.network.protocol.status.ServerStatus;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.network.ServerStatusPacketListenerImpl;
+import org.spongepowered.asm.mixin.Final;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Shadow;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Redirect;
+import xyz.jpenilla.minimotd.common.Constants;
+import xyz.jpenilla.minimotd.common.MiniMOTD;
+import xyz.jpenilla.minimotd.common.PingResponse;
+import xyz.jpenilla.minimotd.common.config.MOTDConfig;
+import xyz.jpenilla.minimotd.common.util.ComponentColorDownsampler;
+import xyz.jpenilla.minimotd.neoforge.MiniMOTDNeoForge;
+import xyz.jpenilla.minimotd.neoforge.access.ConnectionAccess;
+import xyz.jpenilla.minimotd.neoforge.util.MutableServerStatus;
+
+@Mixin(ServerStatusPacketListenerImpl.class)
+abstract class ServerStatusPacketListenerImplMixin {
+  @Shadow @Final private Connection connection;
+
+  @Redirect(
+    method = "handleStatusRequest",
+    at = @At(value = "FIELD", target = "Lnet/minecraft/server/network/ServerStatusPacketListenerImpl;status:Lnet/minecraft/network/protocol/status/ServerStatus;")
+  )
+  public ServerStatus injectHandleStatusRequest(final ServerStatusPacketListenerImpl instance) {
+    final MiniMOTDNeoForge miniMOTDNeoForge = MiniMOTDNeoForge.get();
+    final MinecraftServer minecraftServer = miniMOTDNeoForge.requireServer();
+    final ServerStatus vanillaStatus = Objects.requireNonNull(minecraftServer.getStatus(), "vanillaStatus");
+
+    final MiniMOTD<ServerStatus.Favicon> miniMOTD = miniMOTDNeoForge.miniMOTD();
+    final MOTDConfig config = miniMOTD.configManager().mainConfig();
+
+    final PingResponse<ServerStatus.Favicon> response = miniMOTD.createMOTD(
+      config,
+      minecraftServer.getPlayerCount(),
+      vanillaStatus.players().map(ServerStatus.Players::max).orElseGet(minecraftServer::getMaxPlayers)
+    );
+
+    final MutableServerStatus modifiedStatus = new MutableServerStatus(vanillaStatus);
+    response.motd(motd -> {
+      if (((ConnectionAccess) this.connection).protocolVersion() >= Constants.MINECRAFT_1_16_PROTOCOL_VERSION) {
+        modifiedStatus.description(miniMOTDNeoForge.audiences().asNative(motd));
+      } else {
+        modifiedStatus.description(miniMOTDNeoForge.audiences().asNative(ComponentColorDownsampler.downsampler().downsample(motd)));
+      }
+    });
+    response.icon(favicon -> modifiedStatus.favicon(Optional.of(favicon)));
+
+    if (response.hidePlayerCount()) {
+      modifiedStatus.players(Optional.empty());
+    } else {
+      final ServerStatus.Players newPlayers = new ServerStatus.Players(
+        response.playerCount().maxPlayers(),
+        response.playerCount().onlinePlayers(),
+        response.disablePlayerListHover()
+          ? Collections.emptyList()
+          : vanillaStatus.players().map(ServerStatus.Players::sample).orElse(Collections.emptyList())
+      );
+      modifiedStatus.players(Optional.of(newPlayers));
+    }
+
+    return modifiedStatus.toServerStatus();
+  }
+}
@@ -0,0 +1,98 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.neoforge.util;
+
+import java.util.Objects;
+import java.util.Optional;
+import net.minecraft.network.chat.Component;
+import net.minecraft.network.protocol.status.ServerStatus;
+import org.jspecify.annotations.NullMarked;
+
+@SuppressWarnings({"OptionalUsedAsFieldOrParameterType", "unused"})
+@NullMarked
+public final class MutableServerStatus {
+  private Component description;
+  private Optional<ServerStatus.Players> players;
+  private Optional<ServerStatus.Version> version;
+  private Optional<ServerStatus.Favicon> favicon;
+  private boolean enforcesSecureChat;
+  private boolean isModded; // NeoForge addition
+
+  public MutableServerStatus(final ServerStatus status) {
+    this.description = status.description();
+    this.players = status.players();
+    this.version = status.version();
+    this.favicon = status.favicon();
+    this.enforcesSecureChat = status.enforcesSecureChat();
+    this.isModded = status.isModded(); // NeoForge addition
+  }
+
+  public ServerStatus toServerStatus() {
+    return new ServerStatus(this.description, this.players, this.version, this.favicon, this.enforcesSecureChat, this.isModded);
+  }
+
+  public Component description() {
+    return this.description;
+  }
+
+  public void description(final Component description) {
+    Objects.requireNonNull(description, "description");
+    this.description = description;
+  }
+
+  public Optional<ServerStatus.Players> players() {
+    return this.players;
+  }
+
+  public void players(final Optional<ServerStatus.Players> players) {
+    Objects.requireNonNull(players, "players");
+    this.players = players;
+  }
+
+  public Optional<ServerStatus.Version> version() {
+    return this.version;
+  }
+
+  public void version(final Optional<ServerStatus.Version> version) {
+    Objects.requireNonNull(version, "version");
+    this.version = version;
+  }
+
+  public Optional<ServerStatus.Favicon> favicon() {
+    return this.favicon;
+  }
+
+  public void favicon(final Optional<ServerStatus.Favicon> favicon) {
+    Objects.requireNonNull(favicon, "favicon");
+    this.favicon = favicon;
+  }
+
+  public boolean enforcesSecureChat() {
+    return this.enforcesSecureChat;
+  }
+
+  public void enforcesSecureChat(final boolean enforcesSecureChat) {
+    this.enforcesSecureChat = enforcesSecureChat;
+  }
+}
@@ -0,0 +1,38 @@
+modLoader = "javafml"
+loaderVersion = "[1,)"
+license = "MIT"
+issueTrackerURL = "${github_url}/issues/"
+showAsResourcePack = false
+
+[[mods]]
+modId = "minimotd"
+version = "${version}"
+displayName = "MiniMOTD"
+displayURL = "${github_url}"
+authors = "jmp"
+description = "${description}"
+displayTest = "IGNORE_ALL_VERSION"
+
+[[dependencies.minimotd]]
+modId = "neoforge"
+type = "required"
+versionRange = "[21.0,)"
+ordering = "NONE"
+side = "BOTH"
+
+[[dependencies.minimotd]]
+modId = "minecraft"
+type = "required"
+versionRange = "[26.3,)"
+ordering = "NONE"
+side = "BOTH"
+
+[[dependencies.minimotd]]
+modId = "adventure_platform_neoforge"
+type = "required"
+versionRange = "*"
+ordering = "AFTER"
+side = "BOTH"
+
+[[mixins]]
+config = "minimotd-neoforge.mixins.json"
@@ -0,0 +1,17 @@
+{
+  "required": true,
+  "minVersion": "0.8.4",
+  "package": "xyz.jpenilla.minimotd.neoforge.mixin",
+  "compatibilityLevel": "JAVA_21",
+  "mixins": [
+    "ConnectionMixin",
+    "ServerHandshakePacketListenerImplMixin",
+    "ServerStatusFaviconMixin",
+    "ServerStatusPacketListenerImplMixin"
+  ],
+  "client": [
+  ],
+  "injectors": {
+    "defaultRequire": 1
+  }
+}
@@ -0,0 +1,64 @@
+import xyz.jpenilla.resourcefactory.paper.PaperPluginYaml.Load
+
+plugins {
+  id("minimotd.shadow-platform")
+  alias(libs.plugins.run.paper)
+  alias(libs.plugins.resource.factory.bukkit)
+  alias(libs.plugins.resource.factory.paper)
+}
+
+dependencies {
+  implementation(projects.minimotdCommon)
+  implementation(libs.bstatsBukkit)
+  compileOnly(libs.paperApi)
+}
+
+tasks {
+  runServer {
+    minecraftVersion(minecraftVersion)
+  }
+  shadowJar {
+    configureForNativeAdventurePlatform()
+    commonRelocation("org.bstats")
+    dependencies {
+      exclude(dependency("io.leangen.geantyref:geantyref"))
+    }
+  }
+}
+
+indra {
+  javaVersions {
+    target(21)
+  }
+}
+
+bukkitPluginYaml {
+  name = "MiniMOTD"
+  main = "xyz.jpenilla.minimotd.paper.MiniMOTDStub"
+  foliaSupported = true
+  authors = listOf("jmp")
+  website = Constants.GITHUB_URL
+  apiVersion = "1.13"
+}
+
+paperPluginYaml {
+  name = "MiniMOTD"
+  main = "xyz.jpenilla.minimotd.paper.MiniMOTDPaper"
+  foliaSupported = true
+  authors = listOf("jmp")
+  website = Constants.GITHUB_URL
+  apiVersion = "1.21.8"
+  dependencies.server.register("MiniPlaceholders") {
+    required = false
+    load = Load.BEFORE
+    joinClasspath = true
+  }
+}
+
+runPaper.folia.registerTask()
+
+publishMods.modrinth {
+  modLoaders.addAll("paper", "folia")
+  minecraftVersions = paperVersions
+  optional("miniplaceholders")
+}
@@ -0,0 +1,100 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.paper;
+
+import io.papermc.paper.command.brigadier.CommandSourceStack;
+import io.papermc.paper.plugin.lifecycle.event.types.LifecycleEvents;
+import io.papermc.paper.threadedregions.RegionizedServerInitEvent;
+import java.awt.image.BufferedImage;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.Objects;
+import java.util.concurrent.CompletableFuture;
+import org.bstats.bukkit.Metrics;
+import org.bstats.charts.SimplePie;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.bukkit.util.CachedServerIcon;
+import org.jspecify.annotations.NonNull;
+import org.slf4j.Logger;
+import xyz.jpenilla.minimotd.common.CommandHandler;
+import xyz.jpenilla.minimotd.common.MiniMOTD;
+import xyz.jpenilla.minimotd.common.MiniMOTDPlatform;
+import xyz.jpenilla.minimotd.common.util.BrigadierUtil;
+import xyz.jpenilla.minimotd.common.util.UpdateChecker;
+
+public final class MiniMOTDPaper extends JavaPlugin implements MiniMOTDPlatform<CachedServerIcon>, Listener {
+
+  private MiniMOTD<CachedServerIcon> miniMOTD;
+
+  @Override
+  public void onEnable() {
+    this.miniMOTD = new MiniMOTD<>(this);
+
+    this.getServer().getPluginManager().registerEvents(this, this);
+    this.getServer().getPluginManager().registerEvents(new PingListener(this.miniMOTD), this);
+
+    this.getLifecycleManager().registerEventHandler(LifecycleEvents.COMMANDS, event -> event.registrar().register(
+      this.getPluginMeta(),
+      BrigadierUtil.<CommandSourceStack>buildTree(
+        new CommandHandler(this.miniMOTD),
+        sourceStack -> Objects.requireNonNullElse(sourceStack.getExecutor(), sourceStack.getSender()),
+        sourceStack -> sourceStack.getSender().hasPermission("minimotd.admin")
+      ).build(),
+      "MiniMOTD Command",
+      List.of()
+    ));
+
+    final Metrics metrics = new Metrics(this, 8132);
+    metrics.addCustomChart(new SimplePie("variant", () -> "paper"));
+  }
+
+  @EventHandler
+  public void updateCheck(final RegionizedServerInitEvent event) {
+    if (!this.miniMOTD.configManager().pluginSettings().updateChecker()) {
+      return;
+    }
+    CompletableFuture.runAsync(() -> new UpdateChecker().checkVersion().forEach(this.getComponentLogger()::info)).whenComplete(($, thr) -> {
+      if (thr != null) {
+        this.getComponentLogger().warn("Exception checking for updates", thr);
+      }
+    });
+  }
+
+  @Override
+  public @NonNull Path dataDirectory() {
+    return this.getDataFolder().toPath();
+  }
+
+  @Override
+  public @NonNull Logger logger() {
+    return this.getComponentLogger();
+  }
+
+  @Override
+  public @NonNull CachedServerIcon loadIcon(final @NonNull BufferedImage image) throws Exception {
+    return this.getServer().loadServerIcon(image);
+  }
+}
@@ -0,0 +1,72 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.paper;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.plugin.java.JavaPlugin;
+import xyz.jpenilla.minimotd.common.util.Nag;
+
+public final class MiniMOTDStub extends JavaPlugin {
+  @Override
+  public void onEnable() {
+    if (lavaChicken() && !Bukkit.getBukkitVersion().contains("1.21.7-")) {
+      // 1.21.8+, non-Paper
+      new Nag.JavaUtilLogging(this.getLogger()).lines(
+        "MiniMOTD does not support Spigot on Minecraft 1.21.8 or newer.",
+        "To continue using MiniMOTD on the latest Minecraft versions,",
+        "switch to Paper (https://papermc.io/software/paper)."
+      ).error(true).logBanner();
+      this.getServer().getPluginManager().disablePlugin(this);
+      return;
+    }
+
+    // Pre-Paper-plugins or non-Paper
+    new Nag.JavaUtilLogging(this.getLogger()).lines(
+      "You are using the incorrect MiniMOTD build for your server software.",
+      "This build is for Paper 1.21.8+.",
+      "Builds for Spigot/Paper 1.8.8 through 1.21.7 are available on Modrinth (https://modrinth.com/plugin/minimotd).",
+      "When downloading be sure to check the supported versions/platforms",
+      "field on the versions page, and/or make the correct selections in",
+      "the download menu."
+    ).error(true).logBanner();
+    this.getServer().getPluginManager().disablePlugin(this);
+
+    // Sadly I don't think there is any way to display a custom message for servers that support
+    // Paper plugins but are < 1.21.8 (without lying in the plugin yaml)...
+    // Hopefully users will realize they need to try a different build.
+  }
+
+  // Crude 1.21.7+ check
+  private static boolean lavaChicken() {
+    try {
+      final Material mat = Material.MUSIC_DISC_LAVA_CHICKEN;
+      new ItemStack(mat);
+      return true;
+    } catch (final Throwable thr) {
+      return false;
+    }
+  }
+}
@@ -0,0 +1,67 @@
+/*
+ * This file is part of MiniMOTD, licensed under the MIT License.
+ *
+ * Copyright (c) 2020-2025 Jason Penilla
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package xyz.jpenilla.minimotd.paper;
+
+import com.destroystokyo.paper.event.server.PaperServerListPingEvent;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.util.CachedServerIcon;
+import org.jspecify.annotations.NonNull;
+import xyz.jpenilla.minimotd.common.Constants;
+import xyz.jpenilla.minimotd.common.MiniMOTD;
+import xyz.jpenilla.minimotd.common.PingResponse;
+import xyz.jpenilla.minimotd.common.config.MOTDConfig;
+import xyz.jpenilla.minimotd.common.util.ComponentColorDownsampler;
+
+public final class PingListener implements Listener {
+  private final MiniMOTD<CachedServerIcon> miniMOTD;
+
+  PingListener(final @NonNull MiniMOTD<CachedServerIcon> miniMOTD) {
+    this.miniMOTD = miniMOTD;
+  }
+
+  @EventHandler
+  public void handlePing(final @NonNull PaperServerListPingEvent event) {
+    final MOTDConfig cfg = this.miniMOTD.configManager().mainConfig();
+
+    final PingResponse<CachedServerIcon> response = this.miniMOTD.createMOTD(cfg, event.getNumPlayers(), event.getMaxPlayers());
+
+    response.playerCount().applyCount(event::setNumPlayers, event::setMaxPlayers);
+    response.motd(motd -> {
+      if (event.getClient().getProtocolVersion() < Constants.MINECRAFT_1_16_PROTOCOL_VERSION) {
+        event.motd(ComponentColorDownsampler.downsampler().downsample(motd));
+      } else {
+        event.motd(motd);
+      }
+    });
+    response.icon(event::setServerIcon);
+
+    if (response.disablePlayerListHover()) {
+      event.getListedPlayers().clear();
+    }
+    if (response.hidePlayerCount()) {
+      event.setHidePlayers(true);
+    }
+  }
+}
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@ package xyz.jpenilla.minimotd.sponge7;

 import com.google.inject.Inject;
 import net.kyori.adventure.text.serializer.spongeapi.SpongeComponentSerializer;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.spongepowered.api.event.EventListener;
 import org.spongepowered.api.event.server.ClientPingServerEvent;
 import org.spongepowered.api.network.status.Favicon;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -32,7 +32,7 @@ import java.io.IOException;
 import java.nio.file.Path;
 import net.kyori.adventure.platform.spongeapi.SpongeAudiences;
 import org.bstats.sponge.Metrics;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.slf4j.Logger;
 import org.spongepowered.api.Game;
 import org.spongepowered.api.Sponge;
@@ -34,6 +34,11 @@ sponge {
      loadOrder(PluginDependency.LoadOrder.AFTER)
      optional(false)
    }
+    dependency("miniplaceholders") {
+      loadOrder(PluginDependency.LoadOrder.AFTER)
+      optional(true)
+      version = "3.0.0"
+    }
  }
 }

@@ -50,9 +55,19 @@ publishMods.modrinth {
  modLoaders.add("sponge")
  minecraftVersions.addAll(
    "1.16.5",
-    "1.17.1",
    "1.18.2",
    "1.19.4",
-    "1.20.4"
+    "1.20.6",
+    "1.21.1",
+    "1.21.3",
+    "1.21.4",
+    "1.21.5",
+    "1.21.8",
+    "1.21.10",
+    "1.21.11",
+    "26.1.2",
+    "26.2",
+    "26.3",
  )
+  optional("miniplaceholders")
 }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@ package xyz.jpenilla.minimotd.sponge8;

 import com.google.inject.Inject;
 import java.lang.reflect.Method;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.spongepowered.api.MinecraftVersion;
 import org.spongepowered.api.event.EventListener;
 import org.spongepowered.api.event.server.ClientPingServerEvent;
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -29,7 +29,7 @@ import com.google.inject.Injector;
 import com.google.inject.TypeLiteral;
 import java.awt.image.BufferedImage;
 import java.nio.file.Path;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.spongepowered.api.Sponge;
@@ -1,6 +1,7 @@
 plugins {
  id("minimotd.shadow-platform")
  alias(libs.plugins.run.velocity)
+  alias(libs.plugins.resource.factory.velocity)
 }

 dependencies {
@@ -9,7 +10,11 @@ dependencies {
  compileOnly(libs.velocityApi)
 }

-java.disableAutoTargetJvm()
+indra {
+  javaVersions {
+    target(21)
+  }
+}

 tasks {
  shadowJar {
@@ -20,20 +25,19 @@ tasks {
  runVelocity {
    velocityVersion(libs.versions.velocityApi.get())
  }
-  processResources {
-    val props = mapOf(
-      "description" to project.description as String,
-      "url" to Constants.GITHUB_URL,
-      "version" to project.version,
-    )
-    inputs.properties(props)
-    filesMatching("velocity-plugin.json") {
-      expand(props)
-    }
-  }
+}
+
+velocityPluginJson {
+  name = "MiniMOTD"
+  id = "minimotd-velocity"
+  url = Constants.GITHUB_URL
+  authors = listOf("jmp")
+  main = "xyz.jpenilla.minimotd.velocity.MiniMOTDVelocity"
+  dependency("miniplaceholders", true)
 }

 publishMods.modrinth {
  modLoaders.add("velocity")
  minecraftVersions.addAll(minecraftVersion)
+  optional("miniplaceholders")
 }
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -28,12 +28,8 @@ import com.google.inject.AbstractModule;
 import com.google.inject.Inject;
 import com.google.inject.Injector;
 import com.google.inject.TypeLiteral;
-import com.mojang.brigadier.Command;
-import com.mojang.brigadier.builder.LiteralArgumentBuilder;
-import com.mojang.brigadier.context.CommandContext;
 import com.velocitypowered.api.command.BrigadierCommand;
 import com.velocitypowered.api.command.CommandManager;
-import com.velocitypowered.api.command.CommandSource;
 import com.velocitypowered.api.event.Subscribe;
 import com.velocitypowered.api.event.proxy.ProxyInitializeEvent;
 import com.velocitypowered.api.plugin.annotation.DataDirectory;
@@ -43,14 +39,15 @@ import java.awt.image.BufferedImage;
 import java.nio.file.Path;
 import java.util.Set;
 import org.bstats.velocity.Metrics;
-import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jspecify.annotations.NonNull;
 import org.slf4j.Logger;
 import xyz.jpenilla.minimotd.common.CommandHandler;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.MiniMOTDPlatform;
+import xyz.jpenilla.minimotd.common.util.BrigadierUtil;
 import xyz.jpenilla.minimotd.common.util.UpdateChecker;

-public final class MiniMOTDPlugin implements MiniMOTDPlatform<Favicon> {
+public final class MiniMOTDVelocity implements MiniMOTDPlatform<Favicon> {
  private static final Set<Class<?>> LISTENER_CLASSES = ImmutableSet.of(
    PingListener.class
  );
@@ -64,7 +61,7 @@ public final class MiniMOTDPlugin implements MiniMOTDPlatform<Favicon> {
  private final Injector injector;

  @Inject
-  public MiniMOTDPlugin(
+  public MiniMOTDVelocity(
    final @NonNull ProxyServer server,
    final @NonNull Logger logger,
    final @NonNull CommandManager commandManager,
@@ -83,7 +80,7 @@ public final class MiniMOTDPlugin implements MiniMOTDPlatform<Favicon> {
      @Override
      protected void configure() {
        this.bind(new TypeLiteral<MiniMOTD<Favicon>>() {
-        }).toInstance(MiniMOTDPlugin.this.miniMOTD);
+        }).toInstance(MiniMOTDVelocity.this.miniMOTD);
      }
    });
  }
@@ -104,28 +101,16 @@ public final class MiniMOTDPlugin implements MiniMOTDPlatform<Favicon> {
  }

  private void registerCommand() {
-    final class WrappingExecutor implements Command<CommandSource> {
-      private final CommandHandler.Executor handler;
-
-      WrappingExecutor(final CommandHandler.@NonNull Executor handler) {
-        this.handler = handler;
-      }
-
-      @Override
-      public int run(final @NonNull CommandContext<CommandSource> context) {
-        this.handler.execute(context.getSource());
-        return Command.SINGLE_SUCCESS;
-      }
-    }
-
-    final CommandHandler handler = new CommandHandler(this.miniMOTD);
-    this.commandManager.register(this.commandManager.metaBuilder("minimotd").build(), new BrigadierCommand(
-      LiteralArgumentBuilder.<CommandSource>literal("minimotd")
-        .requires(source -> source.hasPermission("minimotd.admin"))
-        .then(LiteralArgumentBuilder.<CommandSource>literal("help").executes(new WrappingExecutor(handler::help)))
-        .then(LiteralArgumentBuilder.<CommandSource>literal("about").executes(new WrappingExecutor(handler::about)))
-        .then(LiteralArgumentBuilder.<CommandSource>literal("reload").executes(new WrappingExecutor(handler::reload)))
-    ));
+    this.commandManager.register(
+      this.commandManager.metaBuilder("minimotd").plugin(this).build(),
+      new BrigadierCommand(
+        BrigadierUtil.buildTree(
+          new CommandHandler(this.miniMOTD),
+          source -> source,
+          source -> source.hasPermission("minimotd.admin")
+        )
+      )
+    );
  }

  @Override
@@ -1,7 +1,7 @@
 /*
 * This file is part of MiniMOTD, licensed under the MIT License.
 *
- * Copyright (c) 2020-2024 Jason Penilla
+ * Copyright (c) 2020-2025 Jason Penilla
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
@@ -35,14 +35,13 @@ import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
 import java.util.stream.Collectors;
-import org.checkerframework.checker.nullness.qual.NonNull;
-import org.checkerframework.checker.nullness.qual.Nullable;
-import org.checkerframework.framework.qual.DefaultQualifier;
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 import xyz.jpenilla.minimotd.common.MiniMOTD;
 import xyz.jpenilla.minimotd.common.PingResponse;
 import xyz.jpenilla.minimotd.common.config.MOTDConfig;

-@DefaultQualifier(NonNull.class)
+@NullMarked
 public final class PingListener {
  private final MiniMOTD<Favicon> miniMOTD;
  private final ProxyServer proxy;
@@ -1,12 +0,0 @@
-{
-  "id": "minimotd-velocity",
-  "name": "MiniMOTD",
-  "version": "$version",
-  "description": "$description",
-  "url": "$url",
-  "authors": [
-    "jmp"
-  ],
-  "dependencies": [],
-  "main": "xyz.jpenilla.minimotd.velocity.MiniMOTDPlugin"
-}
@@ -1,10 +1,10 @@
 {
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
-    "config:base"
+    "config:recommended"
  ],
  "ignoreDeps": [
-    "quiet-fabric-loom",
+    "xyz.jpenilla.quiet-fabric-loom",
    "com.mojang:minecraft",
    "com.google.code.gson:gson"
  ],
@@ -14,19 +14,37 @@
  "packageRules": [
    {
      "description": "Correct Fabric API version handling",
-      "matchPackageNames": ["net.fabricmc.fabric-api:fabric-api", "net.fabricmc.fabric-api:fabric-api-deprecated"],
+      "matchPackageNames": [
+        "net.fabricmc.fabric-api:fabric-api",
+        "net.fabricmc.fabric-api:fabric-api-deprecated"
+      ],
      "versioning": "regex:^(?<major>\\d+)(\\.(?<minor>\\d+))?(\\.(?<patch>\\d+))?(?:\\+(?<compatibility>.*))?$"
    },
    {
-      "matchManagers": ["github-actions", "gradle-wrapper"],
+      "description": "Correct NeoForge version handling",
+      "matchPackageNames": [
+        "net.neoforged:neoforge"
+      ],
+      "versioning": "regex:^(?<compatibility>(?:\\d+\\.){3})(?<minor>\\d+)(?:-beta)?$"
+    },
+    {
+      "matchManagers": [
+        "github-actions",
+        "gradle-wrapper"
+      ],
      "groupName": "gradle and github actions"
    },
    {
-      "matchDepTypes": ["plugin"],
+      "matchDepTypes": [
+        "plugin"
+      ],
      "groupName": "gradle and github actions"
    },
    {
-      "matchPaths": ["build-logic/*", "buildSrc/*"],
+      "matchFileNames": [
+        "build-logic/*",
+        "buildSrc/*"
+      ],
      "groupName": "gradle and github actions"
    }
  ],
@@ -1,37 +1,21 @@
 enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")

-dependencyResolutionManagement {
-  repositories {
-    mavenCentral {
-      mavenContent { releasesOnly() }
-    }
-    maven("https://oss.sonatype.org/content/repositories/snapshots/") {
-      mavenContent { snapshotsOnly() }
-    }
-    maven("https://s01.oss.sonatype.org/content/repositories/snapshots/") {
-      mavenContent { snapshotsOnly() }
-    }
-    maven("https://repo.papermc.io/repository/maven-public/")
-    maven("https://repo.spongepowered.org/repository/maven-public/")
-    maven("https://repo.jpenilla.xyz/snapshots/") {
-      mavenContent { snapshotsOnly() }
-    }
-  }
-  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
-}
-
 pluginManagement {
  repositories {
    gradlePluginPortal()
    maven("https://maven.fabricmc.net/")
+    maven("https://maven.neoforged.net/releases/") {
+      mavenContent { releasesOnly() }
+    }
    maven("https://repo.jpenilla.xyz/snapshots/")
  }
  includeBuild("gradle/build-logic")
 }

 plugins {
-  id("quiet-fabric-loom") version "1.6-SNAPSHOT"
-  id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0"
+  id("net.neoforged.moddev.repositories") version "2.0.147" apply false
+  id("xyz.jpenilla.quiet-fabric-loom") version "1.18-SNAPSHOT" apply false
+  id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
 }

 rootProject.name = "MiniMOTD"
@@ -42,17 +26,16 @@ fun setup(name: String, dir: String) {
 }

 fun platform(name: String) = setup("minimotd-$name", "platform/$name")
-fun dist(name: String) = setup("minimotd-$name", "dist/$name")

 setup("minimotd-common", "common")

 sequenceOf(
+  "paper",
  "bukkit",
  "sponge8",
  "sponge7",
  "bungeecord",
  "velocity",
  "fabric",
+  "neoforge",
 ).forEach(::platform)
-
-dist("bukkit-bungeecord")