feat: add allow-backpack-inception config option to enable placing backpacks in backpacks

Author: Shweit

src/main/java/com/shweit/expendablebackpacks/ExpendableBackpacks.java

@@ -48,7 +48,7 @@ public void onEnable() {
         getServer().getPluginManager().registerEvents(
             new BackpackInteractionListener(backpackManager), this);
         getServer().getPluginManager().registerEvents(
-            new BackpackProtectionListener(), this);
+            new BackpackProtectionListener(this), this);
         getServer().getPluginManager().registerEvents(
             new BackpackBlockListener(), this);
         getServer().getPluginManager().registerEvents(

src/main/java/com/shweit/expendablebackpacks/listeners/BackpackProtectionListener.java

@@ -8,19 +8,37 @@
 import org.bukkit.event.inventory.InventoryDragEvent;
 import org.bukkit.inventory.Inventory;
 import org.bukkit.inventory.ItemStack;
+import org.bukkit.plugin.Plugin;
 
 /**
  * Prevents backpacks from being placed inside other backpacks (inception protection).
+ * Can be disabled via the {@code allow-backpack-inception} config option.
  */
 public class BackpackProtectionListener implements Listener {
 
+    private final Plugin plugin;
+
+    /**
+     * Creates a new backpack protection listener.
+     *
+     * @param plugin the plugin instance used to read configuration
+     */
+    @SuppressWarnings("EI_EXPOSE_REP2")
+    public BackpackProtectionListener(Plugin plugin) {
+        this.plugin = plugin;
+    }
+
     /**
      * Handles inventory click events to prevent backpack inception.
      *
      * @param event the inventory click event
      */
     @EventHandler
     public void onInventoryClick(InventoryClickEvent event) {
+        if (plugin.getConfig().getBoolean("allow-backpack-inception", false)) {
+            return;
+        }
+
         Inventory clickedInventory = event.getClickedInventory();
         if (clickedInventory == null) {
             return;
@@ -64,6 +82,10 @@ public void onInventoryClick(InventoryClickEvent event) {
      */
     @EventHandler
     public void onInventoryDrag(InventoryDragEvent event) {
+        if (plugin.getConfig().getBoolean("allow-backpack-inception", false)) {
+            return;
+        }
+
         // Check if dragging into a backpack inventory by title
         String title = event.getView().getTitle();
         if (!isBackpackTitle(title)) {

src/main/resources/config.yml

@@ -7,6 +7,19 @@
 # Starter Backpack Settings
 # ---------------------------
 
+# ---------------------------
+# Inception Settings
+# ---------------------------
+
+# Allow players to place backpacks inside other backpacks
+# Set to 'true' to enable the "Inception" mode, 'false' to disable
+# Default: false
+allow-backpack-inception: false
+
+# ---------------------------
+# Starter Backpack Settings
+# ---------------------------
+
 # Give a Leather Backpack to players when they first join the server
 # Set to 'true' to enable, 'false' to disable
 # Default: false