Add Quilt and Forge Support

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}

build.gradle.kts

@@ -8,12 +8,16 @@ val javaVersionsOverride = mapOf(
  ":bukkit:example-plugin" to 21,
  ":fabric" to 25,
  ":fabric:example-mod" to 25,
+ ":forge" to 21,
+ ":forge:example-mod" to 21,
  ":hytale" to 25,
  ":hytale:example-plugin" to 25,
  ":minestom" to 25,
  ":minestom:example-server" to 25,
  ":neoforge" to 25,
  ":neoforge:example-mod" to 25,
+ ":quilt" to 25,
+ ":quilt:example-mod" to 25,
  ":velocity" to 21,
  ":velocity:example-plugin" to 21
 )

forge/build.gradle.kts

@@ -0,0 +1,13 @@
+val moduleName by extra("dev.faststats.forge")
+
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+}

forge/example-mod/build.gradle.kts

@@ -0,0 +1,18 @@
+repositories {
+ maven("https://maven.minecraftforge.net/")
+ maven("https://libraries.minecraft.net/")
+}
+
+dependencies {
+ implementation(project(":forge"))
+ compileOnly("net.minecraftforge:fmlloader:1.21-51.0.21")
+ compileOnly("net.minecraftforge:forgespi:7.1.4")
+ compileOnly("net.minecraftforge:javafmllanguage:1.21-51.0.21")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":forge").sourceSets["main"].output)
+}

