Setup Dependency RankForge API – Maven, Gradle & plugin.yml

Untuk memakai API, plugin kamu perlu mengompilasi terhadap JAR RankForge dan menyatakan dependency di plugin.yml. JAR RankForge sendiri tidak ikut dibundel ke plugin kamu (scope provided / compileOnly).

Distribusi Artifact

RankForge adalah plugin Closed Source. Kamu dapat mengunduh JAR rilis resmi dari Modrinth, lalu memasangnya ke local repository atau mengimpornya sebagai local JAR dependency.

1. Dapatkan Artifact JAR

Unduh dari Modrinth

1. Unduh RankForge-1.0.0.jar dari halaman rilis resmi Modrinth.
2. Letakkan file JAR di dalam folder libs/ proyek plugin kamu.

Install ke Local Maven Cache

Jika kamu memiliki file JAR RankForge, kamu dapat memasangnya ke local repository Maven dengan perintah:

mvn install:install-file \
  -Dfile=RankForge-1.0.0.jar \
  -DgroupId=xyz.noxlydev \
  -DartifactId=RankForge \
  -Dversion=1.0.0 \
  -Dpackaging=jar

2. Tambahkan Dependency ke Project

Maven (Local Jar)

<dependency>
    <groupId>xyz.noxlydev</groupId>
    <artifactId>RankForge</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/libs/RankForge-1.0.0.jar</systemPath>
</dependency>

Gradle (Kotlin DSL)

dependencies {
    compileOnly(files("libs/RankForge-1.0.0.jar"))
}

Gradle (Groovy DSL)

dependencies {
    compileOnly files('libs/RankForge-1.0.0.jar')
}

3. Daftarkan di plugin.yml

Tentukan apakah RankForge wajib (hard depend) atau opsional (soft depend):

# Wajib: plugin tidak akan jalan jika RankForge tidak ada
depend:
  - RankForge

# ATAU Opsional: plugin tetap jalan, fitur ranking opsional
softdepend:
  - RankForge

4. Cek Ketersediaan API Saat Runtime

import xyz.noxlydev.rankforge.api.RankForgeAPI;

if (RankForgeAPI.isAvailable()) {
    // API siap digunakan
    int points = RankForgeAPI.get().getPoints(player);
}