feat: enhance AutoRegister annotation and improve ConfigManager with file initialization and reload functionality

Author: Pinont

src/main/java/com/github/pinont/singularitylib/api/annotation/AutoRegister.java

@@ -1,5 +1,8 @@
 package com.github.pinont.singularitylib.api.annotation;
 
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Target;
+
 /**
  * Annotation to mark classes for automatic registration by the plugin.
  * This annotation is used to mark classes that need to be registered during the plugin's startup process.
@@ -9,6 +12,8 @@
  * <b>Hint:</b> Use this annotation to register commands, events, or custom items.
  * It should only be used when the class extends {@code CustomItem}, {@code SimpleCommand}, or {@code Listener}.
  */
+
+@Target({ElementType.TYPE})
 public @interface AutoRegister {
     /**
      * Indicates that the annotated class should be automatically registered by the plugin.

src/main/java/com/github/pinont/singularitylib/api/manager/ConfigManager.java

@@ -12,14 +12,25 @@
 
 /**
  * Manages configuration files for the plugin.
- * This class provides functionality to create, load, save, and manipulate YAML configuration files.
+ * <p>
+ * This class provides functionality to create, load, save, reload, and manipulate YAML configuration files
+ * in the plugin's data folder or subfolders.
  */
 public class ConfigManager {
 
+    /** The configuration file on disk */
     private final File configFile;
-    private final FileConfiguration config;
+
+    /** The in-memory representation of the YAML configuration */
+    private FileConfiguration config;
+
+    /** The name of the configuration file */
     private final String fileName;
+
+    /** Reference to the plugin instance */
     private final Plugin plugin = getInstance();
+
+    /** True if the config file was just created (first load) */
     private boolean isFirstLoad;
 
     /**
@@ -29,59 +40,56 @@ public class ConfigManager {
      */
     public ConfigManager(String fileName) {
         this.fileName = fileName;
-        configFile = new File(plugin.getDataFolder(), fileName);
-        if (!configFile.exists()) {
-            try {
-                configFile.getParentFile().mkdirs();
-                configFile.createNewFile();
-                isFirstLoad = true;
-            } catch (IOException e) {
-                Bukkit.getLogger().warning(e.getMessage());
-            }
-        } else {
-            isFirstLoad = false;
-        }
-        config = YamlConfiguration.loadConfiguration(configFile);
+        this.configFile = new File(plugin.getDataFolder(), fileName);
+        initializeFile();
+        this.config = YamlConfiguration.loadConfiguration(configFile);
+    }
+
+    /**
+     * Creates a ConfigManager for a configuration file in a specific subfolder.
+     *
+     * @param subFolder the subfolder where the configuration file should be located
+     * @param fileName  the name of the configuration file
+     */
+    public ConfigManager(String subFolder, String fileName) {
+        this.fileName = fileName;
+        this.configFile = new File(plugin.getDataFolder() + "/" + subFolder, fileName);
+        initializeFile();
+        this.config = YamlConfiguration.loadConfiguration(configFile);
     }
 
     /**
      * Checks if a configuration file exists in a specific subfolder.
      *
      * @param subFolder the subfolder to check in
-     * @param fileName the name of the configuration file
+     * @param fileName  the name of the configuration file
      * @return true if the file exists, false otherwise
      */
     public static boolean isExists(String subFolder, String fileName) {
         return new File(getInstance().getDataFolder() + "/" + subFolder, fileName).exists();
     }
 
     /**
-     * Creates a ConfigManager for a configuration file in a specific subfolder.
-     *
-     * @param subFolder the subfolder where the configuration file should be located
-     * @param fileName the name of the configuration file
+     * Initializes the configuration file by creating it if it does not exist.
      */
-    public ConfigManager(String subFolder, String fileName) {
-        this.fileName = fileName;
-        configFile = new File(plugin.getDataFolder() + "/" + subFolder, fileName);
+    private void initializeFile() {
         if (!configFile.exists()) {
             try {
                 configFile.getParentFile().mkdirs();
                 configFile.createNewFile();
                 isFirstLoad = true;
             } catch (IOException e) {
-                Bukkit.getLogger().warning(e.getMessage());
+                Bukkit.getLogger().warning("Failed to create config file: " + e.getMessage());
             }
         } else {
             isFirstLoad = false;
         }
-        config = YamlConfiguration.loadConfiguration(configFile);
     }
 
     /**
      * Sets a value at the specified path in the configuration.
      *
-     * @param path the configuration path
+     * @param path  the configuration path
      * @param value the value to set
      */
     public void set(String path, Object value) {
@@ -100,14 +108,27 @@ public Object get(String path) {
 
     /**
      * Saves the configuration to the file.
-     * This method writes all changes made to the configuration back to the file.
+     * <p>
+     * Writes all changes made to the configuration back to the disk.
      */
     public void saveConfig() {
         try {
             config.save(configFile);
-            config.options().copyDefaults(true);
         } catch (IOException e) {
-            Bukkit.getLogger().warning(e.getMessage());
+            Bukkit.getLogger().warning("Failed to save config file: " + e.getMessage());
+        }
+    }
+
+    /**
+     * Reloads the configuration from disk.
+     * <p>
+     * Useful when the file is manually modified while the server is running.
+     */
+    public void reloadConfig() {
+        if (configFile.exists()) {
+            config = YamlConfiguration.loadConfiguration(configFile);
+        } else {
+            Bukkit.getLogger().warning("Config file does not exist: " + fileName);
         }
     }
 
@@ -119,7 +140,6 @@ public void saveConfig() {
     public FileConfiguration getConfig() {
         if (config == null) {
             Bukkit.getLogger().warning("An error occurred while loading the config file: " + fileName);
-            return null;
         }
         return config;
     }
@@ -132,4 +152,4 @@ public FileConfiguration getConfig() {
     public boolean isFirstLoad() {
         return isFirstLoad;
     }
-}
+}