forge/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,30 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.forge.ForgeContext;
+import net.minecraftforge.fml.common.Mod;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+@Mod("example_mod")
+public final class ExampleMod {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final ForgeContext context = new ForgeContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

forge/example-mod/src/main/resources/META-INF/mods.toml

@@ -0,0 +1,10 @@
+modLoader = "javafml"
+loaderVersion = "[51,)"
+license = "MIT"
+
+[[mods]]
+modId = "example_mod"
+version = "1.0.0"
+displayName = "Example Mod"
+authors = "Your Name"
+description = "Example FastStats Forge mod"

forge/src/main/java/dev/faststats/forge/ForgeContext.java

@@ -0,0 +1,85 @@
+package dev.faststats.forge;
+
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.Token;
+import dev.faststats.config.SimpleConfig;
+import net.minecraftforge.fml.loading.FMLPaths;
+import net.minecraftforge.fml.loading.LoadingModList;
+import net.minecraftforge.forgespi.language.IModInfo;
+import org.jetbrains.annotations.Contract;
+
+import java.util.Set;
+import java.util.concurrent.CopyOnWriteArraySet;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Forge FastStats context.
+ *
+ * @since 0.27.0
+ */
+public final class ForgeContext extends SimpleContext {
+ private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(runnable -> {
+ final var thread = new Thread(runnable, "faststats-submitter");
+ thread.setDaemon(true);
+ return thread;
+ });
+ private final Set<Future<?>> tasks = new CopyOnWriteArraySet<>();
+ private final IModInfo mod;
+
+ private ForgeContext(final Factory factory, final String modId, @Token final String token) {
+ super(factory, SimpleConfig.read(FMLPaths.CONFIGDIR.get().resolve("faststats").resolve("config.properties")), "forge", token);
+ this.mod = LoadingModList.get().getMods().stream().filter(mod -> mod.getModId().equals(modId)).findFirst().orElseThrow(() -> {
+ return new IllegalArgumentException("Mod not found: " + modId);
+ });
+ initializeServices(factory);
+ }
+
+ @Override
+ @Contract(value = " -> new", pure = true)
+ protected Metrics.Factory metricsFactory() {
+ // todo: proper client/server support
+ return new ForgeMetrics.Factory(this, mod);
+ }
+
+ @Override
+ protected boolean preSubmissionStart() {
+ return ((SimpleConfig) getConfig()).preSubmissionStart(getProjectName());
+ }
+
+ @Override
+ public String getProjectName() {
+ return mod.getModId();
+ }
+
+ @Override
+ protected void scheduleAtFixedRate(final Runnable task, final long initialDelay, final long period, final TimeUnit unit) {
+ tasks.add(executor.scheduleAtFixedRate(task, initialDelay, period, unit));
+ }
+
+ @Override
+ public void shutdown() {
+ super.shutdown();
+ tasks.forEach(task -> task.cancel(true));
+ tasks.clear();
+ executor.shutdown();
+ }
+
+ public static final class Factory extends SimpleContext.Factory<ForgeContext, Factory> {
+ private final String modId;
+ private final @Token String token;
+
+ public Factory(final String modId, @Token final String token) {
+ this.modId = modId;
+ this.token = token;
+ }
+
+ @Override
+ public ForgeContext create() {
+ return new ForgeContext(this, modId, token);
+ }
+ }
+}

forge/src/main/java/dev/faststats/forge/ForgeMetrics.java

@@ -0,0 +1,41 @@
+package dev.faststats.forge;
+
+import com.google.gson.JsonObject;
+import dev.faststats.Metrics;
+import dev.faststats.SimpleContext;
+import dev.faststats.SimpleMetrics;
+import net.minecraftforge.forgespi.language.IModInfo;
+
+final class ForgeMetrics extends SimpleMetrics {
+ private final IModInfo mod;
+
+ private ForgeMetrics(final Factory factory, final IModInfo mod) {
+ super(factory);
+ this.mod = mod;
+ }
+
+ @Override
+ protected void appendDefaultData(final JsonObject metrics) {
+ // todo: implement
+ // metrics.addProperty("online_mode", false); 
+ // metrics.addProperty("player_count", 0);
+ // metrics.addProperty("minecraft_version", "idk");
+ // metrics.addProperty("platform_version", "idk");
+ metrics.addProperty("plugin_version", mod.getVersion().toString());
+ metrics.addProperty("server_type", "Forge");
+ }
+
+ static final class Factory extends SimpleMetrics.Factory {
+ private final IModInfo mod;
+
+ Factory(final SimpleContext context, final IModInfo mod) {
+ super(context);
+ this.mod = mod;
+ }
+
+ @Override
+ public Metrics create() throws IllegalStateException {
+ return new ForgeMetrics(this, mod);
+ }
+ }
+}

forge/src/main/java/module-info.java

@@ -0,0 +1,15 @@
+import org.jspecify.annotations.NullMarked;
+
+@NullMarked
+module dev.faststats.forge {
+ exports dev.faststats.forge;
+
+ requires com.google.gson;
+ requires dev.faststats.config;
+ requires dev.faststats;
+ requires net.minecraftforge.fmlloader;
+ requires net.minecraftforge.forgespi;
+
+ requires static org.jetbrains.annotations;
+ requires static org.jspecify;
+}

quilt/build.gradle.kts

@@ -0,0 +1,9 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ api(project(":core"))
+ implementation(project(":config"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}

quilt/example-mod/build.gradle.kts

@@ -0,0 +1,15 @@
+repositories {
+ maven("https://maven.quiltmc.org/repository/release/")
+}
+
+dependencies {
+ implementation(project(":quilt"))
+ compileOnly("org.quiltmc:quilt-loader:0.29.1")
+}
+
+tasks.jar {
+ duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+ from(project(":config").sourceSets["main"].output)
+ from(project(":core").sourceSets["main"].output)
+ from(project(":quilt").sourceSets["main"].output)
+}

quilt/example-mod/src/main/java/com/example/ExampleMod.java

@@ -0,0 +1,34 @@
+package com.example;
+
+import dev.faststats.ErrorTracker;
+import dev.faststats.data.Metric;
+import dev.faststats.quilt.QuiltContext;
+import net.fabricmc.api.ModInitializer;
+
+import java.util.concurrent.atomic.AtomicInteger;
+
+public final class ExampleMod implements ModInitializer {
+ public static final ErrorTracker ERROR_TRACKER = ErrorTracker.contextAware();
+ private final AtomicInteger gameCount = new AtomicInteger();
+
+ private final QuiltContext context = new QuiltContext.Factory(
+ "example_mod",
+ "YOUR_TOKEN_HERE"
+ )
+ .metrics(factory -> factory
+ .addMetric(Metric.number("game_count", gameCount::get))
+ .addMetric(Metric.string("server_version", () -> "1.0.0"))
+ .onFlush(() -> gameCount.set(0))
+ .create())
+ .errorTrackerService(ERROR_TRACKER)
+ .create();
+
+ @Override
+ public void onInitialize() {
+ // your actual logic
+ }
+
+ public void startGame() {
+ gameCount.incrementAndGet();
+ }
+}

quilt/example-mod/src/main/resources/quilt.mod.json

@@ -0,0 +1,30 @@
+{
+ "schema_version": 1,
+ "quilt_loader": {
+ "group": "com.example",
+ "id": "example_mod",
+ "version": "1.0.0",
+ "metadata": {
+ "name": "Example Mod",
+ "description": "Example FastStats Quilt mod",
+ "contributors": {
+ "Your Name": "Owner"
+ }
+ },
+ "entrypoints": {
+ "init": [
+ "com.example.ExampleMod"
+ ]
+ },
+ "depends": [
+ {
+ "id": "quilt_loader",
+ "versions": ">=0.29.1"
+ },
+ {
+ "id": "minecraft",
+ "versions": "*"
+ }
+ ]
+ }
+}