feat: Event updates

Author: Clearedspore

build.gradle.kts

@@ -7,7 +7,7 @@ plugins {
 }
 
 group = "eu.sporedev"
-version = "10.2"
+version = "10.2.1"
 
 repositories {
     mavenCentral()

src/main/kotlin/me/clearedSpore/sporeAPI/SporePlugin.kt

@@ -5,6 +5,7 @@ import co.aikar.commands.MessageKeys
 import co.aikar.commands.PaperCommandManager
 import me.clearedSpore.sporeAPI.annotation.RegisterCommand
 import me.clearedSpore.sporeAPI.annotation.RegisterListener
+import me.clearedSpore.sporeAPI.annotation.SubscribeEvents
 import me.clearedSpore.sporeAPI.bossbar.BossBarManager
 import me.clearedSpore.sporeAPI.command.SporeCommand
 import me.clearedSpore.sporeAPI.command.SporeCommandManager
@@ -131,6 +132,9 @@ open class SporePlugin : JavaPlugin() {
         Logger.info("Scanning for listeners...")
         scanAndRegisterListeners()
 
+        Logger.info("Scanning for event subscribers...")
+        scanAndRegisterEventSubscribers()
+
         Logger.info("Registering module commands...")
 
         var moduleCount = 0
@@ -288,6 +292,38 @@ open class SporePlugin : JavaPlugin() {
         Logger.info("Auto-registered $count listener(s)")
     }
 
+    private fun scanAndRegisterEventSubscribers() {
+        val methods = SporeScanner.methodsAnnotatedWith(this, SubscribeEvents::class.java)
+        var count = 0
+
+        methods.forEach { method ->
+            try {
+                if (method.parameterCount != 0) {
+                    Logger.warn(
+                        "Method ${method.declaringClass.simpleName}#${method.name} is annotated with " +
+                            "@SubscribeEvents but takes parameters, so it cannot be auto-invoked"
+                    )
+                    return@forEach
+                }
+
+                val instance = SporeScanner.objectInstanceOrNull(method.declaringClass)
+                    ?: method.declaringClass.getDeclaredConstructor().apply { isAccessible = true }.newInstance()
+
+                method.isAccessible = true
+                method.invoke(instance)
+                count++
+
+            } catch (e: Exception) {
+                IncidentReporter.report(
+                    "event.subscribe", e,
+                    details = mapOf("class" to method.declaringClass.name, "method" to method.name)
+                )
+            }
+        }
+
+        Logger.info("Auto-invoked $count event subscriber method(s)")
+    }
+
     private fun kotlinObjectInstanceOrNull(clazz: Class<*>): Any? {
         return try {
             val field = clazz.getDeclaredField("INSTANCE")

src/main/kotlin/me/clearedSpore/sporeAPI/annotation/SubscribeEvents.kt

@@ -0,0 +1,9 @@
+package me.clearedSpore.sporeAPI.annotation
+
+// Copyright (c) 2025 ClearedSpore
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+
+@Target(AnnotationTarget.FUNCTION)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class SubscribeEvents

src/main/kotlin/me/clearedSpore/sporeAPI/scan/SporeScanner.kt

@@ -27,6 +27,9 @@ object SporeScanner {
     fun annotatedWith(plugin: JavaPlugin, annotation: Class<out Annotation>): Set<Class<*>> =
         forPlugin(plugin).getTypesAnnotatedWith(annotation)
 
+    fun methodsAnnotatedWith(plugin: JavaPlugin, annotation: Class<out Annotation>): Set<java.lang.reflect.Method> =
+        forPlugin(plugin).getMethodsAnnotatedWith(annotation)
+
     fun invalidate(plugin: JavaPlugin) {
         cache.remove(plugin.name)
     }
@@ -53,7 +56,7 @@ object SporeScanner {
         configureVfs()
 
         val builder = ConfigurationBuilder()
-            .setScanners(Scanners.TypesAnnotated, Scanners.SubTypes)
+            .setScanners(Scanners.TypesAnnotated, Scanners.SubTypes, Scanners.MethodsAnnotated)
             .addClassLoaders(plugin.javaClass.classLoader)
 
         val jarUrl = jarUrlOf(plugin)