.github/workflows/build.yml

@@ -0,0 +1,53 @@
+name: Build
+
+on: [
+  workflow_dispatch,
+  push
+]
+
+jobs:
+  build:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    env:
+      BUILD_NUMBER: "${{ github.run_number }}"
+      COMMIT_MESSAGE: "${{ github.event.head_commit.message }}"
+
+    steps:
+      - uses: actions/checkout@v4
+        name: Checkout sources
+
+      - uses: actions/setup-java@v4
+        name: Set up JDK 17
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - uses: gradle/actions/setup-gradle@v4
+        name: Setup Gradle
+
+      - name: Build Artifact
+        run: "chmod +x ./gradlew && ./gradlew build $([[ \"$COMMIT_MESSAGE\" == \"release:\"* ]] && echo || echo -PBUILD_NUMBER=$BUILD_NUMBER)"
+
+      - uses: actions/upload-artifact@v4
+        name: Save Artifact
+        with:
+          name: "AdriAPI-b${{ github.run_number }}"
+          path: build/libs/*.jar
+
+      - name: Publish Artifact
+        if: github.repository == 'Adrigamer2950/AdriAPI'
+        env:
+          NEXUS_USERNAME: "${{ secrets.NEXUS_USERNAME }}"
+          NEXUS_PASSWORD: "${{ secrets.NEXUS_PASSWORD }}"
+        run: "./gradlew publish -PNEXUS_USERNAME=$NEXUS_USERNAME -PNEXUS_PASSWORD=$NEXUS_PASSWORD $([[ \"$COMMIT_MESSAGE\" == \"release:\"* ]] && echo \"\" || echo \"-PBUILD_NUMBER=$BUILD_NUMBER\")"
+
+      - name: Publish to Modrinth
+        if: "${{ github.repository == 'Adrigamer2950/AdriAPI' && startsWith(github.event.head_commit.message, 'release:') }}"
+        env:
+          MODRINTH_TOKEN: "${{ secrets.MODRINTH_TOKEN }}"
+        run: "./gradlew modrinth modrinthSyncBody"

.gitignore

@@ -115,4 +115,7 @@ gradle-app.setting
 run/
 
 # Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
-!gradle-wrapper.jar
+!gradle-wrapper.jar
+
+# VS Code files
+.vscode/

README.md

@@ -1,14 +1,20 @@
 # AdriAPI
+<p align="center">
+    <img src="https://avatars.githubusercontent.com/u/58531641?v=4" height="364" alt="Logo" />
+</p>
 
 An API created to make Minecraft Plugin development easier
 
-[![Dev Build Status](https://ci.devadri.es/buildStatus/icon?job=AdriAPI%2FAdriAPI-Dev&subject=Dev%20Build)](https://ci.devadri.es/job/AdriAPI/job/AdriAPI-Dev/)
-[![Build Status](https://ci.devadri.es/buildStatus/icon?job=AdriAPI%2FAdriAPI-Release&subject=Release)](https://ci.devadri.es/job/AdriAPI/job/AdriAPI-Release/)
-
-# Docs
-Under development...
+![Build](https://github.com/Adrigamer2950/AdriAPI/actions/workflows/build.yml/badge.svg)
 
 # Resources
-- [CI Server](https://ci.devadri.es/job/AdriAPI)
+- [Docs](https://docs.devadri.es)
 - [bStats](https://bstats.org/plugin/bukkit/AdriAPI/20135)
-- [Repository](https://repo.devadri.es)
+- [Maven Repository](https://repo.devadri.es)
+
+# Info
+
+This API is aimed to simplify the development of Bukkit plugins (please use Paper or any fork of Paper instead of CraftBukkit/Spigot), 
+providing a lot of utilities that will make your life (and mine) easier.
+
+### It's used in my plugins, but you can use it on your own plugins if you want, just make sure to give proper credit!

build.gradle

@@ -1,19 +1,21 @@
 //file:noinspection GroovyAssignabilityCheck
 //file:noinspection GroovyAccessibility
+import xyz.jpenilla.runtask.task.AbstractRun
+
 plugins {
     id 'java'
     id "maven-publish"
+    id 'net.minecrell.plugin-yml.bukkit' version '0.6.0'
+    id "com.modrinth.minotaur" version "2.+"
+    id "xyz.jpenilla.run-paper" version "2.3.1"
 }
 
 group = 'me.adrigamer2950'
 version = properties.get("version") + (
         project.hasProperty("BUILD_NUMBER") ?
-                ("-DEV" + (
-                        project.property("BUILD_NUMBER") == "0" ? "" : ("-b" + project.property("BUILD_NUMBER")))
-                )
+                (project.property("BUILD_NUMBER") == "0" ? "" : ("-b" + project.property("BUILD_NUMBER")))
                 : ""
 )
-description = properties.get("description")
 author = properties.get("author")
 
 if (project.hasProperty("NEXUS_USERNAME") && project.hasProperty("NEXUS_PASSWORD")) {
@@ -90,18 +92,22 @@ repositories {
 
 dependencies {
     // JetBrains Annotations
-    compileOnly "org.jetbrains:annotations:24.0.1"
+    compileOnly "org.jetbrains:annotations:26.0.1"
 
     // Folia API
     //noinspection VulnerableLibrariesLocal
     compileOnly "dev.folia:folia-api:1.20.4-R0.1-SNAPSHOT"
 
     // Lombok
-    compileOnly 'org.projectlombok:lombok:1.18.32'
-    annotationProcessor 'org.projectlombok:lombok:1.18.32'
+    compileOnly 'org.projectlombok:lombok:1.18.36'
+    annotationProcessor 'org.projectlombok:lombok:1.18.36'
 
     // Ansi
     compileOnly 'org.fusesource.jansi:jansi:2.4.1'
+
+    // Adventure API
+    compileOnly "net.kyori:adventure-platform-bukkit:4.3.4"
+    bukkitLibrary "net.kyori:adventure-platform-bukkit:4.3.4"
 }
 
 def targetJavaVersion = 17
@@ -122,17 +128,93 @@ tasks {
             toolchain.languageVersion = JavaLanguageVersion.of(targetJavaVersion)
         }
     }
-}
 
-processResources {
-    def props = [
-            version: version,
-            description: description,
-            author: author
-    ]
-    inputs.properties props
-    filteringCharset 'UTF-8'
-    filesMatching('plugin.yml') {
-        expand props
+    bukkit {
+        name = "AdriAPI"
+        version = version
+        main = "me.adrigamer2950.adriapi.AdriAPI"
+        apiVersion = "1.18"
+        author = author
+        description = this.description
+        website = "https://github.com/Adrigamer2950/AdriAPI"
+        load = 'STARTUP'
+        foliaSupported = true
+
+        commands {
+            adriapi {
+                description = "Main command"
+                usage = "/adriapi"
+            }
+        }
+    }
+
+    modrinth {
+        token = System.getenv("MODRINTH_TOKEN")
+        projectId = "adriapi"
+        versionNumber = version
+        versionName = rootProject.name + " " + version
+        versionType = "release"
+        uploadFile = jar
+        gameVersions = [
+                "1.18",
+                "1.18.1",
+                "1.18.2",
+                "1.19",
+                "1.19.1",
+                "1.19.2",
+                "1.19.3",
+                "1.19.4",
+                "1.20",
+                "1.20.1",
+                "1.20.2",
+                "1.20.3",
+                "1.20.4",
+                "1.20.5",
+                "1.20.6",
+                "1.21",
+                "1.21.1",
+                "1.21.2",
+                "1.21.3",
+                "1.21.4"
+        ]
+        loaders = [
+                "bukkit",
+                "folia",
+                "paper",
+                "purpur",
+                "spigot"
+        ]
+        syncBodyFrom = rootProject.file("README.md").text
+    }
+
+    runServer {
+        minecraftVersion("1.20.2")
+
+        downloadPlugins {
+            // ViaVersion
+            hangar("ViaVersion", "5.2.0")
+        }
+    }
+
+    tasks.withType(AbstractRun).configureEach {
+        javaLauncher = javaToolchains.launcherFor {
+            vendor = JvmVendorSpec.JETBRAINS
+            languageVersion = JavaLanguageVersion.of(targetJavaVersion)
+        }
+        jvmArgs(
+                // Hot Swap
+                "-XX:+AllowEnhancedClassRedefinition",
+
+                // Aikar Flags
+                "--add-modules=jdk.incubator.vector", "-XX:+UseG1GC", "-XX:+ParallelRefProcEnabled",
+                "-XX:MaxGCPauseMillis=200", "-XX:+UnlockExperimentalVMOptions", "-XX:+DisableExplicitGC",
+                "-XX:+AlwaysPreTouch", "-XX:G1NewSizePercent=30", "-XX:G1MaxNewSizePercent=40",
+                "-XX:G1HeapRegionSize=8M", "-XX:G1ReservePercent=20", "-XX:G1HeapWastePercent=5",
+                "-XX:G1MixedGCCountTarget=4", "-XX:InitiatingHeapOccupancyPercent=15",
+                "-XX:G1MixedGCLiveThresholdPercent=90", "-XX:G1RSetUpdatingPauseTimePercent=5",
+                "-XX:SurvivorRatio=32", "-XX:+PerfDisableSharedMem", "-XX:MaxTenuringThreshold=1",
+                "-Dusing.aikars.flags=https://mcflags.emc.gs", "-Daikars.new.flags=true"
+        )
+
     }
 }

gradle.properties

@@ -1,3 +1,3 @@
-version=2.0.1
-description=An API created to make Minecraft Plugin development easier
+version=2.1.0
+description=An API aimed to simplify the development of Bukkit (better use Paper) plugins
 author=Adrigamer2950

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

gradlew

@@ -15,6 +15,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+# SPDX-License-Identifier: Apache-2.0
+#
 
 ##############################################################################
 #
@@ -55,7 +57,7 @@
 #       Darwin, MinGW, and NonStop.
 #
 #   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       https://github.com/gradle/gradle/blob/HEAD/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/.
@@ -83,7 +85,8 @@ done
 # This is normally unused
 # shellcheck disable=SC2034
 APP_BASE_NAME=${0##*/}
-APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+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
@@ -144,15 +147,15 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
     case $MAX_FD in #(
       max*)
         # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045
+        # shellcheck disable=SC2039,SC3045
         MAX_FD=$( ulimit -H -n ) ||
             warn "Could not query maximum file descriptor limit"
     esac
     case $MAX_FD in  #(
       '' | soft) :;; #(
       *)
         # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045
+        # shellcheck disable=SC2039,SC3045
         ulimit -n "$MAX_FD" ||
             warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
@@ -201,11 +204,11 @@ fi
 # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
-# Collect all arguments for the java command;
-#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
-#     shell script including quotes and variable substitutions, so put them in
-#     double quotes to make sure that they get re-expanded; and
-#   * put everything else in single quotes, so that it's not re-expanded.
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_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" \