2019-05-27 09:13:41 +00:00
From c9d19322171cba500160f8fd9c4373f854f3805c Mon Sep 17 00:00:00 2001
2019-03-28 04:58:05 +00:00
From: Aikar <aikar@aikar.co>
Date: Mon, 11 Mar 2013 20:04:34 -0400
Subject: [PATCH] PlayerDeathEvent#getItemsToKeep
Exposes a mutable array on items a player should keep on death
Example Usage: https://gist.github.com/aikar/5bb202de6057a051a950ce1f29feb0b4
diff --git a/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java b/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java
2019-04-23 04:47:07 +00:00
index f0dda632..f5c3c5e2 100644
2019-03-28 04:58:05 +00:00
--- a/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java
+++ b/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java
2019-04-23 04:47:07 +00:00
@@ -17,6 +17,40 @@ public class PlayerDeathEvent extends EntityDeathEvent {
2019-03-28 04:58:05 +00:00
private boolean keepLevel = false;
private boolean keepInventory = false;
+ // Paper start
+ private List<ItemStack> itemsToKeep = new java.util.ArrayList<>();
+
+ /**
2019-03-29 02:06:35 +00:00
+ * A mutable collection to add items that the player should retain in their inventory on death (Similar to KeepInventory game rule)
2019-03-28 04:58:05 +00:00
+ *
+ * You <b>MUST</b> remove the item from the .getDrops() collection too or it will duplicate!
2019-03-29 03:58:09 +00:00
+ * <pre>{@code
2019-03-29 04:44:06 +00:00
+ * {@literal @EventHandler(ignoreCancelled = true)}
2019-03-29 02:06:35 +00:00
+ * public void onPlayerDeath(PlayerDeathEvent event) {
+ * for (Iterator<ItemStack> iterator = event.getDrops().iterator(); iterator.hasNext(); ) {
+ * ItemStack drop = iterator.next();
+ * List<String> lore = drop.getLore();
+ * if (lore != null && !lore.isEmpty()) {
+ * if (lore.get(0).contains("(SOULBOUND)")) {
+ * iterator.remove();
+ * event.getItemsToKeep().add(drop);
+ * }
+ * }
+ * }
+ * }
2019-03-29 03:58:09 +00:00
+ * }</pre>
2019-03-29 02:06:35 +00:00
+ *
+ * Adding an item to this list that the player did not previously have will give them the item on death.
+ * An example case could be a "Note" that "You died at X/Y/Z coordinates"
2019-03-28 04:58:05 +00:00
+ *
+ * @return The list to hold items to keep
+ */
+ @NotNull
+ public List<ItemStack> getItemsToKeep() {
+ return itemsToKeep;
+ }
+ // Paper end
+
public PlayerDeathEvent(@NotNull final Player player, @NotNull final List<ItemStack> drops, final int droppedExp, @Nullable final String deathMessage) {
this(player, drops, droppedExp, 0, deathMessage);
}
--
2.21.0