feat(metrics): report plugin runtime stats

Author: AlexProgrammerDE

build.gradle.kts

@@ -14,6 +14,7 @@ allprojects {
     version = "1.0.0-SNAPSHOT"
     description = "Example of how to make a plugin for SoulFire."
     repositories {
+        mavenLocal()
         maven("https://repo.viaversion.com") {
             name = "ViaVersion Repository"
             content {
@@ -87,6 +88,13 @@ allprojects {
                 includeGroup("com.soulfiremc")
             }
         }
+        maven("https://repo.codemc.org/repository/maven-snapshots/") {
+            name = "CodeMC Snapshot Repository"
+            mavenContent { snapshotsOnly() }
+            content {
+                includeGroup("com.soulfiremc")
+            }
+        }
         mavenCentral()
     }
 }

gradle/libs.versions.toml

@@ -1,7 +1,7 @@
 [versions]
 minecraft = "1.21.11_unobfuscated"
 fabric-loader = "0.18.4"
-soulfire = "2.5.7"
+soulfire = "2.9.1-SNAPSHOT"
 
 [plugins]
 

src/main/java/com/soulfiremc/pluginexample/ExampleServerExtension.java

@@ -19,6 +19,7 @@
 
 import com.soulfiremc.server.api.ExternalPlugin;
 import com.soulfiremc.server.api.PluginInfo;
+import com.soulfiremc.server.api.event.bot.ChatMessageReceiveEvent;
 import com.soulfiremc.server.api.event.lifecycle.InstanceSettingsRegistryInitEvent;
 import com.soulfiremc.server.settings.lib.SettingsObject;
 import com.soulfiremc.server.settings.lib.SettingsSource;
@@ -50,6 +51,17 @@ public void onSettingsRegistryInit(InstanceSettingsRegistryInitEvent event) {
         log.info("Run \"jump\" to see the hacked jump boost!");
     }
 
+    /// Reference usage of the plugin runtime stats API: count chat messages each
+    /// bot observes and expose it as a live counter on the instance overview.
+    @EventHandler
+    public void onChatMessage(ChatMessageReceiveEvent event) {
+        var connection = event.connection();
+        var stats = connection.instanceManager().pluginStats().forPlugin(pluginInfo());
+        stats.trackBot(connection.accountProfileId());
+        stats.counter("chat_messages_seen", "Chat messages seen", "messages", "minecraft:writable_book")
+            .increment();
+    }
+
     @NoArgsConstructor(access = AccessLevel.NONE)
     public static class HackJumpBoostSettings implements SettingsObject {
         private static final String NAMESPACE = "hack-jump-boost";

src/main/java/com/soulfiremc/pluginexample/mixin/EntityEffectStateMixin.java

@@ -32,7 +32,7 @@ public class EntityEffectStateMixin {
     @Inject(method = "tick", at = @At(value = "HEAD"))
     private void localPlayerTick(CallbackInfo ci) {
         var localPlayer = (LocalPlayer) (Object) this;
-        var botConnection = BotConnection.CURRENT.get();
+        var botConnection = BotConnection.current();
         if (botConnection.settingsSource().get(ExampleServerExtension.HackJumpBoostSettings.ENABLED)) {
             localPlayer.addEffect(new MobEffectInstance(
                 MobEffects.JUMP_BOOST,