items;
+ private CloseListener onClose;
+ private DragListener onDrag;
/**
* Constructs a new Menu with the specified title and size.
@@ -126,27 +129,26 @@ public void open(@NotNull Player player) {
for (Button button : buttons.values()) {
if (button.isRefreshingButton()) {
- SchedulerBuilder.scheduler()
- .type(TaskType.REPEATING)
- .async(button.isRefreshingAsync())
- .after(button.refreshDelay())
- .every(button.refreshPeriod())
- .task(task -> {
- if (player.getOpenInventory().getTopInventory() != getInventory()) {
- task.cancel();
- return;
- }
-
- int slot = slotByButton(button);
-
- getInventory().clear(slot);
- getInventory().setItem(slot, button.item().build());
-
- /* player.updateInventory();
- * This probably shouldn't be used.
- */
- })
- .build();
+ Schedulers.builder(task -> {
+ if (player.getOpenInventory().getTopInventory() != getInventory()) {
+ task.cancel();
+ return;
+ }
+
+ int slot = slotByButton(button);
+
+ getInventory().clear(slot);
+ getInventory().setItem(slot, button.item().build());
+ }).config(config -> {
+ if (button.isRefreshingAsync()) {
+ config.async();
+ } else {
+ config.sync();
+ }
+
+ config.afterTicks((int) button.refreshDelay());
+ config.everyTicks((int) button.refreshPeriod());
+ }).execute();
}
}
}
@@ -210,7 +212,7 @@ public void open(@NotNull Player player) {
} else {
int callersLineNumber = Thread.currentThread().getStackTrace()[2].getLineNumber();
Utils.plugin().getLogger().log(Level.WARNING, "You can not use Menu.fill(Object filler, String... pattern) with a object different than an ItemBuilder or Button!");
- Utils.plugin().getLogger().log(Level.WARNING, " Line: [" + callersLineNumber + "], File: [" + Thread.currentThread().getStackTrace()[2].getFileName() + "]");
+ Utils.plugin().getLogger().log(Level.WARNING, " Line: [" + callersLineNumber + "], FileBuilder: [" + Thread.currentThread().getStackTrace()[2].getFileName() + "]");
}
}
}
@@ -320,4 +322,12 @@ public Inventory inventory() {
this.onDrag = onDrag;
return this;
}
+
+ public CloseListener onClose() {
+ return onClose;
+ }
+
+ public DragListener onDrag() {
+ return onDrag;
+ }
}
\ No newline at end of file
diff --git a/src/main/java/dev/manere/utils/menu/paginated/PaginatedMenu.java b/src/main/java/dev/manere/utils/menu/paginated/PaginatedMenu.java
index cfee8d5..d614b9d 100644
--- a/src/main/java/dev/manere/utils/menu/paginated/PaginatedMenu.java
+++ b/src/main/java/dev/manere/utils/menu/paginated/PaginatedMenu.java
@@ -3,11 +3,10 @@
import dev.manere.utils.item.ItemBuilder;
import dev.manere.utils.library.Utils;
import dev.manere.utils.menu.Button;
-import dev.manere.utils.menu.CloseListener;
-import dev.manere.utils.menu.DragListener;
import dev.manere.utils.menu.MenuBase;
-import dev.manere.utils.scheduler.builder.SchedulerBuilder;
-import dev.manere.utils.scheduler.builder.TaskType;
+import dev.manere.utils.menu.listener.CloseListener;
+import dev.manere.utils.menu.listener.DragListener;
+import dev.manere.utils.scheduler.Schedulers;
import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
@@ -21,29 +20,27 @@
import java.util.logging.Level;
/**
- * A {@link PaginatedMenu} class for creating paginated menus in Bukkit/Spigot.
- * This class allows you to build and manage paginated menus with customizable buttons,
- * items, and pagination controls.
+ * A {@link PaginatedMenu} class for creating paginated menus in Paper/Bukkit/Spigot.
+ *
+ * This class allows you to build and manage paginated menus with customizable buttons, items, and pagination controls.
*/
-
public class PaginatedMenu implements InventoryHolder, MenuBase {
-
- public final Inventory inventory;
- public final Component title;
- public final int size;
- public final Map buttons;
- public final Map items;
- public int totalPages;
- public int currentPage;
- public final Map previousButton;
- public final Map nextButton;
- public final Map borderMap;
- public final Map stickyButtons;
- public boolean currentPageItemEnabled;
- public ItemBuilder currentPageItem;
- public int currentPageSlot;
- public CloseListener onClose;
- public DragListener onDrag;
+ private final Inventory inventory;
+ private final Component title;
+ private final int size;
+ private final Map buttons;
+ private final Map items;
+ private int totalPages;
+ private int currentPage;
+ private final Map previousButton;
+ private final Map nextButton;
+ private final Map borderMap;
+ private final Map stickyButtons;
+ private boolean currentPageItemEnabled;
+ private ItemBuilder currentPageItem;
+ private int currentPageSlot;
+ private CloseListener onClose;
+ private DragListener onDrag;
/**
* Constructs a new PaginatedMenu with the specified title and size.
@@ -311,7 +308,7 @@ public int currentPage() {
} else {
int callersLineNumber = Thread.currentThread().getStackTrace()[2].getLineNumber();
Utils.plugin().getLogger().log(Level.WARNING, "You can not use PaginatedMenu.fill(Object filler, String... pattern) with a object different than an ItemBuilder or Button!");
- Utils.plugin().getLogger().log(Level.WARNING, " Line: [" + callersLineNumber + "], File: [" + Thread.currentThread().getStackTrace()[2].getFileName() + "]");
+ Utils.plugin().getLogger().log(Level.WARNING, " Line: [" + callersLineNumber + "], FileBuilder: [" + Thread.currentThread().getStackTrace()[2].getFileName() + "]");
}
}
}
@@ -376,30 +373,34 @@ public void open(@NotNull Player player, int page) {
if (!button.isRefreshingButton()) {
this.inventory.setItem(pageSlotHolderByButton(button).slot(), button.item().build());
} else {
- SchedulerBuilder.scheduler()
- .type(TaskType.REPEATING)
- .async(button.isRefreshingAsync())
- .after(button.refreshDelay())
- .every(button.refreshPeriod())
- .task(task -> {
- if (player.getOpenInventory().getTopInventory() != getInventory()) {
- task.cancel();
- return;
- }
-
- if (pageSlotHolderByButton(button).page() != currentPage) {
- task.cancel();
- return;
- }
-
- int slot = pageSlotHolderByButton(button).slot();
-
- getInventory().clear(slot);
- getInventory().setItem(slot, button.item().name(button.item().build().displayName()).build());
-
- player.updateInventory();
- })
- .build();
+ Schedulers.builder(task -> {
+ if (player.getOpenInventory().getTopInventory() != getInventory()) {
+ task.cancel();
+ return;
+ }
+
+ if (pageSlotHolderByButton(button).page() != currentPage) {
+ task.cancel();
+ return;
+ }
+
+ int slot = pageSlotHolderByButton(button).slot();
+
+ getInventory().clear(slot);
+ getInventory().setItem(slot, button.item().name(button.item().build().displayName()).build());
+
+ player.updateInventory();
+ }).config(config -> {
+ if (button.isRefreshingAsync()) {
+ config.async();
+ } else {
+ config.sync();
+ }
+
+ config.afterTicks((int) button.refreshDelay());
+ config.everyTicks((int) button.refreshPeriod());
+ })
+ .execute();
}
}
}
@@ -623,4 +624,24 @@ public Inventory inventory() {
this.onDrag = onDrag;
return this;
}
+
+ public CloseListener onClose() {
+ return onClose;
+ }
+
+ public DragListener onDrag() {
+ return onDrag;
+ }
+
+ public boolean currentPageItemEnabled() {
+ return currentPageItemEnabled;
+ }
+
+ public ItemBuilder currentPageItem() {
+ return currentPageItem;
+ }
+
+ public int currentPageSlot() {
+ return currentPageSlot;
+ }
}
\ No newline at end of file
diff --git a/src/main/java/dev/manere/utils/menu/paginated/PaginatedSlot.java b/src/main/java/dev/manere/utils/menu/paginated/PaginatedSlot.java
index 698868a..4e7e634 100644
--- a/src/main/java/dev/manere/utils/menu/paginated/PaginatedSlot.java
+++ b/src/main/java/dev/manere/utils/menu/paginated/PaginatedSlot.java
@@ -5,6 +5,10 @@
/**
* The PaginatedSlot record represents a holder for a slot and page number in a menu system.
* It is used to associate a specific slot on a page within a menu.
+ *
+ * Slots start at 0 and end at the page slot size (usually 27/36/45/54).
+ *
+ * Pages start at 1.
*/
public record PaginatedSlot(int slot, int page) {
public static @NotNull PaginatedSlot paginatedSlot(int slot, int page) {
diff --git a/src/main/java/dev/manere/utils/message/ActionBarMessager.java b/src/main/java/dev/manere/utils/message/ActionBarMessager.java
index 16fc558..38ec87b 100644
--- a/src/main/java/dev/manere/utils/message/ActionBarMessager.java
+++ b/src/main/java/dev/manere/utils/message/ActionBarMessager.java
@@ -55,8 +55,8 @@ public void clear() {
* @param after The delay before the first message is sent (in ticks).
* @param every The interval between subsequent messages (in ticks).
*/
- public void send(@NotNull Component text, long after, long every) {
- Schedulers.async().repeating(task -> send(text), after, every);
+ public void send(@NotNull Component text, int after, int every) {
+ Schedulers.async().execute(task -> send(text), after, every);
}
/**
diff --git a/src/main/java/dev/manere/utils/message/Messagers.java b/src/main/java/dev/manere/utils/message/Messagers.java
index 56bff5e..4ebc048 100644
--- a/src/main/java/dev/manere/utils/message/Messagers.java
+++ b/src/main/java/dev/manere/utils/message/Messagers.java
@@ -7,7 +7,6 @@
* Utility class for obtaining instances of message senders.
*/
public class Messagers {
-
/**
* Creates an instance of ActionBarMessager for a specific player.
*
diff --git a/src/main/java/dev/manere/utils/misc/Buildable.java b/src/main/java/dev/manere/utils/misc/Buildable.java
new file mode 100644
index 0000000..cb6c33d
--- /dev/null
+++ b/src/main/java/dev/manere/utils/misc/Buildable.java
@@ -0,0 +1,12 @@
+package dev.manere.utils.misc;
+
+/**
+ * The {@code Buildable} interface represents an object that can be built or constructed.
+ * Classes implementing this interface should provide a method to initiate the building process.
+ */
+public interface Buildable {
+ /**
+ * Initiates the building process for the object.
+ */
+ void build();
+}
diff --git a/src/main/java/dev/manere/utils/misc/FluentBuilder.java b/src/main/java/dev/manere/utils/misc/FluentBuilder.java
new file mode 100644
index 0000000..e38d371
--- /dev/null
+++ b/src/main/java/dev/manere/utils/misc/FluentBuilder.java
@@ -0,0 +1,16 @@
+package dev.manere.utils.misc;
+
+/**
+ * The {@code FluentBuilder} class is an abstract class representing a fluent builder pattern.
+ * Classes extending this abstract class should implement the build method to create an object of a specified type.
+ *
+ * @param The type of object that the builder constructs.
+ */
+public abstract class FluentBuilder {
+ /**
+ * Constructs and returns an object of the specified type.
+ *
+ * @return The constructed object.
+ */
+ public abstract R build();
+}
diff --git a/src/main/java/dev/manere/utils/misc/ObjectUtils.java b/src/main/java/dev/manere/utils/misc/ObjectUtils.java
new file mode 100644
index 0000000..dd6f4ef
--- /dev/null
+++ b/src/main/java/dev/manere/utils/misc/ObjectUtils.java
@@ -0,0 +1,156 @@
+package dev.manere.utils.misc;
+
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.function.Consumer;
+import java.util.function.Predicate;
+import java.util.function.Supplier;
+
+/**
+ * Utility class for common object-related operations, including null checks and validation.
+ */
+public class ObjectUtils {
+ /**
+ * Ensures that the specified value is not null.
+ *
+ * @param value The value to check for null.
+ * @param The type of the value.
+ * @return The non-null value.
+ * @throws NullPointerException if the value is null.
+ */
+ @CanIgnoreReturnValue
+ public static T nonNull(@Nullable T value) {
+ if (value == null) throw new NullPointerException();
+ return value;
+ }
+
+ /**
+ * Ensures that the specified value is not null.
+ *
+ * @param value The value to check for null.
+ * @param text The exception message if the value is null.
+ * @param The type of the value.
+ * @return The non-null value.
+ * @throws NullPointerException if the value is null.
+ */
+ @CanIgnoreReturnValue
+ public static T nonNull(@Nullable T value, @NotNull String text) {
+ if (value == null) throw new NullPointerException(text);
+ return value;
+ }
+
+ /**
+ * Provides a default value if the specified value is null.
+ *
+ * @param value The value to check for null.
+ * @param defaultValue The default value to return if the original value is null.
+ * @param The type of the value.
+ * @return The original value if not null, otherwise the default value.
+ */
+ public static T defaultIfNull(@Nullable T value, T defaultValue) {
+ return (value != null) ? value : defaultValue;
+ }
+
+ /**
+ * Executes the specified action if the value is not null.
+ *
+ * @param value The value to check for null.
+ * @param action The action to perform on the non-null value.
+ * @param The type of the value.
+ */
+ public static void ifNonNull(@Nullable T value, Consumer action) {
+ if (value != null) {
+ action.accept(value);
+ }
+ }
+
+ /**
+ * Ensures that the specified value is not null, throwing a custom exception if it is.
+ *
+ * @param value The value to check for null.
+ * @param exceptionSupplier A supplier providing the exception to be thrown if the value is null.
+ * @param The type of the value.
+ * @param The type of the exception.
+ * @return The non-null value.
+ * @throws E if the value is null.
+ */
+ @CanIgnoreReturnValue
+ public static T nonNull(@Nullable T value, Supplier exceptionSupplier) {
+ if (value == null) throw exceptionSupplier.get();
+ return value;
+ }
+
+ /**
+ * Ensures that the specified collection is not null and does not contain null elements.
+ *
+ * @param collection The collection to check for null and null elements.
+ * @param The type of elements in the collection.
+ * @return The non-null and non-contain-null-elements collection.
+ * @throws NullPointerException if the collection is null or contains null elements.
+ */
+ @CanIgnoreReturnValue
+ public static Collection nonNullElements(@Nullable Collection collection) {
+ if (collection == null || collection.contains(null)) throw new NullPointerException("Collection contains null elements");
+ return collection;
+ }
+
+ /**
+ * Ensures that the specified string is not null or empty.
+ *
+ * @param value The string to check for null or empty.
+ * @param fieldName The name of the field being checked.
+ * @return The non-null and non-empty string.
+ * @throws IllegalArgumentException if the string is null or empty.
+ */
+ @CanIgnoreReturnValue
+ public static String nonEmpty(@Nullable String value, @NotNull String fieldName) {
+ if (value == null || value.trim().isEmpty()) throw new IllegalArgumentException(fieldName + " must not be empty");
+ return value;
+ }
+
+ /**
+ * Provides an empty collection if the specified collection is null.
+ *
+ * @param collection The collection to check for null.
+ * @param The type of elements in the collection.
+ * @return The original collection if not null, otherwise an empty collection.
+ */
+ public static Collection emptyIfNull(@Nullable Collection collection) {
+ return (collection != null) ? collection : Collections.emptyList();
+ }
+
+ /**
+ * Checks the specified value against a predicate, throwing an exception if the check fails.
+ *
+ * @param value The value to check.
+ * @param predicate The predicate to test the value against.
+ * @param errorMessage The error message to include in the exception if the check fails.
+ * @param The type of the value.
+ * @return The original value if the check passes.
+ * @throws IllegalArgumentException if the check fails.
+ */
+ @CanIgnoreReturnValue
+ public static T check(@Nullable T value, Predicate predicate, String errorMessage) {
+ if (!predicate.test(value)) throw new IllegalArgumentException(errorMessage);
+ return value;
+ }
+
+ /**
+ * Ensures that the specified integer is non-negative.
+ *
+ * @param value The integer value to check.
+ * @param errorMessage The error message to include in the exception if the check fails.
+ * @return The original value if it is non-negative.
+ * @throws IllegalArgumentException if the value is negative.
+ */
+ public static int requireNonNegative(int value, String errorMessage) {
+ if (value < 0) {
+ throw new IllegalArgumentException(errorMessage);
+ }
+ return value;
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/dev/manere/utils/misc/Storable.java b/src/main/java/dev/manere/utils/misc/Storable.java
new file mode 100644
index 0000000..00ea88a
--- /dev/null
+++ b/src/main/java/dev/manere/utils/misc/Storable.java
@@ -0,0 +1,23 @@
+package dev.manere.utils.misc;
+
+/**
+ * The {@code Storable} interface defines methods for serializing an object to a string and deserializing from a string.
+ *
+ * @param The type of object to be serialized and deserialized.
+ */
+public interface Storable {
+ /**
+ * Serializes the object to a string representation.
+ *
+ * @return A string representation of the serialized object.
+ */
+ String serialize();
+
+ /**
+ * Deserializes the object from a string representation.
+ *
+ * @param serialized the object to be deserialized.
+ * @return The deserialized object.
+ */
+ T deserialize(String serialized);
+}
diff --git a/src/main/java/dev/manere/utils/model/Duo.java b/src/main/java/dev/manere/utils/model/Tuple.java
similarity index 84%
rename from src/main/java/dev/manere/utils/model/Duo.java
rename to src/main/java/dev/manere/utils/model/Tuple.java
index 8008f0f..4a6eb51 100644
--- a/src/main/java/dev/manere/utils/model/Duo.java
+++ b/src/main/java/dev/manere/utils/model/Tuple.java
@@ -9,7 +9,7 @@
* @param The key type
* @param The value type
*/
-public class Duo {
+public class Tuple {
private K key;
private V val;
@@ -19,7 +19,7 @@ public class Duo {
* @param key The key
* @param val The value
*/
- public Duo(@Nullable K key, @Nullable V val) {
+ public Tuple(@Nullable K key, @Nullable V val) {
this.key = key;
this.val = val;
}
@@ -33,8 +33,8 @@ public Duo(@Nullable K key, @Nullable V val) {
* @param val The value
* @return A new tuple with the specified key and value
*/
- public static @NotNull Duo of(@Nullable K key, @Nullable V val) {
- return new Duo<>(key, val);
+ public static @NotNull Tuple duo(@Nullable K key, @Nullable V val) {
+ return new Tuple<>(key, val);
}
/**
@@ -55,7 +55,7 @@ public Duo(@Nullable K key, @Nullable V val) {
* @param key The new key
* @return This tuple instance
*/
- public @NotNull Duo key(@Nullable K key) {
+ public @NotNull Tuple key(@Nullable K key) {
this.key = key;
return this;
}
@@ -66,7 +66,7 @@ public Duo(@Nullable K key, @Nullable V val) {
* @param val The new value
* @return This tuple instance
*/
- public @NotNull Duo val(@Nullable V val) {
+ public @NotNull Tuple val(@Nullable V val) {
this.val = val;
return this;
}
diff --git a/src/main/java/dev/manere/utils/papi/PlaceholderAPIBuilder.java b/src/main/java/dev/manere/utils/papi/PlaceholderAPIBuilder.java
index 8e8a706..dcde5c4 100644
--- a/src/main/java/dev/manere/utils/papi/PlaceholderAPIBuilder.java
+++ b/src/main/java/dev/manere/utils/papi/PlaceholderAPIBuilder.java
@@ -11,7 +11,6 @@
import java.util.function.BiFunction;
public class PlaceholderAPIBuilder {
-
private final String prefix;
private String author;
private String version;
@@ -23,7 +22,8 @@ public class PlaceholderAPIBuilder {
*
* @param prefix The identifier for the PlaceholderAPI expansion.
*/
- /* I hate you paper (why would you deprecate JavaPlugin#getDescription() and then make the alternative (PluginMeta) "unstable" */
+ /* I hate you paper (why would you deprecate JavaPlugin#getDescription()
+ and then make the alternative (PluginMeta) "unstable" */
@SuppressWarnings("UnstableApiUsage")
public PlaceholderAPIBuilder(@NotNull String prefix) {
this.prefix = prefix;
@@ -96,7 +96,10 @@ public PlaceholderAPIBuilder(@NotNull String prefix) {
* @param offlineResult The function to handle placeholder requests for offline players.
* @return The updated PlaceholderAPIBuilder instance.
*/
- public @NotNull PlaceholderAPIBuilder request(@Nullable BiFunction onlineResult, @Nullable BiFunction offlineResult) {
+ public @NotNull PlaceholderAPIBuilder request(
+ @Nullable BiFunction onlineResult,
+ @Nullable BiFunction offlineResult
+ ) {
this.playerResult = onlineResult;
this.offlinePlayerResult = offlineResult;
return this;
diff --git a/src/main/java/dev/manere/utils/pdc/UUIDDataType.java b/src/main/java/dev/manere/utils/pdc/UUIDDataType.java
new file mode 100644
index 0000000..e944e6c
--- /dev/null
+++ b/src/main/java/dev/manere/utils/pdc/UUIDDataType.java
@@ -0,0 +1,79 @@
+package dev.manere.utils.pdc;
+
+import org.bukkit.persistence.PersistentDataAdapterContext;
+import org.bukkit.persistence.PersistentDataType;
+import org.jetbrains.annotations.NotNull;
+
+import java.nio.ByteBuffer;
+import java.util.UUID;
+
+/**
+ * A custom implementation of {@link PersistentDataType} for converting between byte arrays and UUIDs.
+ * This implementation is used for data persistence in Paper/Spigot/Bukkit plugins.
+ *
+ * @see PersistentDataType
+ */
+public class UUIDDataType implements PersistentDataType {
+ /**
+ * Creates a new instance of UUIDDataType.
+ *
+ * @return A new instance of UUIDDataType.
+ */
+ public static UUIDDataType of() {
+ return new UUIDDataType();
+ }
+
+ /**
+ * Gets the primitive type associated with this data type.
+ *
+ * @return The primitive type (byte array).
+ */
+ @Override
+ public @NotNull Class getPrimitiveType() {
+ return byte[].class;
+ }
+
+ /**
+ * Gets the complex type associated with this data type.
+ *
+ * @return The complex type (UUID).
+ */
+ @Override
+ public @NotNull Class getComplexType() {
+ return UUID.class;
+ }
+
+ /**
+ * Converts a UUID to a byte array.
+ *
+ * @param complex The UUID to convert.
+ * @param context The PersistentDataAdapterContext.
+ * @return The byte array representation of the UUID.
+ */
+ @Override
+ public byte @NotNull [] toPrimitive(UUID complex, @NotNull PersistentDataAdapterContext context) {
+ ByteBuffer byteBuffer = ByteBuffer.wrap(new byte[16]);
+
+ byteBuffer.putLong(complex.getMostSignificantBits());
+ byteBuffer.putLong(complex.getLeastSignificantBits());
+
+ return byteBuffer.array();
+ }
+
+ /**
+ * Converts a byte array to a UUID.
+ *
+ * @param primitive The byte array to convert.
+ * @param context The PersistentDataAdapterContext.
+ * @return The UUID representation of the byte array.
+ */
+ @Override
+ public @NotNull UUID fromPrimitive(byte @NotNull [] primitive, @NotNull PersistentDataAdapterContext context) {
+ ByteBuffer byteBuffer = ByteBuffer.wrap(primitive);
+
+ long firstLong = byteBuffer.getLong();
+ long secondLong = byteBuffer.getLong();
+
+ return new UUID(firstLong, secondLong);
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/dev/manere/utils/player/cache/CacheInfo.java b/src/main/java/dev/manere/utils/player/cache/CacheInfo.java
deleted file mode 100644
index 49e6819..0000000
--- a/src/main/java/dev/manere/utils/player/cache/CacheInfo.java
+++ /dev/null
@@ -1,27 +0,0 @@
-package dev.manere.utils.player.cache;
-
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-/**
- * Represents information used for caching values in the player cache.
- *
- * @param target The player for whom the cache is created.
- * @param identifier The identifier for the cached value.
- * @param val The value to be cached.
- */
-public record CacheInfo(@NotNull Player target, @NotNull CacheKey identifier, @Nullable Object val) {
-
- /**
- * Creates a new CacheInfo instance with the specified player, identifier, and value.
- *
- * @param target The player for whom the cache is created.
- * @param identifier The identifier for the cached value.
- * @param val The value to be cached.
- * @return A new CacheInfo instance.
- */
- public static @NotNull CacheInfo of(@NotNull Player target, @NotNull CacheKey identifier, @Nullable Object val) {
- return new CacheInfo(target, identifier, val);
- }
-}
diff --git a/src/main/java/dev/manere/utils/player/cache/CacheKey.java b/src/main/java/dev/manere/utils/player/cache/CacheKey.java
deleted file mode 100644
index 2383926..0000000
--- a/src/main/java/dev/manere/utils/player/cache/CacheKey.java
+++ /dev/null
@@ -1,39 +0,0 @@
-package dev.manere.utils.player.cache;
-
-import dev.manere.utils.library.Utils;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * Represents a key used for identifying cached values in the player cache.
- */
-public class CacheKey {
- private final String name;
-
- /**
- * Creates a new CacheKey instance with the specified name.
- *
- * @param name The name used to create the identifier for the cache key.
- */
- public CacheKey(@NotNull String name) {
- this.name = Utils.plugin().getName() + name.replaceAll(" ", "_").toUpperCase();
- }
-
- /**
- * Creates a new CacheKey instance with the specified name.
- *
- * @param name The name used to create the identifier for the cache key.
- * @return A new CacheKey instance.
- */
- public static @NotNull CacheKey key(@NotNull String name) {
- return new CacheKey(name);
- }
-
- /**
- * Gets the identifier generated based on the name.
- *
- * @return The identifier for the cache key.
- */
- public @NotNull String identifier() {
- return this.name;
- }
-}
diff --git a/src/main/java/dev/manere/utils/player/cache/CacheVal.java b/src/main/java/dev/manere/utils/player/cache/CacheVal.java
deleted file mode 100644
index ae1c4c2..0000000
--- a/src/main/java/dev/manere/utils/player/cache/CacheVal.java
+++ /dev/null
@@ -1,102 +0,0 @@
-package dev.manere.utils.player.cache;
-
-import dev.manere.utils.text.Text;
-
-/**
- * Represents a cached value in the player cache.
- *
- * @param val The cached value.
- */
-public record CacheVal(Object val) {
-
- /**
- * Creates a new CacheVal instance with the specified value.
- *
- * @param val The value to be wrapped in a CacheVal instance.
- * @return A new CacheVal instance.
- */
- public static CacheVal cached(Object val) {
- return new CacheVal(val);
- }
-
- /**
- * Returns the value stored as an Object.
- *
- * @return the value stored as an Object.
- */
- public Object asObject() {
- return val;
- }
-
- /**
- * Converts the cached value to a Text.
- *
- * @return A Text instance representing the cached value.
- */
- public Text asText() {
- return Text.text((String) val);
- }
-
- /**
- * Converts the cached value to a boolean.
- *
- * @return A boolean instance representing the cached value.
- */
- public boolean asBoolean() {
- return (boolean) val;
- }
-
- /**
- * Converts the cached value to a byte.
- *
- * @return A byte instance representing the cached value.
- */
- public byte asByte() {
- return (byte) val;
- }
-
- /**
- * Converts the cached value to a double.
- *
- * @return A double instance representing the cached value.
- */
- public double asDouble() {
- return (double) val;
- }
-
- /**
- * Converts the cached value to a float.
- *
- * @return A float instance representing the cached value.
- */
- public float asFloat() {
- return (float) val;
- }
-
- /**
- * Converts the cached value to an int.
- *
- * @return An int instance representing the cached value.
- */
- public int asInt() {
- return (int) val;
- }
-
- /**
- * Converts the cached value to a long.
- *
- * @return A long instance representing the cached value.
- */
- public long asLong() {
- return (long) val;
- }
-
- /**
- * Converts the cached value to a short.
- *
- * @return A short instance representing the cached value.
- */
- public short asShort() {
- return (short) val;
- }
-}
diff --git a/src/main/java/dev/manere/utils/player/cache/PlayerCache.java b/src/main/java/dev/manere/utils/player/cache/PlayerCache.java
deleted file mode 100644
index 6404c6b..0000000
--- a/src/main/java/dev/manere/utils/player/cache/PlayerCache.java
+++ /dev/null
@@ -1,142 +0,0 @@
-package dev.manere.utils.player.cache;
-
-import dev.manere.utils.library.Utils;
-import org.bukkit.entity.Player;
-import org.bukkit.metadata.FixedMetadataValue;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-/**
- * Represents a cache for player-related information using metadata in Bukkit.
- * This class provides methods for caching, retrieving, and checking for specific values.
- *
- * @param target The player for whom the cache is created.
- */
-public record PlayerCache(@NotNull Player target) {
-
- /**
- * Creates a new PlayerCache instance for the specified player.
- *
- * @param player The player to create a cache for.
- * @return A new PlayerCache instance.
- */
- public static @NotNull PlayerCache cacheOf(Player player) {
- return new PlayerCache(player);
- }
-
- /**
- * Caches a value for the specified player with a given identifier.
- *
- * @param target The player to cache the value for.
- * @param identifier The identifier for the cached value.
- * @param val The value to cache.
- * @return True if the value was successfully cached, false otherwise.
- */
- public static boolean cache(@NotNull Player target, @NotNull CacheKey identifier, @Nullable Object val) {
- if (!target.getMetadata(identifier.identifier()).isEmpty()) {
- return false;
- }
-
- target.getMetadata(identifier.identifier()).add(new FixedMetadataValue(Utils.plugin(), val));
- return true;
- }
-
- /**
- * Caches a value for the specified player using information from a CacheInfo instance.
- *
- * @param info The CacheInfo instance containing target player, identifier, and value.
- * @return True if the value was successfully cached, false otherwise.
- */
- public static boolean cache(@NotNull CacheInfo info) {
- return cache(info.target(), info.identifier(), info.val());
- }
-
- /**
- * Retrieves a cached value for the specified player and identifier.
- *
- * @param target The player to retrieve the cached value for.
- * @param identifier The identifier for the cached value.
- * @return A CacheVal instance representing the cached value.
- */
- public static CacheVal retrieve(@NotNull Player target, @NotNull CacheKey identifier) {
- return CacheVal.cached(target.getMetadata(identifier.identifier()).get(0).value());
- }
-
- /**
- * Checks if the specified player has a cached value with the given identifier and value.
- *
- * @param target The player to check for the cached value.
- * @param identifier The identifier for the cached value.
- * @param val The value to check for.
- * @return True if the player has the specified cached value, false otherwise.
- */
- public static boolean has(@NotNull Player target, @NotNull CacheKey identifier, @Nullable Object val) {
- return target.getMetadata(identifier.identifier()).contains(new FixedMetadataValue(Utils.plugin(), val));
- }
-
- /**
- * Checks if the specified player has a cached value using information from a CacheInfo instance.
- *
- * @param info The CacheInfo instance containing target player, identifier, and value.
- * @return True if the player has the specified cached value, false otherwise.
- */
- public static boolean has(@NotNull CacheInfo info) {
- return has(info.target(), info.identifier(), info.val());
- }
-
- /**
- * Caches a value for the current instance's player with a given identifier.
- *
- * @param identifier The identifier for the cached value.
- * @param val The value to cache.
- * @return True if the value was successfully cached, false otherwise.
- */
- public boolean cache(@NotNull CacheKey identifier, @Nullable Object val) {
- if (!target.getMetadata(identifier.identifier()).isEmpty()) {
- return false;
- }
-
- target.getMetadata(identifier.identifier()).add(new FixedMetadataValue(Utils.plugin(), val));
- return true;
- }
-
- /**
- * Retrieves a cached value for the current instance's player and identifier.
- *
- * @param identifier The identifier for the cached value.
- * @return A CacheVal instance representing the cached value.
- */
- public CacheVal retrieve(@NotNull CacheKey identifier) {
- return CacheVal.cached(target.getMetadata(identifier.identifier()).get(0).value());
- }
-
- /**
- * Checks if the current instance's player has a cached value with the given identifier and value.
- *
- * @param identifier The identifier for the cached value.
- * @param val The value to check for.
- * @return True if the player has the specified cached value, false otherwise.
- */
- public boolean has(@NotNull CacheKey identifier, @Nullable Object val) {
- return target.getMetadata(identifier.identifier()).contains(new FixedMetadataValue(Utils.plugin(), val));
- }
-
- /**
- * Deletes a cached value for the specified player and identifier.
- *
- * @param target The player to delete the cached value for.
- * @param identifier The identifier for the cached value to delete.
- */
- public static void delete(@NotNull Player target, @NotNull CacheKey identifier) {
- target.removeMetadata(identifier.identifier(), Utils.plugin());
- }
-
- /**
- * Deletes a cached value for the current instance's player and identifier.
- *
- * @param identifier The identifier for the cached value to delete.
- */
- public void delete(@NotNull CacheKey identifier) {
- target.removeMetadata(identifier.identifier(), Utils.plugin());
- }
-}
diff --git a/src/main/java/dev/manere/utils/prettify/ListPrettify.java b/src/main/java/dev/manere/utils/prettify/ListPrettify.java
index 67fd971..52d95ad 100644
--- a/src/main/java/dev/manere/utils/prettify/ListPrettify.java
+++ b/src/main/java/dev/manere/utils/prettify/ListPrettify.java
@@ -15,7 +15,6 @@
* To: a, b, c, d
*/
public class ListPrettify {
-
/**
* Converts a List of Strings into a single comma-separated String.
*
diff --git a/src/main/java/dev/manere/utils/reflection/ReflectionUtils.java b/src/main/java/dev/manere/utils/reflection/ReflectionUtils.java
index 5904b25..2c69567 100644
--- a/src/main/java/dev/manere/utils/reflection/ReflectionUtils.java
+++ b/src/main/java/dev/manere/utils/reflection/ReflectionUtils.java
@@ -13,7 +13,6 @@
* A utility class providing methods for reflection-related tasks.
*/
public class ReflectionUtils {
-
public static final String NM_PACKAGE = "net.minecraft";
public static final String CRAFTBUKKIT_PACKAGE = "org.bukkit.craftbukkit";
public static final String NMS_PACKAGE = NM_PACKAGE + ".server";
@@ -22,6 +21,10 @@ public class ReflectionUtils {
private static final boolean NMS_REPACKAGED = optionalClass(NM_PACKAGE + ".network.protocol.Packet").isPresent();
private static volatile Object theUnsafe;
+ public static boolean compare(Class a, Class b) {
+ return a.getCanonicalName().equals(b.getCanonicalName());
+ }
+
/**
* Checks if the net.minecraft server package has been repackaged.
*
diff --git a/src/main/java/dev/manere/utils/registration/Registrar.java b/src/main/java/dev/manere/utils/registration/Registrar.java
index c033507..004c5e7 100644
--- a/src/main/java/dev/manere/utils/registration/Registrar.java
+++ b/src/main/java/dev/manere/utils/registration/Registrar.java
@@ -1,12 +1,12 @@
package dev.manere.utils.registration;
-import dev.manere.utils.command.CommandType;
+import dev.manere.utils.command.CommandTypes;
import dev.manere.utils.command.Commander;
import dev.manere.utils.command.args.Argument;
-import dev.manere.utils.command.builder.CommandBuilder;
-import dev.manere.utils.command.builder.CommandBuilderHandler;
-import dev.manere.utils.command.builder.dispatcher.CommandContext;
-import dev.manere.utils.command.builder.permission.CommandPermission;
+import dev.manere.utils.command.impl.Commands;
+import dev.manere.utils.command.impl.CommandsRegistrar;
+import dev.manere.utils.command.impl.dispatcher.CommandContext;
+import dev.manere.utils.command.impl.permission.CommandPermission;
import dev.manere.utils.library.Utils;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
@@ -25,7 +25,6 @@
* A utility class for registering various components in a Bukkit plugin.
*/
public class Registrar {
-
/**
* Registers a listener with the provided plugin.
*
@@ -119,7 +118,7 @@ public static void commandMap(@NotNull String commandName, @NotNull Command comm
*/
@SuppressWarnings("DataFlowIssue")
public static void command(@NotNull Commander commander) {
- if (commander.settings().type() == CommandType.COMMAND_MAP) {
+ if (commander.settings().type().type() == CommandTypes.COMMAND_MAP.type()) {
Registrar.command(
commander,
commander.aliases(),
@@ -130,7 +129,9 @@ public static void command(@NotNull Commander commander) {
return;
}
- if (commander.settings().type() == CommandType.PLUGIN_YML && Utils.plugin().getCommand(commander.name()) == null) {
+ if (commander.settings().type().type() == CommandTypes.PLUGIN_YML.type()
+ && Utils.plugin().getCommand(commander.name()) == null)
+ {
throw new NullPointerException("You seem to have forgotten to provide the command '" + commander.name() + "' " +
"in the plugin.yml file inside of your project.");
}
@@ -156,7 +157,7 @@ public static void command(@NotNull Commander commander) {
* @see Commander
*/
public static void command(@NotNull Commander commander, @Nullable List aliases, @Nullable String description, @Nullable String permission, @Nullable String usage) {
- CommandBuilder builder = CommandBuilder.command(commander.name(), commander.settings().type());
+ Commands builder = Commands.command(commander.name(), commander.settings().type());
if (aliases != null && !aliases.isEmpty()) {
builder.aliases().aliases(aliases).build();
@@ -184,8 +185,8 @@ public static void command(@NotNull Commander commander, @Nullable List
}
@SuppressWarnings("DataFlowIssue")
- public static void commandMap(CommandBuilderHandler handler) {
- CommandBuilder builder = handler.commandBuilder();
+ public static void commandMap(CommandsRegistrar handler) {
+ Commands builder = handler.commandBuilder();
Command command = new Command(builder.name(), builder.description(), builder.usage(), builder.aliases().aliases()) {
@@ -230,6 +231,6 @@ public boolean execute(@NotNull CommandSender sender, @NotNull String label, @No
command.permissionMessage(builder.command().permissionMessage());
}
- Registrar.commandMap().register(builder.command().getName(), Utils.plugin().getName(), command);
+ Registrar.commandMap().register(builder.command().getName(), builder.namespace(), command);
}
}
diff --git a/src/main/java/dev/manere/utils/resource/ResourceBuilder.java b/src/main/java/dev/manere/utils/resource/ResourceBuilder.java
new file mode 100644
index 0000000..afe9f2a
--- /dev/null
+++ b/src/main/java/dev/manere/utils/resource/ResourceBuilder.java
@@ -0,0 +1,127 @@
+package dev.manere.utils.resource;
+
+import dev.manere.utils.resource.format.ResourceFormat;
+import dev.manere.utils.resource.format.ResourceFormats;
+import dev.manere.utils.resource.path.ResourcePath;
+import dev.manere.utils.resource.path.ResourcePaths;
+
+import java.util.function.Consumer;
+
+/**
+ * A builder class for creating instances of {@link ResourceFile}. Allows customization
+ * of the resource file's format, options, name, and path before building the resource.
+ */
+public class ResourceBuilder {
+ private ResourceFormat format;
+ private final ResourceOptions options;
+ private ResourcePath path;
+ private String name;
+
+ /**
+ * Constructs a new ResourceBuilder with default settings.
+ */
+ public ResourceBuilder() {
+ this.format = ResourceFormats.yaml();
+ this.options = new ResourceOptions();
+ this.name = null;
+ this.path = ResourcePaths.plugin();
+ }
+
+ /**
+ * Returns a new instance of ResourceBuilder.
+ *
+ * @return A new ResourceBuilder instance.
+ */
+ public static ResourceBuilder builder() {
+ return new ResourceBuilder();
+ }
+
+ /**
+ * Gets the current resource format.
+ *
+ * @return The current resource format.
+ */
+ public ResourceFormat format() {
+ return format;
+ }
+
+ /**
+ * Sets the resource format for the builder.
+ *
+ * @param format The desired resource format.
+ * @return The current ResourceBuilder instance for method chaining.
+ */
+ public ResourceBuilder format(ResourceFormat format) {
+ this.format = format;
+ return this;
+ }
+
+ /**
+ * Gets the current resource options.
+ *
+ * @return The current resource options.
+ */
+ public ResourceOptions options() {
+ return options;
+ }
+
+ /**
+ * Configures the resource options using the provided consumer.
+ *
+ * @param optionsConsumer A consumer for configuring resource options.
+ * @return The current ResourceBuilder instance for method chaining.
+ */
+ public ResourceBuilder options(Consumer optionsConsumer) {
+ optionsConsumer.accept(this.options);
+ return this;
+ }
+
+ /**
+ * Gets the current resource name.
+ *
+ * @return The current resource name.
+ */
+ public String name() {
+ return name;
+ }
+
+ /**
+ * Sets the resource name for the builder.
+ *
+ * @param name The desired resource name.
+ * @return The current ResourceBuilder instance for method chaining.
+ */
+ public ResourceBuilder name(String name) {
+ this.name = name;
+ return this;
+ }
+
+ /**
+ * Gets the current resource path.
+ *
+ * @return The current resource path.
+ */
+ public ResourcePath path() {
+ return path;
+ }
+
+ /**
+ * Sets the resource path for the builder.
+ *
+ * @param path The desired resource path.
+ * @return The current ResourceBuilder instance for method chaining.
+ */
+ public ResourceBuilder path(ResourcePath path) {
+ this.path = path;
+ return this;
+ }
+
+ /**
+ * Builds and returns a new instance of {@link ResourceFile} based on the builder's configuration.
+ *
+ * @return A new ResourceFile instance.
+ */
+ public ResourceFile build() {
+ return ResourceFile.resource(this.name, this.format, this.options, this.path);
+ }
+}
diff --git a/src/main/java/dev/manere/utils/resource/ResourceFile.java b/src/main/java/dev/manere/utils/resource/ResourceFile.java
new file mode 100644
index 0000000..03dde13
--- /dev/null
+++ b/src/main/java/dev/manere/utils/resource/ResourceFile.java
@@ -0,0 +1,212 @@
+package dev.manere.utils.resource;
+
+import dev.manere.utils.library.Utils;
+import dev.manere.utils.resource.format.ResourceFormat;
+import dev.manere.utils.resource.format.ResourceFormats;
+import dev.manere.utils.resource.path.ResourcePath;
+import dev.manere.utils.resource.yaml.ResourceConfiguration;
+import dev.manere.utils.scheduler.Schedulers;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.Objects;
+
+/**
+ * Represents a resource file with a specified format, options, path, and name.
+ */
+public class ResourceFile {
+ private ResourceFormat resourceFormat;
+ private final ResourceOptions recourseOptions;
+ private final ResourcePath resourcePath;
+ private final String name;
+
+ /**
+ * Constructs a new ResourceFile with the specified name, format, options, and path.
+ *
+ * @param name The name of the resource file.
+ * @param format The format of the resource file.
+ * @param options The options for the resource file.
+ * @param path The path where the resource file is located.
+ */
+ public ResourceFile(String name, ResourceFormat format, ResourceOptions options, ResourcePath path) {
+ this.resourceFormat = format;
+ this.recourseOptions = options;
+ this.resourcePath = path;
+ this.name = name;
+
+ if (!this.resourceFormat.extension().contains(".")) {
+ this.resourceFormat = ResourceFormat.format("." + this.resourceFormat.extension());
+ }
+ }
+
+ /**
+ * Creates and returns a new instance of ResourceFile using the provided parameters.
+ *
+ * @param name The name of the resource file.
+ * @param format The format of the resource file.
+ * @param options The options for the resource file.
+ * @param path The path where the resource file is located.
+ * @return A new ResourceFile instance.
+ */
+ public static ResourceFile resource(String name, ResourceFormat format, ResourceOptions options, ResourcePath path) {
+ return new ResourceFile(name, format, options, path);
+ }
+
+ /**
+ * Returns a new instance of {@link ResourceBuilder} for building resource files.
+ *
+ * @return A new ResourceBuilder instance.
+ */
+ public static ResourceBuilder builder() {
+ return ResourceBuilder.builder();
+ }
+
+ /**
+ * Returns a new instance of {@link ResourceConfiguration} for working with YAML configurations.
+ *
+ * @return A new ResourceConfiguration instance.
+ */
+ public ResourceConfiguration yaml() {
+ return new ResourceConfiguration(this);
+ }
+
+ /**
+ * Loads and returns the file configuration from the resource file asynchronously.
+ *
+ * @return The loaded FileConfiguration.
+ */
+ public FileConfiguration loadYml() {
+ return (FileConfiguration) Schedulers.async().execute(() -> YamlConfiguration.loadConfiguration(file()));
+ }
+
+ /**
+ * Reloads and returns the file configuration from the resource file asynchronously.
+ *
+ * @return The reloaded FileConfiguration.
+ */
+ public FileConfiguration reloadYml() {
+ return loadYml();
+ }
+
+ /**
+ * Asynchronously saves the file configuration to the resource file.
+ */
+ public void saveYml() {
+ if (Objects.equals(format(), ResourceFormats.yaml()) || Objects.equals(format(), ResourceFormats.yml())) {
+ Schedulers.async().execute(task -> {
+ try {
+ file().mkdirs();
+ file().createNewFile();
+
+ FileConfiguration configuration = YamlConfiguration.loadConfiguration(file());
+ configuration.save(file());
+ } catch (IOException e) {
+ throw new RuntimeException(e);
+ }
+ });
+ } else {
+ throw new UnsupportedOperationException("only yaml files are supported for saveOrLoad()");
+ }
+ }
+
+ /**
+ * Asynchronously saves or loads the resource file based on its existence and plugin resources.
+ *
+ * @return The current ResourceFile instance.
+ */
+ public ResourceFile saveOrLoadYml() {
+ if (Objects.equals(format(), ResourceFormats.yaml()) || Objects.equals(format(), ResourceFormats.yml())) {
+ Schedulers.async().execute(task -> {
+ if (file().exists()) {
+ FileConfiguration configuration = YamlConfiguration.loadConfiguration(file());
+ return;
+ }
+
+ if (Utils.plugin().getResource(this.name + this.resourceFormat.extension()) != null) {
+ Utils.plugin().saveResource(this.resourcePath.path().replaceAll(Utils.plugin().getDataFolder().getPath(), "") + this.name + this.resourceFormat.extension(), false);
+ }
+
+ try {
+ if (!file().createNewFile()) {
+ Utils.plugin().getLogger().severe("Failed to create resource: " + file().getPath());
+ task.cancel();
+ }
+ } catch (IOException e) {
+ throw new RuntimeException(e);
+ }
+
+ FileConfiguration configuration = YamlConfiguration.loadConfiguration(file());
+
+ configuration.options()
+ .copyDefaults(true)
+ .parseComments(true)
+ .pathSeparator('.');
+
+ if (recourseOptions.header() != null) {
+ configuration.options().setHeader(recourseOptions.header());
+ }
+
+ if (recourseOptions.footer() != null) {
+ configuration.options().setFooter(recourseOptions.footer());
+ }
+
+ try {
+ configuration.save(file());
+ } catch (IOException e) {
+ throw new RuntimeException(e);
+ }
+ });
+ } else {
+ throw new UnsupportedOperationException("only yaml files are supported for saveOrLoad()");
+ }
+
+ return this;
+ }
+
+ /**
+ * Returns the file associated with the resource file.
+ *
+ * @return The file representing the resource file.
+ */
+ public File file() {
+ return new File(new File(resourcePath.path()), name + resourceFormat.extension());
+ }
+
+ /**
+ * Gets the format of the resource file.
+ *
+ * @return The format of the resource file.
+ */
+ public ResourceFormat format() {
+ return resourceFormat;
+ }
+
+ /**
+ * Gets the options for the resource file.
+ *
+ * @return The options for the resource file.
+ */
+ public ResourceOptions options() {
+ return recourseOptions;
+ }
+
+ /**
+ * Gets the path where the resource file is located.
+ *
+ * @return The path of the resource file.
+ */
+ public ResourcePath path() {
+ return resourcePath;
+ }
+
+ /**
+ * Gets the name of the resource file.
+ *
+ * @return The name of the resource file.
+ */
+ public String name() {
+ return name;
+ }
+}
diff --git a/src/main/java/dev/manere/utils/resource/ResourceOptions.java b/src/main/java/dev/manere/utils/resource/ResourceOptions.java
new file mode 100644
index 0000000..caf39ae
--- /dev/null
+++ b/src/main/java/dev/manere/utils/resource/ResourceOptions.java
@@ -0,0 +1,115 @@
+package dev.manere.utils.resource;
+
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * Represents options for configuring a resource file, including header, footer, and defaults.
+ */
+public class ResourceOptions {
+ private List header;
+ private List footer;
+ private boolean defaults;
+
+ /**
+ * Constructs a new ResourceOptions with the specified header, footer, and defaults.
+ *
+ * @param header The header lines for the resource file.
+ * @param footer The footer lines for the resource file.
+ * @param defaults Whether to use default options.
+ */
+ public ResourceOptions(List header, List