feat: add API version management with configuration file and update version retrieval method

Author: Pinont

.github/workflows/release.yml

@@ -105,43 +105,13 @@ jobs:
           fi
 
       - name: Build (package)
-        run: mvn -B -s $GITHUB_WORKSPACE/settings.xml package
+        run: mvn -B -s $GITHUB_WORKSPACE/settings.xml -DskipTests -Pwith-shade package
 
       - name: Deploy Release to GitHub Packages
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: mvn -B -s $GITHUB_WORKSPACE/settings.xml -DskipTests deploy
 
-      - name: Build (package, with-shade)
-        run: mvn -B -s $GITHUB_WORKSPACE/settings.xml -DskipTests -Pwith-shade package
-
-      - name: Verify built artifacts
-        run: |
-          set -e
-          echo "Contents of target/:"
-          ls -1 target || true
-
-          # Find a primary jar (excluding sources/javadoc)
-          MAIN_JAR=$(ls target/*.jar 2>/dev/null | grep -v '\-sources\.jar$' | grep -v '\-javadoc\.jar$' | head -n1 || true)
-          if [[ -z "$MAIN_JAR" ]]; then
-            echo "ERROR: No main artifact jar found."
-            exit 1
-          fi
-
-          BASENAME=$(basename "$MAIN_JAR")
-          STRIPPED=${BASENAME#original-}
-
-          if [[ "$BASENAME" != "$STRIPPED" ]]; then
-            # Found an 'original-' artifact -> produce *-api.jar
-            API_NAME="${STRIPPED%.jar}-api.jar"
-            cp "$MAIN_JAR" "$API_NAME"
-            echo "Found original artifact: $MAIN_JAR -> copied to $API_NAME"
-          else
-            # Likely the shaded artifact -> keep basename
-            cp "$MAIN_JAR" "$BASENAME"
-            echo "Found main artifact (shaded): $MAIN_JAR -> copied to $BASENAME"
-          fi
-
       - name: Create & Push Git Tag
         run: |
           set -e
@@ -162,9 +132,7 @@ jobs:
           name: "SingularityLib ${{ steps.version.outputs.version }}"
           generate_release_notes: true
           files: |
-            target/*-sources.jar
-            target/*-javadoc.jar
-            singularitylib-*.jar
+            `target/*.jar`
 
       - name: Summary
         run: |

pom.xml

@@ -41,18 +41,24 @@
     <profiles>
         <profile>
             <id>with-shade</id>
+            <!-- Optional: still allow activation by property 'shade' if you prefer -Dshade=true -->
             <activation>
                 <property>
                     <name>shade</name>
                 </property>
             </activation>
+
             <build>
                 <plugins>
                     <plugin>
                         <groupId>org.apache.maven.plugins</groupId>
                         <artifactId>maven-shade-plugin</artifactId>
                         <version>3.5.3</version>
                         <configuration>
+                            <!-- Attach shaded artifact instead of replacing the main jar -->
+                            <shadedArtifactAttached>true</shadedArtifactAttached>
+                            <shadedClassifierName>shaded</shadedClassifierName>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
                             <filters>
                                 <filter>
                                     <artifact>org.reflections:reflections</artifact>
@@ -76,7 +82,6 @@
         </profile>
     </profiles>
 
-
     <scm>
         <url>https://github.com/Pinont/SingularityLib</url>
         <connection>scm:git:https://github.com/Pinont/SingularityLib.git</connection>

src/main/java/com/github/pinont/singularitylib/api/utils/Common.java

@@ -1,6 +1,8 @@
 package com.github.pinont.singularitylib.api.utils;
 
 import com.github.pinont.singularitylib.api.enums.PlayerInventorySlotType;
+import com.github.pinont.singularitylib.api.manager.ConfigManager;
+import com.github.pinont.singularitylib.plugin.CorePlugin;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.minimessage.MiniMessage;
 import org.bukkit.Bukkit;
@@ -28,6 +30,17 @@ public class Common {
     public Common() {
     }
 
+    /**
+     * Gets the current API version.
+     *
+     * @return the API version string
+     */
+    public static String getAPIVersion() {
+        ConfigManager apiConfig = new ConfigManager(CorePlugin.getInstance(), "api-version.yml");
+        String version = apiConfig.getConfig().getString("api-version", "1.0.0");
+        return "V-" + version;
+    }
+
     /**
      * Colorizes a string message using MiniMessage format.
      *

src/main/java/com/github/pinont/singularitylib/plugin/CorePlugin.java

@@ -1,5 +1,6 @@
 package com.github.pinont.singularitylib.plugin;
 
+import com.github.pinont.singularitylib.api.utils.Common;
 import com.github.pinont.singularitylib.plugin.listener.PlayerListener;
 import com.github.pinont.singularitylib.api.command.SimpleCommand;
 import com.github.pinont.singularitylib.api.manager.ConfigManager;
@@ -93,16 +94,6 @@ public static void sendConsoleMessage(String message) {
 
     private final List<Listener> listeners = new ArrayList<>();
 
-    /**
-     * Gets the current API version.
-     *
-     * @return the API version string
-     */
-    public static String getAPIVersion() {
-        String version = "1.3.3";
-        return "V-" + version;
-    }
-
     private ConfigManager pluginConfig;
 
     /**
@@ -174,7 +165,7 @@ public final void onEnable() {
         }
 
         // Initialize API To Plugin.
-        sendConsoleMessage(ChatColor.WHITE + "" + ChatColor.ITALIC + "Hooked " + ChatColor.YELLOW + ChatColor.ITALIC + this.getName() + ChatColor.WHITE + ChatColor.ITALIC + " into " + ChatColor.LIGHT_PURPLE + ChatColor.ITALIC + "SingularityAPI! " + getAPIVersion());
+        sendConsoleMessage(ChatColor.WHITE + "" + ChatColor.ITALIC + "Hooked " + ChatColor.YELLOW + ChatColor.ITALIC + this.getName() + ChatColor.WHITE + ChatColor.ITALIC + " into " + ChatColor.LIGHT_PURPLE + ChatColor.ITALIC + "SingularityAPI! " + Common.getAPIVersion());
         onPluginStart();
         registerAPIListener(this, new PlayerListener());
 //        new CommandManager().register(this, this.simpleCommands);

src/main/resources/api-version.yml

@@ -0,0 +1 @@
+api-version: ${version}