Additions

.gitignore

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

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/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/command/Command.java

@@ -1,6 +1,7 @@
 package fr.maxlego08.menu.api.command;
 
 import fr.maxlego08.menu.api.requirement.Action;
+import fr.maxlego08.menu.api.requirement.Requirement;
 import org.bukkit.plugin.Plugin;
 
 import java.io.File;
@@ -102,6 +103,12 @@ public interface Command {
      */
     List<Command> subCommands();
 
+    /**
+     * Gets the list of requirements that must be met for the command's actions to be executed.
+     * @return The list of requirements that must be met for the command's actions to be executed.
+     */
+    List<Requirement> actions_requirements();
+
     /**
      * Gets the message to display when the player does not have the required permission.
      *

API/src/main/java/fr/maxlego08/menu/api/itemstack/components/AttackRangeComponent.java

@@ -1,24 +1,17 @@
 package fr.maxlego08.menu.api.itemstack.components;
 
-import fr.maxlego08.menu.api.context.BuildContext;
 import fr.maxlego08.menu.api.itemstack.ItemComponent;
-import org.bukkit.entity.Player;
-import org.bukkit.inventory.ItemStack;
-import org.bukkit.inventory.meta.ItemMeta;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
-@SuppressWarnings("unused")
-public class AttackRangeComponent extends ItemComponent {
+public abstract class AttackRangeComponent extends ItemComponent {
+    protected final float minReach;
+    protected final float maxReach;
+    protected final float minCreativeReach;
+    protected final float maxCreativeReach;
+    protected final float hitboxMargin;
+    protected final float mobFactor;
 
-    private final float minReach;
-    private final float maxReach;
-    private final float minCreativeReach;
-    private final float maxCreativeReach;
-    private final float hitboxMargin;
-    private final float mobFactor;
 
-    public AttackRangeComponent(float minReach, float maxReach, float minCreativeReach, float maxCreativeReach, float hitboxMargin, float mobFactor) {
+    protected AttackRangeComponent(float minReach, float maxReach, float minCreativeReach, float maxCreativeReach, float hitboxMargin, float mobFactor) {
         this.minReach = minReach;
         this.maxReach = maxReach;
         this.minCreativeReach = minCreativeReach;
@@ -50,19 +43,4 @@ public float getHitboxMargin() {
     public float getMobFactor() {
         return this.mobFactor;
     }
-
-    @Override
-    public void apply(@NotNull BuildContext context, @NotNull ItemStack itemStack, @Nullable Player player) {
-        ItemMeta itemMeta = itemStack.getItemMeta();
-        if (itemMeta == null) return;
-        org.bukkit.inventory.meta.components.AttackRangeComponent attackRange = itemMeta.getAttackRange();
-        attackRange.setMinReach(this.minReach);
-        attackRange.setMaxReach(this.maxReach);
-        attackRange.setMinCreativeReach(this.minCreativeReach);
-        attackRange.setMaxCreativeReach(this.maxCreativeReach);
-        attackRange.setHitboxMargin(this.hitboxMargin);
-        attackRange.setMobFactor(this.mobFactor);
-        itemStack.setItemMeta(itemMeta);
-    }
-
 }

API/src/main/java/fr/maxlego08/menu/api/itemstack/components/MaxStackSizeComponent.java

@@ -1,16 +1,9 @@
 package fr.maxlego08.menu.api.itemstack.components;
 
-import fr.maxlego08.menu.api.context.BuildContext;
 import fr.maxlego08.menu.api.itemstack.ItemComponent;
-import org.bukkit.entity.Player;
-import org.bukkit.inventory.ItemStack;
-import org.bukkit.inventory.meta.ItemMeta;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
-@SuppressWarnings("unused")
-public class MaxStackSizeComponent extends ItemComponent {
-    private final int maxStackSize;
+public abstract class MaxStackSizeComponent extends ItemComponent {
+    protected final int maxStackSize;
 
     public MaxStackSizeComponent(int maxStackSize) {
         this.maxStackSize = maxStackSize;
@@ -19,14 +12,4 @@ public MaxStackSizeComponent(int maxStackSize) {
     public int getMaxStackSize() {
         return this.maxStackSize;
     }
-
-    @Override
-    public void apply(@NotNull BuildContext context, @NotNull ItemStack itemStack, @Nullable Player player) {
-        ItemMeta itemMeta = itemStack.getItemMeta();
-        if (itemMeta != null) {
-            itemMeta.setMaxStackSize(this.maxStackSize);
-            itemStack.setItemMeta(itemMeta);
-        }
-    }
 }
-

API/src/main/java/fr/maxlego08/menu/api/loader/ButtonLoader.java

@@ -9,6 +9,7 @@
 import org.jetbrains.annotations.Nullable;
 
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 import java.util.stream.IntStream;
 
@@ -31,9 +32,12 @@ public abstract class ButtonLoader {
     protected final Plugin plugin;
     protected final String name;
 
-    public ButtonLoader(@NotNull Plugin plugin,@NotNull String name) {
+    protected final List<String> aliases = new ArrayList<>();
+
+    public ButtonLoader(@NotNull Plugin plugin,@NotNull String name, String... aliases) {
         this.plugin = plugin;
         this.name = name;
+        this.aliases.addAll(List.of(aliases));
     }
 
     /**
@@ -78,6 +82,17 @@ public String getName() {
         return this.name;
     }
 
+    /**
+     * Gets the list of aliases for the button.
+     *
+     * @return An unmodifiable list of aliases.
+     */
+    @Contract(pure = true)
+    @NotNull
+    public List<String> getAliases() {
+        return Collections.unmodifiableList(this.aliases);
+    }
+
     /**
      * Gets the plugin from which the button loader originates.
      *

API/src/main/java/fr/maxlego08/menu/api/players/inventory/InventoriesPlayer.java

@@ -28,6 +28,8 @@ public interface InventoriesPlayer extends Listener {
      */
     void storeInventoryTemporary(@NonNull Player player);
 
+    void storeInventoryTemporaryOrClear(@NotNull Player player);
+
     /**
      * Allows giving the inventory back to the player
      *

API/src/main/java/fr/maxlego08/menu/api/players/inventory/InventoryPlayer.java

@@ -3,6 +3,7 @@
 import org.bukkit.entity.Player;
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.NotNull;
+import org.jspecify.annotations.NonNull;
 
 import java.util.List;
 import java.util.Map;
@@ -19,6 +20,8 @@ public interface InventoryPlayer {
      */
     void storeInventory(@NotNull Player player);
 
+    void clearInventory(@NonNull Player player);
+
     /**
      * Allows giving the inventory back to the player
      *

API/src/main/java/fr/maxlego08/menu/api/requirement/Action.java

@@ -25,6 +25,7 @@ public abstract class Action {
      */
     private int delay;
     private float chance;
+    protected boolean debug = false;
 
     /**
      * The type of the action.
@@ -64,6 +65,14 @@ public void setDelay(int delay) {
         this.delay = delay;
     }
 
+    public boolean isDebug() {
+        return this.debug;
+    }
+
+    public void setDebug(boolean debug) {
+        this.debug = debug;
+    }
+
     @Contract(pure= true)
     public float getChance() {
         return this.chance;

API/src/main/java/fr/maxlego08/menu/api/utils/Message.java

@@ -79,7 +79,7 @@ public enum Message implements IMessage {
     DESCRIPTION_OPEN("Allows you to open an inventory"),
     DESCRIPTION_SAVE("Allows you to save the item in your hand"),
     DESCRIPTION_RELOAD("Allows you to reload configuration files"),
-    DESCRIPTION_VERSION("Show plugin version"),
+    DESCRIPTION_VERSION("Show plugin value"),
     DESCRIPTION_LIST("Inventory list"),
     DESCRIPTION_TEST_DUPE("Test dupe"),
     DESCRIPTION_OPEN_ITEM("Give open item"),

API/src/main/java/fr/maxlego08/menu/api/utils/PlatformType.java

@@ -0,0 +1,60 @@
+package fr.maxlego08.menu.api.utils;
+
+public enum PlatformType {
+    /**
+     * Paper server with native Adventure API support.
+     */
+    PAPER,
+
+    /**
+     * Spigot server requiring Adventure Platform wrapper.
+     */
+    SPIGOT;
+
+    private static PlatformType detectedType;
+
+    /**
+     * Detects the server platform type by checking for Paper-specific classes.
+     *
+     * @return The detected platform type
+     */
+    public static PlatformType detect() {
+        if (detectedType == null) {
+            try {
+                Class.forName("io.papermc.paper.text.PaperComponents");
+                detectedType = PAPER;
+            } catch (ClassNotFoundException e) {
+                detectedType = SPIGOT;
+            }
+        }
+        return detectedType;
+    }
+
+    /**
+     * Gets the detected platform type.
+     * If detection hasn't been run yet, it will be performed.
+     *
+     * @return The platform type
+     */
+    public static PlatformType get() {
+        return detect();
+    }
+
+    /**
+     * Checks if the current platform is Paper.
+     *
+     * @return true if running on Paper, false otherwise
+     */
+    public static boolean isPaper() {
+        return get() == PAPER;
+    }
+
+    /**
+     * Checks if the current platform is Spigot.
+     *
+     * @return true if running on Spigot, false otherwise
+     */
+    public static boolean isSpigot() {
+        return get() == SPIGOT;
+    }
+}