GH-884 Fix sound serdes

.github/HOW_USE_DI.md → .github/HOW_USE_TO_DI.md

@@ -109,7 +109,7 @@ public class UserCommand {
 #### 7. Subscriber
 ```java
 @Controller // <- marks a class that will be registered as an event subscriber.
-public class UserSubscriber implements Subscriber {
+public class UserSubscriber {
 
     private final UserService exampleService;
 
@@ -126,12 +126,12 @@ public class UserSubscriber implements Subscriber {
 }
 ```
 
-#### 8. BeanSetup
-BeanSetup is a class that allows you to register beans in the bean container.
+#### 8. Setup
+Setup is an annotation that allows you to register beans in the bean container.
 It is used to register dependencies that are cannot be registered in the bean container using annotations. e.g. MiniMessage, AdventureProvider, HikariDataSource, etc.
 ```java
 
-@BeanSetup // <- marks a class that will be registered as a bean holder.
+@Setup // <- marks a class that will be registered as a bean holder.
 public class UserBeanSetup {
 
     @Bean // <- marks a method that will be registered as a bean. (dependency)

buildSrc/src/main/kotlin/Versions.kt

@@ -1,10 +1,10 @@
 object Versions {
 
-    const val SPIGOT_API = "1.19.4-R0.1-SNAPSHOT"
-    const val PAPER_API = "1.19.4-R0.1-SNAPSHOT"
+    const val SPIGOT_API = "1.21.3-R0.1-SNAPSHOT"
+    const val PAPER_API = "1.21.3-R0.1-SNAPSHOT"
 
     const val ETERNALCODE_COMMONS = "1.1.5"
-    const val MULTIFICATION = "1.1.4"
+    const val MULTIFICATION = "1.2.1"
 
     const val JETBRAINS_ANNOTATIONS = "26.0.1"
     const val PLACEHOLDER_API = "2.11.6"
@@ -23,7 +23,7 @@ object Versions {
     const val ORMLITE = "6.1"
     const val HIKARI_CP = "6.0.0"
 
-    const val LITE_COMMANDS = "3.8.0"
+    const val LITE_COMMANDS = "3.9.7"
     const val LITE_SKULL_API = "1.3.0"
 
     const val GUAVA = "33.3.1-jre"
@@ -36,7 +36,6 @@ object Versions {
     const val TRIUMPH_GUI = "3.1.10"
 
     const val BSTATS = "3.1.0"
-    const val PIXEL_WIDTH = "1.1.0"
 
     const val CAFFEINE = "3.1.8"
 

buildSrc/src/main/kotlin/eternalcode-java.gradle.kts

@@ -35,5 +35,5 @@ java {
 tasks.withType<JavaCompile>() {
     options.compilerArgs = listOf("-Xlint:deprecation", "-parameters")
     options.encoding = "UTF-8"
-    options.release = 17
+    options.release = 21
 }

eternalcore-api-example/src/main/java/com/eternalcode/example/feature/home/ApiHomeListener.java

@@ -100,7 +100,7 @@ void onHomeTeleport(HomeTeleportEvent event) {
 
         player.sendMessage("Teleporting to home...");
 
-        if (player.hasPotionEffect(PotionEffectType.SLOW)) {
+        if (player.hasPotionEffect(PotionEffectType.SLOWNESS)) {
             player.sendMessage("You are slowed down!");
             player.teleport(player.getWorld().getSpawnLocation());
         }

eternalcore-api/src/main/java/com/eternalcode/core/delay/Delay.java

@@ -13,11 +13,6 @@ public class Delay<T> {
 
     private final Supplier<Duration> delaySettings;
 
-    @Deprecated
-    public Delay(DelaySettings delaySettings) {
-        this((Supplier<Duration>) () -> delaySettings.delay());
-    }
-
     public Delay(Supplier<Duration> delayProvider) {
         this.delaySettings = delayProvider;
 

eternalcore-core/src/main/java/com/eternalcode/core/EternalCore.java

@@ -1,27 +1,35 @@
 package com.eternalcode.core;
 
-import com.eternalcode.core.configuration.ReloadableConfig;
+import com.eternalcode.core.compatibility.CompatibilityService;
 import com.eternalcode.core.injector.DependencyInjector;
+import com.eternalcode.core.injector.annotations.component.Component;
+import com.eternalcode.core.injector.annotations.component.ConfigurationFile;
+import com.eternalcode.core.injector.annotations.component.Controller;
+import com.eternalcode.core.injector.annotations.component.Repository;
+import com.eternalcode.core.injector.annotations.component.Service;
+import com.eternalcode.core.injector.annotations.component.Setup;
+import com.eternalcode.core.injector.annotations.component.Task;
+import com.eternalcode.core.injector.annotations.lite.LiteArgument;
+import com.eternalcode.core.injector.annotations.lite.LiteCommandEditor;
+import com.eternalcode.core.injector.annotations.lite.LiteContextual;
+import com.eternalcode.core.injector.annotations.lite.LiteHandler;
 import com.eternalcode.core.injector.bean.BeanCandidate;
 import com.eternalcode.core.injector.bean.BeanFactory;
-import com.eternalcode.core.injector.bean.BeanHolder;
-import com.eternalcode.core.injector.bean.LazyFieldBeanCandidate;
+import com.eternalcode.core.injector.bean.BeanCandidatePriorityProvider;
 import com.eternalcode.core.injector.bean.processor.BeanProcessor;
 import com.eternalcode.core.injector.bean.processor.BeanProcessorFactory;
 import com.eternalcode.core.injector.scan.DependencyScanner;
-import com.eternalcode.core.injector.scan.DependencyScannerFactory;
 import com.eternalcode.core.publish.Publisher;
 import com.eternalcode.core.publish.event.EternalInitializeEvent;
 import com.eternalcode.core.publish.event.EternalShutdownEvent;
-import net.dzikoysk.cdn.entity.Contextual;
+import dev.rollczi.litecommands.annotations.command.Command;
+import dev.rollczi.litecommands.annotations.command.RootCommand;
 import org.bukkit.Server;
 import org.bukkit.plugin.Plugin;
 import org.bukkit.plugin.PluginDescriptionFile;
 import org.bukkit.plugin.PluginManager;
 
 import java.io.File;
-import java.lang.reflect.Field;
-import java.util.List;
 import java.util.logging.Logger;
 
 class EternalCore {
@@ -32,6 +40,7 @@ class EternalCore {
     public EternalCore(Plugin plugin) {
         this.eternalCoreEnvironment = new EternalCoreEnvironment(plugin.getLogger());
 
+        CompatibilityService compatibilityService = new CompatibilityService();
         BeanProcessor beanProcessor = BeanProcessorFactory.defaultProcessors(plugin);
         BeanFactory beanFactory = new BeanFactory(beanProcessor)
             .withCandidateSelf()
@@ -40,19 +49,35 @@ public EternalCore(Plugin plugin) {
             .addCandidate(Logger.class,                () -> plugin.getLogger())
             .addCandidate(PluginDescriptionFile.class, () -> plugin.getDescription())
             .addCandidate(File.class,                  () -> plugin.getDataFolder())
-            .addCandidate(PluginManager.class,         () -> plugin.getServer().getPluginManager());
-
-        DependencyInjector dependencyInjector = new DependencyInjector(beanFactory);
-        DependencyScanner scanner = DependencyScannerFactory.createDefault(dependencyInjector);
-
-        beanFactory.addCandidate(DependencyInjector.class, () -> dependencyInjector);
+            .addCandidate(PluginManager.class,         () -> plugin.getServer().getPluginManager())
+            .priorityProvider(new BeanCandidatePriorityProvider());
+
+        DependencyInjector injector = new DependencyInjector(beanFactory);
+        DependencyScanner scanner = new DependencyScanner(injector)
+            .includeType(type -> compatibilityService.isCompatible(type))
+            .includeAnnotations(
+                Component.class,
+                Service.class,
+                Repository.class,
+                Task.class,
+                Controller.class,
+                ConfigurationFile.class,
+                Setup.class,
+
+                Command.class,
+                RootCommand.class,
+                LiteArgument.class,
+                LiteHandler.class,
+                LiteContextual.class,
+                LiteCommandEditor.class
+            );
+
+        beanFactory.addCandidate(DependencyInjector.class, () -> injector);
 
         for (BeanCandidate beanCandidate : scanner.scan(EternalCore.class.getPackage())) {
             beanFactory.addCandidate(beanCandidate);
         }
 
-        this.loadConfigContextual(beanFactory);
-
         beanFactory.initializeCandidates();
 
         this.publisher = beanFactory.getDependency(Publisher.class);
@@ -67,22 +92,4 @@ public void disable() {
         EternalCoreApiProvider.deinitialize();
     }
 
-    private void loadConfigContextual(BeanFactory beanFactory) {
-        List<BeanHolder<ReloadableConfig>> beans = beanFactory
-            .initializeCandidates(ReloadableConfig.class)
-            .getBeans(ReloadableConfig.class);
-
-        for (BeanHolder<ReloadableConfig> bean : beans) {
-            ReloadableConfig config = bean.get();
-
-            for (Field field : config.getClass().getDeclaredFields()) {
-                if (!field.getType().isAnnotationPresent(Contextual.class)) {
-                    continue;
-                }
-
-                beanFactory.addCandidate(new LazyFieldBeanCandidate(config, field));
-            }
-        }
-    }
-
 }

eternalcore-core/src/main/java/com/eternalcode/core/bridge/BridgeManagerInitializer.java

@@ -1,13 +1,13 @@
 package com.eternalcode.core.bridge;
 
 import com.eternalcode.core.injector.annotations.Bean;
-import com.eternalcode.core.injector.annotations.component.BeanSetup;
+import com.eternalcode.core.injector.annotations.component.Setup;
 import com.eternalcode.core.placeholder.PlaceholderRegistry;
 import java.util.logging.Logger;
 import org.bukkit.Server;
 import org.bukkit.plugin.PluginDescriptionFile;
 
-@BeanSetup
+@Setup
 class BridgeManagerInitializer {
 
     @Bean

eternalcore-core/src/main/java/com/eternalcode/core/bridge/adventure/AdventureSetup.java

@@ -4,13 +4,13 @@
 import com.eternalcode.commons.adventure.AdventureLegacyColorPreProcessor;
 import com.eternalcode.commons.adventure.AdventureUrlPostProcessor;
 import com.eternalcode.core.injector.annotations.Bean;
-import com.eternalcode.core.injector.annotations.component.BeanSetup;
+import com.eternalcode.core.injector.annotations.component.Setup;
 import net.kyori.adventure.platform.AudienceProvider;
 import net.kyori.adventure.platform.bukkit.BukkitAudiences;
 import net.kyori.adventure.text.minimessage.MiniMessage;
 import org.bukkit.plugin.Plugin;
 
-@BeanSetup
+@Setup
 class AdventureSetup {
 
     @Bean

eternalcore-core/src/main/java/com/eternalcode/core/bridge/litecommand/LiteCommandsSetup.java

@@ -1,11 +1,10 @@
 package com.eternalcode.core.bridge.litecommand;
 
 import com.eternalcode.core.injector.annotations.Bean;
-import com.eternalcode.core.injector.annotations.component.BeanSetup;
+import com.eternalcode.core.injector.annotations.component.Setup;
 import com.eternalcode.core.injector.bean.BeanFactory;
 import com.eternalcode.core.notice.NoticeService;
 import com.eternalcode.core.publish.Subscribe;
-import com.eternalcode.core.publish.Subscriber;
 import com.eternalcode.core.publish.event.EternalInitializeEvent;
 import com.eternalcode.core.publish.event.EternalShutdownEvent;
 import dev.rollczi.litecommands.LiteCommands;
@@ -20,8 +19,8 @@
 import org.bukkit.command.CommandSender;
 import org.bukkit.plugin.Plugin;
 
-@BeanSetup
-class LiteCommandsSetup implements Subscriber {
+@Setup
+class LiteCommandsSetup {
 
     @Bean
     public LiteCommandsBuilder<CommandSender, ?, ?> liteCommandsBuilder(

eternalcore-core/src/main/java/com/eternalcode/core/bridge/litecommand/configurator/config/CommandConfiguration.java

@@ -2,6 +2,7 @@
 
 import com.eternalcode.core.configuration.ReloadableConfig;
 import com.eternalcode.core.feature.essentials.gamemode.GameModeArgumentSettings;
+import com.eternalcode.core.injector.annotations.Bean;
 import com.eternalcode.core.injector.annotations.component.ConfigurationFile;
 import net.dzikoysk.cdn.entity.Contextual;
 import net.dzikoysk.cdn.entity.Description;
@@ -19,6 +20,7 @@
 @ConfigurationFile
 public class CommandConfiguration implements ReloadableConfig {
 
+    @Bean
     public Argument argument = new Argument();
 
     @Contextual

eternalcore-core/src/main/java/com/eternalcode/core/bridge/metrics/BStatsMetricsSetup.java

@@ -1,14 +1,13 @@
 package com.eternalcode.core.bridge.metrics;
 
 import com.eternalcode.core.injector.annotations.component.Controller;
-import com.eternalcode.core.publish.Subscriber;
 import com.eternalcode.core.publish.event.EternalInitializeEvent;
 import com.eternalcode.core.publish.Subscribe;
 import org.bstats.bukkit.Metrics;
 import org.bukkit.plugin.java.JavaPlugin;
 
 @Controller
-class BStatsMetricsSetup implements Subscriber {
+class BStatsMetricsSetup {
 
     @Subscribe(EternalInitializeEvent.class)
     public void onInitialize(JavaPlugin javaPlugin) {

eternalcore-core/src/main/java/com/eternalcode/core/bridge/skullapi/SkullAPISetup.java

@@ -1,16 +1,15 @@
 package com.eternalcode.core.bridge.skullapi;
 
-import com.eternalcode.core.publish.Subscriber;
 import com.eternalcode.core.publish.event.EternalShutdownEvent;
 import com.eternalcode.core.injector.annotations.Bean;
-import com.eternalcode.core.injector.annotations.component.BeanSetup;
+import com.eternalcode.core.injector.annotations.component.Setup;
 import com.eternalcode.core.publish.Subscribe;
 import dev.rollczi.liteskullapi.LiteSkullFactory;
 import dev.rollczi.liteskullapi.SkullAPI;
 import org.bukkit.plugin.Plugin;
 
-@BeanSetup
-class SkullAPISetup implements Subscriber {
+@Setup
+class SkullAPISetup {
 
     @Bean
     public SkullAPI skullAPI(Plugin plugin) {

eternalcore-core/src/main/java/com/eternalcode/core/compatibility/Compatibility.java

@@ -0,0 +1,16 @@
+package com.eternalcode.core.compatibility;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.TYPE)
+public @interface Compatibility {
+
+    Version from() default @Version(minor = Integer.MIN_VALUE, patch = Integer.MIN_VALUE);
+
+    Version to() default @Version(minor = Integer.MAX_VALUE, patch = Integer.MAX_VALUE);
+
+}

eternalcore-core/src/main/java/com/eternalcode/core/compatibility/CompatibilityService.java

@@ -0,0 +1,31 @@
+package com.eternalcode.core.compatibility;
+
+import io.papermc.lib.PaperLib;
+
+public class CompatibilityService {
+
+    public boolean isCompatible(Class<?> type) {
+        Compatibility compatibility = type.getAnnotation(Compatibility.class);
+        if (compatibility == null) {
+            return true;
+        }
+
+        Version from = compatibility.from();
+        Version to = compatibility.to();
+
+        int minor = PaperLib.getMinecraftVersion();
+        int patch = PaperLib.getMinecraftPatchVersion();
+
+        return isCompatibleFrom(from, minor, patch) && isCompatibleTo(to, minor, patch);
+    }
+
+    private boolean isCompatibleTo(Version to, int minor, int patch) {
+        return minor < to.minor() || minor == to.minor() && patch <= to.patch();
+    }
+
+    private boolean isCompatibleFrom(Version from, int minor, int patch) {
+        return minor > from.minor() || minor == from.minor() && patch >= from.patch();
+    }
+
+}
+

eternalcore-core/src/main/java/com/eternalcode/core/compatibility/Version.java

@@ -0,0 +1,15 @@
+package com.eternalcode.core.compatibility;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.FIELD)
+public @interface Version {
+
+    int minor();
+    int patch();
+
+}