start of server api and cleanup

Author: mysticdrew

common/src/main/java/journeymap/api/v2/client/IClientAPI.java

@@ -268,7 +268,7 @@ void requestMapTile(String modId, ResourceKey<Level> dimension, Context.MapType
 
     /**
      * Removes a waypoint group.
-     * Setting deleteWaypoints to false, will move all waypoints in the Default group.
+     * Setting deleteWaypoints to false will move all waypoints in the Default group.
      *
      * @param group           the group
      * @param deleteWaypoints to delete all waypoints in group
@@ -277,7 +277,7 @@ void requestMapTile(String modId, ResourceKey<Level> dimension, Context.MapType
 
     /**
      * Removes groups for a modId.
-     * Setting deleteWaypoints to false, will move all waypoints in the Default group.
+     * Setting deleteWaypoints to false will move all waypoints in the Default group.
      *
      * @param modId           - the modId
      * @param deleteWaypoints to delete all waypoints in group

common/src/main/java/journeymap/api/v2/client/IClientPlugin.java

@@ -20,6 +20,8 @@
 
 package journeymap.api.v2.client;
 
+import journeymap.api.v2.common.IJourneyMapPlugin;
+import journeymap.api.v2.common.JourneyMapPlugin;
 import journeymap.api.v2.common.event.ClientEventRegistry;
 
 import javax.annotation.ParametersAreNonnullByDefault;
@@ -30,7 +32,7 @@
  * Implementation classes must have a no-arg constructor and also have the {@link JourneyMapPlugin} annotation.
  */
 @ParametersAreNonnullByDefault
-public interface IClientPlugin
+public interface IClientPlugin extends IJourneyMapPlugin
 {
     /**
      * Called by JourneyMap during the init phase of mod loading.  Your implementation
@@ -44,8 +46,4 @@ public interface IClientPlugin
      */
     void initialize(final IClientAPI jmClientApi);
 
-    /**
-     * Used by JourneyMap to associate your mod id with your plugin instance.
-     */
-    String getModId();
 }

common/src/main/java/journeymap/api/v2/client/JourneyMapPlugin.java

@@ -31,9 +31,13 @@
  * <p>
  * Classes with this annotation must have a no-arg constructor
  * and must also implement the {@link IClientPlugin} interface.
+ *
+ * @deprecated this will be removed, please use {@link journeymap.api.v2.common.JourneyMapPlugin}
+ * This will be removed when the API is out of snapshot phase.
  */
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.RUNTIME)
+@Deprecated(forRemoval = true, since = "2.0.0")
 public @interface JourneyMapPlugin
 {
     /**

common/src/main/java/journeymap/api/v2/client/util/PluginHelper.java

@@ -0,0 +1,13 @@
+package journeymap.api.v2.common;
+
+import org.jetbrains.annotations.ApiStatus;
+
+@ApiStatus.Internal
+public interface IJourneyMapPlugin
+{
+    /**
+     * Used by JourneyMap to associate your mod id with your plugin instance.
+     */
+    String getModId();
+
+}

common/src/main/java/journeymap/api/v2/client/util/tuple/Tuple2.java

@@ -0,0 +1,51 @@
+/*
+ * JourneyMap API (http://journeymap.info)
+ * http://github.com/TeamJM/journeymap-api
+ *
+ * Copyright (c) 2011-2016 Techbrew.  All Rights Reserved.
+ * The following limited rights are granted to you:
+ *
+ * You MAY:
+ *  + Write your own code that uses the API source code in journeymap.* packages as a dependency.
+ *  + Write and distribute your own code that uses, modifies, or extends the example source code in example.* packages
+ *  + Fork and modify any source code for the purpose of submitting Pull Requests to the TeamJM/journeymap-api repository.
+ *    Submitting new or modified code to the repository means that you are granting Techbrew all rights to the submitted code.
+ *
+ * You MAY NOT:
+ *  - Distribute source code or classes (whether modified or not) from journeymap.* packages.
+ *  - Submit any code to the TeamJM/journeymap-api repository with a different license than this one.
+ *  - Use code or artifacts from the repository in any way not explicitly granted by this license.
+ *
+ */
+
+package journeymap.api.v2.common;
+
+import journeymap.api.v2.client.IClientPlugin;
+import journeymap.api.v2.server.IServerPlugin;
+
+import javax.annotation.Nullable;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Used by JourneyMap to discover and classload plugin classes.
+ * <p>
+ * Classes with this annotation must have a no-arg constructor
+ * and must also implement the {@link IClientPlugin} interface for client plugins
+ * or {@link IServerPlugin} interface for server plugins.
+ */
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface JourneyMapPlugin
+{
+    /**
+     * Mod Devs can supply the version of journeymap-api the mod was built against,
+     * so that it will not load the plugin if there is a breaking change.
+     *
+     * @return - The Api Version
+     */
+    @Nullable
+    String apiVersion();
+}

common/src/main/java/journeymap/api/v2/common/IJourneyMapPlugin.java

@@ -0,0 +1,5 @@
+package journeymap.api.v2.common.tuple;
+
+public record Tuple2<A, B>(A a, B b)
+{
+}

common/src/main/java/journeymap/api/v2/common/JourneyMapPlugin.java

@@ -1,4 +1,4 @@
-package journeymap.api.v2.client.util.tuple;
+package journeymap.api.v2.common.tuple;
 
 public record Tuple3<A, B, C>(A a, B b, C c)
 {

common/src/main/java/journeymap/api/v2/common/tuple/Tuple2.java

@@ -1,4 +1,4 @@
-package journeymap.api.v2.client.util.tuple;
+package journeymap.api.v2.common.tuple;
 
 public record Tuple4<A, B, C, D>(A a, B b, C c, D d)
 {