Additions

.github/workflows/build.yml

@@ -17,8 +17,10 @@ jobs:
     uses: GroupeZ-dev/actions/.github/workflows/build.yml@main
     with:
       project-name: "zMenu"
+      java-version: '25'
       publish: true
       project-to-publish: "API:publish"
+      build-command: './gradlew build'
       discord-avatar-url: "https://minecraft-inventory-builder.com/storage/images/9UgcfGZyrmbVrXw5lbj5kXq6fW8F4nhwj6Cx4nVG.png"
     secrets:
       WEBHOOK_URL: ${{ secrets.WEBHOOK_URL }}

.gitignore

@@ -57,3 +57,6 @@ opencode.json
 CLAUDE.md
 .claude/settings.local.json
 build-and-deploy.sh
+GEMINI.md
+
+TODO.md

API/build.gradle.kts

@@ -1,9 +1,9 @@
 plugins {
-    id("re.alwyn974.groupez.publish") version "1.0.0"
+    alias(libs.plugins.groupez.publish)
 }
 
 dependencies{
-    implementation("net.kyori:adventure-api:4.25.0")
+    implementation(libs.adventure.api)
 }
 
 rootProject.extra.properties["sha"]?.let { sha ->

API/src/main/java/fr/maxlego08/menu/api/BedrockManager.java

@@ -2,6 +2,7 @@
 
 import fr.maxlego08.menu.api.exceptions.DialogException;
 import fr.maxlego08.menu.api.exceptions.InventoryException;
+import fr.maxlego08.menu.api.inventory.bedrock.BedrockInventory;
 import org.bukkit.entity.Player;
 import org.bukkit.plugin.Plugin;
 

API/src/main/java/fr/maxlego08/menu/api/DialogManager.java

@@ -3,6 +3,7 @@
 import fr.maxlego08.menu.api.configuration.ConfigManagerInt;
 import fr.maxlego08.menu.api.exceptions.DialogException;
 import fr.maxlego08.menu.api.exceptions.InventoryException;
+import fr.maxlego08.menu.api.inventory.dialog.DialogInventory;
 import org.bukkit.entity.Player;
 import org.bukkit.plugin.Plugin;
 

API/src/main/java/fr/maxlego08/menu/api/Inventory.java

@@ -15,6 +15,7 @@
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.InventoryType;
 import org.bukkit.plugin.Plugin;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.io.File;
@@ -34,7 +35,14 @@ public interface Inventory {
      * Returns the size of the inventory.
      *
      * @return The size of the inventory. This value is the number of slots in the inventory.
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ChestInventory chestInventory) {
+     *     int size = chestInventory.size();
+     * }
+     * </pre>
      */
+    @Deprecated(since = "1.1.1.5")
     int size();
 
     /**
@@ -49,19 +57,33 @@ public interface Inventory {
      *
      * @return The name of the inventory, translated to the player's language.
      */
-    String getName(Player player, InventoryEngine InventoryEngine, Placeholders placeholders);
+    String getName(@NotNull Player player, InventoryEngine InventoryEngine, Placeholders placeholders);
 
     /**
      * Returns the type of the inventory.
      *
      * @return The type of the inventory.
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     InventoryType type = containerInventory.getType();
+     * }
+     * </pre>
      */
+    @Deprecated(since = "1.1.1.5")
     InventoryType getType();
 
     /**
      * Indicates whether the inventory prevents the player from picking up items from the ground.
      * @return true if item pickup is blocked while this inventory is open, false otherwise.
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     boolean shouldCancel = containerInventory.shouldCancelItemPickup();
+     * }
+     * </pre>
      */
+    @Deprecated(since = "1.1.1.5")
     boolean shouldCancelItemPickup();
 
     /**
@@ -159,7 +181,14 @@ public interface Inventory {
      * Returns the item stack used to fill empty slots in the inventory.
      *
      * @return The fill item stack.
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     MenuItemStack fillItemStack = containerInventory.getFillItemStack();
+     * }
+     * </pre>
      */
+    @Deprecated(since = "1.1.1.5")
     MenuItemStack getFillItemStack();
 
     /**
@@ -180,7 +209,14 @@ public interface Inventory {
      * Determines whether the player's inventory should be cleared upon closing the inventory.
      *
      * @return True if the player's inventory should be cleaned, false otherwise.
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     boolean shouldClear = containerInventory.clearInventory();
+     * }
+     * </pre>
      */
+    @Deprecated(since = "1.1.1.5")
     boolean cleanInventory();
 
     /**
@@ -222,16 +258,55 @@ public interface Inventory {
      */
     String getTargetPlayerNamePlaceholder();
 
+
+    /**
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     containerInventory.setTitleAnimation(animation);
+     * }
+     * </pre>
+     */
+    @Deprecated(since = "1.1.1.5")
     void setTitleAnimation(TitleAnimation load);
 
+    /**
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     TitleAnimation animation = containerInventory.getTitleAnimation();
+     * }
+     * </pre>
+     */
+    @Deprecated(since = "1.1.1.5")
+    @Nullable
     TitleAnimation getTitleAnimation();
 
     List<Action> getOpenActions();
 
     List<Action> getCloseActions();
 
+    /**
+     *
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     ClearInvType clearInvType = containerInventory.getClearInvType();
+     * }
+     * </pre>
+     */
     ClearInvType getClearInvType();
 
+    /**
+     *
+     * @deprecated Use:
+     * <pre>
+     * if (inventory instanceof ContainerInventory containerInventory) {
+     *     boolean isEnabled = containerInventory.isClickLimiterEnabled();
+     * }
+     * </pre>
+     */
+    @Deprecated(since = "1.1.1.5")
     boolean isClickLimiterEnabled();
 
     @Nullable

API/src/main/java/fr/maxlego08/menu/api/InventoryListener.java

@@ -1,6 +1,7 @@
 package fr.maxlego08.menu.api;
 
 import fr.maxlego08.menu.api.engine.BaseInventory;
+import fr.maxlego08.menu.api.engine.InventoryEngine;
 import fr.maxlego08.menu.api.engine.ItemButton;
 import org.bukkit.entity.Player;
 
@@ -25,4 +26,8 @@ default void onInventoryClose(Player player, BaseInventory baseInventory){
     default void onButtonClick(Player player, ItemButton button){
 
     }
+
+    default void onInventorySwitch(Player player, InventoryEngine oldInventoryEngine, InventoryEngine newInventoryEngine) {
+
+    }
 }

API/src/main/java/fr/maxlego08/menu/api/InventoryManager.java

@@ -598,6 +598,8 @@ public interface InventoryManager extends Listener {
      */
     MenuItemStack loadItemStack(File file, String path, Map<String, Object> map);
 
+    MenuItemStack loadItemStack(File file, Map<String, Object> map);
+
     /**
      * Provides access to the pagination manager for handling paginated content in inventories.
      *

API/src/main/java/fr/maxlego08/menu/api/MenuItemStack.java

@@ -4,6 +4,7 @@
 import fr.maxlego08.menu.api.attribute.AttributeWrapper;
 import fr.maxlego08.menu.api.context.BuildContext;
 import fr.maxlego08.menu.api.context.MenuItemStackContext;
+import fr.maxlego08.menu.api.enums.AmountType;
 import fr.maxlego08.menu.api.enums.MenuItemRarity;
 import fr.maxlego08.menu.api.itemstack.*;
 import fr.maxlego08.menu.api.utils.LoreType;
@@ -82,6 +83,13 @@ public interface MenuItemStack extends MenuItemStackContext {
      */
     void setAmount(String amount);
 
+    /**
+     * Updates the configured amount type for the item stack.
+     *
+     * @param amountType the amount type to set.
+     */
+    void setAmountType(AmountType amountType);
+
     /**
      * Defines the skull texture URL for this item stack.
      *
@@ -401,6 +409,12 @@ public interface MenuItemStack extends MenuItemStackContext {
      */
     void setItemModel(NamespacedKey itemModel);
 
+    /**
+     * Sets the item model identifier using a string value.
+     * @param itemModel the item model identifier to set, as a string.
+     */
+    void setItemModel(String itemModel);
+
     /**
      * Sets the equipped model identifier used for wearable items.
      *

API/src/main/java/fr/maxlego08/menu/api/animation/TitleAnimation.java

@@ -22,5 +22,5 @@ public interface TitleAnimation {
      * @return A PlayerTitleAnimation if started, otherwise null.
      */
     @Nullable
-    PlayerTitleAnimation playTitleAnimation(@NotNull MenuPlugin plugin, int containerId, @NotNull InventoryType type, int size, Object... args);
+    PlayerTitleAnimation playTitleAnimation(@NotNull MenuPlugin plugin, int containerId, @NotNull InventoryType type, int size, @NotNull Object... args);
 }

API/src/main/java/fr/maxlego08/menu/api/annotations/AutoListener.java

@@ -0,0 +1,11 @@
+package fr.maxlego08.menu.api.annotations;
+
+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 AutoListener {
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/AutoRuleLoader.java

@@ -0,0 +1,11 @@
+package fr.maxlego08.menu.api.annotations;
+
+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 AutoRuleLoader {
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/ComponentLoader.java

@@ -0,0 +1,11 @@
+package fr.maxlego08.menu.api.annotations;
+
+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 ComponentLoader {
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/PaperOnly.java

@@ -0,0 +1,11 @@
+package fr.maxlego08.menu.api.annotations;
+
+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 PaperOnly {
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/SinceVersion.java

@@ -0,0 +1,15 @@
+package fr.maxlego08.menu.api.annotations;
+
+import org.jetbrains.annotations.NotNull;
+
+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 SinceVersion {
+    @NotNull
+    String value();
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/SpigotOnly.java

@@ -0,0 +1,12 @@
+package fr.maxlego08.menu.api.annotations;
+
+
+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 SpigotOnly {
+}

API/src/main/java/fr/maxlego08/menu/api/annotations/UntilVersion.java

@@ -0,0 +1,16 @@
+package fr.maxlego08.menu.api.annotations;
+
+import org.jetbrains.annotations.NotNull;
+
+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 UntilVersion {
+
+    @NotNull
+    String value();
+}

API/src/main/java/fr/maxlego08/menu/api/attribute/AttributeEntry.java

@@ -2,5 +2,6 @@
 
 import org.bukkit.attribute.Attribute;
 import org.bukkit.attribute.AttributeModifier;
+import org.jetbrains.annotations.NotNull;
 
-public record AttributeEntry(Attribute attribute, AttributeModifier modifier) {}
+public record AttributeEntry(@NotNull Attribute attribute,@NotNull AttributeModifier modifier) {}

API/src/main/java/fr/maxlego08/menu/api/button/Button.java

@@ -3,6 +3,7 @@
 import fr.maxlego08.menu.api.Inventory;
 import fr.maxlego08.menu.api.MenuItemStack;
 import fr.maxlego08.menu.api.MenuPlugin;
+import fr.maxlego08.menu.api.engine.AnvilInventoryEngine;
 import fr.maxlego08.menu.api.engine.InventoryEngine;
 import fr.maxlego08.menu.api.engine.Pagination;
 import fr.maxlego08.menu.api.players.DataManager;
@@ -13,6 +14,7 @@
 import fr.maxlego08.menu.api.sound.SoundOption;
 import fr.maxlego08.menu.api.utils.OpenLink;
 import fr.maxlego08.menu.api.utils.Placeholders;
+import fr.maxlego08.menu.api.utils.TextChange;
 import fr.maxlego08.menu.zcore.utils.PerformanceDebug;
 import org.bukkit.Material;
 import org.bukkit.OfflinePlayer;
@@ -212,6 +214,8 @@ public void onLeftClick(@NotNull Player player, @NotNull InventoryClickEvent eve
     public void onRightClick(@NotNull Player player, @NotNull InventoryClickEvent event, @NotNull InventoryEngine inventory, int slot) {
     }
 
+    public void onAnvilTextChange(@NotNull Player player, AnvilInventoryEngine inventoryEngine, TextChange textChange, Placeholders placeholders) {}
+
     /**
      * Called when the middle mouse button is clicked
      *