From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: Riley Park Date: Sun, 23 May 2021 05:04:28 -0700 Subject: [PATCH] ItemStack#editMeta diff --git a/src/main/java/org/bukkit/inventory/ItemStack.java b/src/main/java/org/bukkit/inventory/ItemStack.java index 86bd9f14de5c1ff3d797955be1af56e5efcac884..59a026d80b0a0a4890becf98efdbe5325b2c622a 100644 --- a/src/main/java/org/bukkit/inventory/ItemStack.java +++ b/src/main/java/org/bukkit/inventory/ItemStack.java @@ -543,6 +543,31 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, net.kyor return result.ensureServerConversions(); // Paper } + // Paper start + /** + * Edits the {@link ItemMeta} of this stack. + *

+ * The {@link java.util.function.Consumer} must only interact + * with this stack's {@link ItemMeta} through the provided {@link ItemMeta} instance. + * Calling this method or any other meta-related method of the {@link ItemStack} class + * (such as {@link #getItemMeta()}, {@link #addItemFlags(ItemFlag...)}, {@link #lore()}, etc.) + * from inside the consumer is disallowed and will produce undefined results or exceptions. + *

+ * + * @param consumer the meta consumer + * @return {@code true} if the edit was successful, {@code false} otherwise + */ + public boolean editMeta(final @NotNull java.util.function.Consumer consumer) { + final ItemMeta meta = this.getItemMeta(); + if (meta != null) { + consumer.accept(meta); + this.setItemMeta(meta); + return true; + } + return false; + } + // Paper end + /** * Get a copy of this ItemStack's {@link ItemMeta}. *