Add ConfigDataParsedDuration annotation for loading parsed durations

Introduces the ConfigDataParsedDuration annotation to facilitate
loading duration values from configuration files. Supports string-based
durations (e.g., "5m", "1h", "30s") and allows for optional fallback
paths and default time units.

Author: BenCodez

SimpleAPI/src/main/java/com/bencodez/simpleapi/file/annotation/AnnotationHandler.java

@@ -5,9 +5,12 @@
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
+import java.util.concurrent.TimeUnit;
 
 import org.bukkit.configuration.ConfigurationSection;
 
+import com.bencodez.simpleapi.time.ParsedDuration;
+
 public class AnnotationHandler {
 
 	public AnnotationHandler() {
@@ -89,7 +92,7 @@ public void load(ConfigurationSection config, Object classToLoad) {
 
 					field.set(classToLoad, value);
 				}
-				
+
 				ConfigDataLong longAnnotation = field.getAnnotation(ConfigDataLong.class);
 				if (longAnnotation != null) {
 					long defaultValue = longAnnotation.defaultValue();
@@ -230,6 +233,40 @@ public void load(ConfigurationSection config, Object classToLoad) {
 					field.set(classToLoad, value);
 				}
 
+				ConfigDataParsedDuration durationAnnotation = field.getAnnotation(ConfigDataParsedDuration.class);
+				if (durationAnnotation != null) {
+
+					String defaultValue = durationAnnotation.defaultValue();
+
+					if (defaultValue.isEmpty()) {
+						try {
+							Object v = field.get(classToLoad);
+							if (v != null) {
+								defaultValue = v.toString();
+							}
+						} catch (Exception e) {
+
+						}
+					}
+
+					String value = "";
+
+					if (!durationAnnotation.secondPath().isEmpty()) {
+						value = config.getString(durationAnnotation.path(),
+								config.getString(durationAnnotation.secondPath(), defaultValue));
+					} else {
+						value = config.getString(durationAnnotation.path(), defaultValue);
+					}
+
+					try {
+						// Assumes ParsedDuration has a constructor or static parse method
+						Object parsedDuration = ParsedDuration.parse(value, durationAnnotation.defaultTimeUnit());
+						field.set(classToLoad, parsedDuration);
+					} catch (Exception e) {
+						e.printStackTrace();
+					}
+				}
+
 			} catch (Exception e) {
 				e.printStackTrace();
 			}

SimpleAPI/src/main/java/com/bencodez/simpleapi/file/annotation/ConfigDataParsedDuration.java

@@ -0,0 +1,41 @@
+package com.bencodez.simpleapi.file.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Inherited;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Annotation for loading ParsedDuration values from config.
+ * Supports string-based durations such as "5m", "1h", "30s".
+ */
+@Inherited
+@Target({ ElementType.METHOD, ElementType.FIELD })
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ConfigDataParsedDuration {
+
+	/**
+	 * Default value as a string (ex: "5m").
+	 *
+	 * @return default duration string
+	 */
+	String defaultValue() default "";
+
+	/**
+	 * Config path.
+	 *
+	 * @return path
+	 */
+	String path();
+
+	/**
+	 * Optional fallback path.
+	 *
+	 * @return second path
+	 */
+	String secondPath() default "";
+	
+	TimeUnit defaultTimeUnit() default TimeUnit.SECONDS;
+}