Installation

Add the FastStats SDK to your project using Maven or Gradle.

Copy Text
maven {
  name = "faststatsReleases"
  url = uri("https://repo.faststats.dev/releases")
}

Platform-Specific ArtifactsCopy Anchor Link

Choose the artifact for your platform:

Fabric, Forge and NeoForge artifacts include the SDK version and the exact Minecraft version you want to target:

Copy Text
implementation("dev.faststats.metrics:fabric:0.31.0+mc26.3")
include("dev.faststats.metrics:fabric:0.31.0+mc26.3")

implementation("dev.faststats.metrics:forge:0.31.0+mc26.3")
jarJar.configurationName("dev.faststats.metrics:forge:0.31.0+mc26.3")

implementation("dev.faststats.metrics:neoforge:0.31.0+mc26.3")
jarJar("dev.faststats.metrics:neoforge:0.31.0+mc26.3")

Use both implementation and include/jarJar for modded platforms. FastStats is provided as a mod through jar-in-jar, so implementation puts it on your compile classpath and include/jarJar bundles it into your mod JAR.

The version format is {sdk-version}+mc{minecraft-version}, where {sdk-version} is the FastStats SDK version and {minecraft-version} is the exact Minecraft version you are targeting. Each artifact is built for a single Minecraft version, so pick the one matching your mod.

You can find the available versions in the Maven repository: Fabric, Forge and NeoForge.

All other platforms use the SDK version without a Minecraft version suffix.

implementation("dev.faststats.metrics:bukkit:0.31.0")

Java 8 Fallback ArtifactsCopy Anchor Link

Use the standard Java 17+ artifacts above whenever possible. Java 8 artifacts are provided only as a last resort for projects that absolutely cannot run on Java 17.

Java 8 artifacts use the dev.faststats.metrics.j8 group ID. Their versions are published separately from the standard Java artifacts:

For example, if your Bukkit plugin must stay on Java 8, use the Java 8 group ID and its latest published version:

implementation("dev.faststats.metrics.j8:bukkit:0.30.2")

ShadingCopy Anchor Link

To include FastStats directly in your plugin JAR, you can use the Maven Shade or Gradle Shadow Plugin.

plugins {  id("com.gradleup.shadow") version "9.4.1"}tasks.shadowJar {relocate("dev.faststats", "your.plugin.libs.faststats") // optionally relocate the package}