Paper/Spigot-API-Patches/0117-InventoryCloseEvent-Reason-API.patch

From c7c413ab5b8a9bea7918c7d2b1e309500ecd73a7 Mon Sep 17 00:00:00 2001
From: Aikar <aikar@aikar.co>
Date: Tue, 3 Jul 2018 21:52:52 -0400
Subject: [PATCH] InventoryCloseEvent Reason API

Allows you to determine why an inventory was closed, enabling plugin developers
to "confirm" things based on if it was player triggered close or not.

diff --git a/src/main/java/org/bukkit/entity/HumanEntity.java b/src/main/java/org/bukkit/entity/HumanEntity.java
index 2d413d720..79569a329 100644
--- a/src/main/java/org/bukkit/entity/HumanEntity.java
+++ b/src/main/java/org/bukkit/entity/HumanEntity.java
@@ -152,6 +152,15 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder
      */
     public void closeInventory();
 
+    // Paper start
+    /**
+     * Force-closes the currently open inventory view for this player, if any.
+     *
+     * @param reason why the inventory is closing
+     */
+    public void closeInventory(@NotNull org.bukkit.event.inventory.InventoryCloseEvent.Reason reason);
+    // Paper end
+
     /**
      * Returns the ItemStack currently in your hand, can be empty.
      *
diff --git a/src/main/java/org/bukkit/event/inventory/InventoryCloseEvent.java b/src/main/java/org/bukkit/event/inventory/InventoryCloseEvent.java
index 5861247c1..21ad8888c 100644
--- a/src/main/java/org/bukkit/event/inventory/InventoryCloseEvent.java
+++ b/src/main/java/org/bukkit/event/inventory/InventoryCloseEvent.java
@@ -11,9 +11,60 @@ import org.jetbrains.annotations.NotNull;
  */
 public class InventoryCloseEvent extends InventoryEvent {
     private static final HandlerList handlers = new HandlerList();
+    // Paper start
+    private final Reason reason;
+    @NotNull
+    public Reason getReason() {
+        return reason;
+    }
+
+    public enum Reason {
+        /**
+         * Unknown reason
+         */
+        UNKNOWN,
+        /**
+         * Player is teleporting
+         */
+        TELEPORT,
+        /**
+         * Player is no longer permitted to use this inventory
+         */
+        CANT_USE,
+        /**
+         * The chunk the inventory was in was unloaded
+         */
+        UNLOADED,
+        /**
+         * Opening new inventory instead
+         */
+        OPEN_NEW,
+        /**
+         * Closed
+         */
+        PLAYER,
+        /**
+         * Closed due to disconnect
+         */
+        DISCONNECT,
+        /**
+         * The player died
+         */
+        DEATH,
+        /**
+         * Closed by Bukkit API
+         */
+        PLUGIN,
+    }
 
     public InventoryCloseEvent(@NotNull InventoryView transaction) {
+        this(transaction, Reason.UNKNOWN);
+    }
+
+    public InventoryCloseEvent(@NotNull InventoryView transaction, @NotNull Reason reason) {
         super(transaction);
+        this.reason = reason;
+        // Paper end
     }
 
     /**
-- 
2.26.2