Version - 1.2.0 (#230)

* Deploy as 1.2.0-SNAPSHOT

* Update adventure version (#232)

* Minestom Support (#231)

* apollo minestom implementation

* minestom markdown docs

* publish minestom jar

* update javadoc version tags to 1.2.0

* Implement Minestom user metadata

* implement minestom properties & finish docs

* send the apollo version in the start server request

* add minestom to the download page

* remove unused imports

* fix update required version logic

* Remove gradle publish for the minestom branch

* Add command properties

* Convert client brands & mods metadata to be a count-based system (#233)

* Bump to 1.2.0 (#235)

---------

Co-authored-by: Golfing7 <[email protected]>

Author: ItsNature

.checkstyle/suppressions.xml

@@ -2,7 +2,7 @@
 <!DOCTYPE suppressions PUBLIC "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN" "http://checkstyle.org/dtds/suppressions_1_2.dtd">
 <suppressions>
     <!-- don't require javadocs on platform modules -->
-    <suppress files="example[\\/]bukkit[\\/](api|json|proto|common)[\\/]src[\\/]main[\\/]java[\\/].*" checks="(FilteringWriteTag|MissingJavadoc.*)"/>
+    <suppress files="example[\\/](bukkit|minestom)[\\/](api|json|proto|common)[\\/]src[\\/]main[\\/]java[\\/].*" checks="(FilteringWriteTag|MissingJavadoc.*)"/>
 
     <!-- ignore illegal import in loader -->
     <suppress files="extra[\\/]loader[\\/]src[\\/]main[\\/]java[\\/].*" checks="(IllegalImport)"/>

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -95,6 +95,7 @@ body:
           options:
               - Spigot / Bukkit
               - Folia
+              - Minestom
               - BungeeCord
               - Velocity
               - Other

.github/workflows/deploy.yml

@@ -66,3 +66,4 @@ jobs:
                     bungee/build/libs/apollo-bungee-${{ env.VERSION }}.jar
                     velocity/build/libs/apollo-velocity-${{ env.VERSION }}.jar
                     folia/build/libs/apollo-folia-${{ env.VERSION }}.jar
+                    minestom/build/libs/apollo-minestom-${{ env.VERSION }}.jar

README.md

@@ -28,6 +28,7 @@ The output jars can be found in the `build/libs` directory relative to each plat
 
 - Bukkit: `bukkit/plugin/build/libs`
 - Folia: `folia/build/libs`
+- Minestom: `minestom/build/libs`
 - BungeeCord: `bungee/build/libs`
 - Velocity: `velocity/build/libs`
 
@@ -42,7 +43,7 @@ The Apollo project is split into several modules.
 
 - **API** - The publicly available interface for developers wishing to create custom integrations with Lunar Client.
 - **Common** - The abstraction used by platform modules to reduce duplicate code and implement the protocol for Lunar Client.
-- **Bukkit, Folia, BungeeCord, Velocity** - Are modules that implement the common module for each respective platform.
+- **Bukkit, Folia, Minestom, BungeeCord, Velocity** - Are modules that implement the common module for each respective platform.
 
 Contributions can be made to Apollo by creating a pull request for improvements or fixes. For new feature ideas please consider making a 
 suggestion by creating an [issue](https://github.com/LunarClient/Apollo/issues) or joining our [discord](https://lunarclient.dev/discord).

api/build.gradle.kts

@@ -9,6 +9,7 @@ setupPlatformDependency("bukkit", "bukkitJar")
 setupPlatformDependency("bungee", "bungeeJar")
 setupPlatformDependency("velocity", "velocityJar", 17)
 setupPlatformDependency("folia", "foliaJar", 21)
+setupPlatformDependency("minestom", "minestomJar", 21)
 
 val main by sourceSets
 
@@ -29,6 +30,9 @@ dependencies {
 
     "folia"(main.output)
     "folia"(libs.folia)
+
+    "minestom"(main.output)
+    "minestom"(libs.minestom)
 }
 
 publishShadowJar()

api/src/main/java/com/lunarclient/apollo/ApolloPlatform.java

@@ -44,6 +44,14 @@ public interface ApolloPlatform {
      */
     Kind getKind();
 
+    /**
+     * Returns the platform type.
+     *
+     * @return the platform type
+     * @since 1.2.0
+     */
+    Platform getPlatform();
+
     /**
      * Returns the platform options that don't belong to a specific module.
      *
@@ -93,4 +101,18 @@ enum Kind {
         SERVER,
         PROXY
     }
+
+    /**
+     * Represents the platform type.
+     *
+     * @since 1.2.0
+     */
+    enum Platform {
+        BUKKIT,
+        FOLIA,
+        MINESTOM,
+        BUNGEE,
+        VELOCITY
+    }
+
 }

api/src/main/java/com/lunarclient/apollo/stats/ApolloStats.java

@@ -68,7 +68,7 @@ public interface ApolloStats {
     List<ApolloPluginDescription> getPlugins();
 
     /**
-     * Gets the servers platform subtype (Bukkit, BungeeCord, Velocity...).
+     * Gets the servers platform subtype (Bukkit, Folia, Minestom, BungeeCord, Velocity...).
      *
      * @return the servers platform subtype
      * @since 1.0.0

api/src/minestom/java/com/lunarclient/apollo/MinestomApollo.java

@@ -0,0 +1,102 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * 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 com.lunarclient.apollo;
+
+import com.lunarclient.apollo.common.ApolloEntity;
+import com.lunarclient.apollo.player.ApolloPlayer;
+import com.lunarclient.apollo.player.ApolloPlayerManager;
+import com.lunarclient.apollo.recipients.Recipients;
+import java.util.Collection;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+import java.util.function.Consumer;
+import java.util.stream.Collectors;
+import lombok.NonNull;
+import net.minestom.server.entity.Entity;
+import net.minestom.server.entity.Player;
+
+/**
+ * Utility class for converting objects to and from their corresponding Minestom
+ * representations with additional helper methods for easier integration.
+ *
+ * @since 1.2.0
+ */
+public final class MinestomApollo {
+
+    /**
+     * Runs a specified operation for a {@link Player}.
+     *
+     * @param player         the player
+     * @param playerConsumer the operation to be performed
+     * @since 1.2.0
+     */
+    public static void runForPlayer(@NonNull Player player, @NonNull Consumer<ApolloPlayer> playerConsumer) {
+        runForPlayer(player.getUuid(), playerConsumer);
+    }
+
+    /**
+     * Runs a specified operation for a {@link ApolloPlayer} from the provided {@link UUID}.
+     *
+     * @param playerUuid     the player
+     * @param playerConsumer the operation to be performed
+     * @since 1.2.0
+     */
+    public static void runForPlayer(@NonNull UUID playerUuid, @NonNull Consumer<ApolloPlayer> playerConsumer) {
+        Apollo.getPlayerManager().getPlayer(playerUuid).ifPresent(playerConsumer);
+    }
+
+    /**
+     * Converts a {@link Collection} of {@link Player}s to an {@link Recipients}.
+     *
+     * @param players the players
+     * @return the recipients object containing the converted ApolloPlayer objects
+     * @since 1.2.0
+     */
+    public static Recipients getRecipientsFrom(@NonNull Collection<Player> players) {
+        ApolloPlayerManager playerManager = Apollo.getPlayerManager();
+        List<ApolloPlayer> apolloPlayers = players.stream()
+            .map(player -> playerManager.getPlayer(player.getUuid()))
+            .filter(Optional::isPresent)
+            .map(Optional::get)
+            .collect(Collectors.toList());
+
+        return Recipients.of(apolloPlayers);
+    }
+
+    /**
+     * Converts a {@link Entity} to an {@link ApolloEntity} object.
+     *
+     * @param entity the entity
+     * @return the converted apollo entity object
+     * @since 1.2.0
+     */
+    public static ApolloEntity toApolloEntity(@NonNull Entity entity) {
+        return new ApolloEntity(entity.getEntityId(), entity.getUuid());
+    }
+
+    private MinestomApollo() {
+    }
+
+}

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

@@ -43,6 +43,11 @@ fun Project.setupPlatforms() {
         tasks.named("javadoc", Javadoc::class) {
             source(sourceSets.map { it.allJava })
             classpath += sourceSets.map { it.compileClasspath }.reduce { first, second -> first + second }
+
+            val javaToolchains = project.extensions.getByType(JavaToolchainService::class.java)
+            javadocTool.set(javaToolchains.javadocToolFor {
+                languageVersion.set(JavaLanguageVersion.of(21))
+            })
         }
     }
 }

bukkit/src/main/java/com/lunarclient/apollo/ApolloBukkitPlatform.java

@@ -23,8 +23,8 @@
  */
 package com.lunarclient.apollo;
 
-import com.lunarclient.apollo.command.impl.ApolloCommand;
-import com.lunarclient.apollo.command.impl.LunarClientCommand;
+import com.lunarclient.apollo.command.BukkitApolloCommand;
+import com.lunarclient.apollo.command.BukkitLunarClientCommand;
 import com.lunarclient.apollo.listener.ApolloMetadataListener;
 import com.lunarclient.apollo.listener.ApolloPlayerListener;
 import com.lunarclient.apollo.listener.ApolloWorldListener;
@@ -174,8 +174,8 @@ public void onEnable() {
             (channel, player, bytes) -> ApolloManager.getNetworkManager().receivePacket(player.getUniqueId(), bytes)
         );
 
-        this.plugin.getCommand("apollo").setExecutor(new ApolloCommand());
-        this.plugin.getCommand("lunarclient").setExecutor(new LunarClientCommand());
+        this.plugin.getCommand("apollo").setExecutor(new BukkitApolloCommand());
+        this.plugin.getCommand("lunarclient").setExecutor(new BukkitLunarClientCommand());
 
         ApolloManager.getStatsManager().enable();
         ApolloManager.getVersionManager().checkForUpdates();
@@ -195,6 +195,11 @@ public Kind getKind() {
         return Kind.SERVER;
     }
 
+    @Override
+    public Platform getPlatform() {
+        return Platform.BUKKIT;
+    }
+
     @Override
     public String getApolloVersion() {
         return this.plugin.getDescription().getVersion();