aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0375-ItemStack-damage-API.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0375-ItemStack-damage-API.patch')
-rw-r--r--patches/api/0375-ItemStack-damage-API.patch91
1 files changed, 91 insertions, 0 deletions
diff --git a/patches/api/0375-ItemStack-damage-API.patch b/patches/api/0375-ItemStack-damage-API.patch
new file mode 100644
index 0000000000..9c25426479
--- /dev/null
+++ b/patches/api/0375-ItemStack-damage-API.patch
@@ -0,0 +1,91 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Jake Potrebic <[email protected]>
+Date: Sun, 8 May 2022 13:35:58 -0700
+Subject: [PATCH] ItemStack damage API
+
+Adds methods notify clients about item breaks and
+to simulate damage done to an itemstack and all
+the logic associated with damaging them
+
+diff --git a/src/main/java/org/bukkit/entity/LivingEntity.java b/src/main/java/org/bukkit/entity/LivingEntity.java
+index 597a3b581cb6fa2605fd5916e5639c1020d688b7..c9c3b926c5bb408d964ed5acc9f95c8527837a25 100644
+--- a/src/main/java/org/bukkit/entity/LivingEntity.java
++++ b/src/main/java/org/bukkit/entity/LivingEntity.java
+@@ -1365,4 +1365,53 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource
+ */
+ void knockback(double strength, double directionX, double directionZ);
+ // Paper end - knockback API
++
++ // Paper start - ItemStack damage API
++ /**
++ * Notifies all clients tracking this entity that the item in
++ * the slot of this entity broke.
++ * <p>
++ * NOTE: this does not mutate any entity state
++ *
++ * @param slot the slot
++ */
++ void broadcastSlotBreak(org.bukkit.inventory.@NotNull EquipmentSlot slot);
++
++ /**
++ * Notifies specified players that the item in the slot
++ * of this entity broke.
++ * <p>
++ * NOTE: this does not mutate any entity state
++ *
++ * @param slot the slot
++ * @param players the players to notify
++ */
++ void broadcastSlotBreak(org.bukkit.inventory.@NotNull EquipmentSlot slot, @NotNull Collection<Player> players);
++
++ /**
++ * Damages the itemstack in this slot by the specified amount.
++ * <p>
++ * This runs all logic associated with damaging an itemstack like
++ * gamemode and enchantment checks, events, stat changes, and advancement
++ * triggers.
++ *
++ * @param stack the itemstack to damage
++ * @param amount the amount of damage to do
++ * @return the damaged itemstack, or an empty stack if it broke. There are no
++ * guarantees the returned itemstack is the same instance
++ */
++ @NotNull ItemStack damageItemStack(@NotNull ItemStack stack, int amount);
++
++ /**
++ * Damages the itemstack in this slot by the specified amount.
++ * <p>
++ * This runs all logic associated with damaging an itemstack like
++ * gamemode and enchantment checks, events, stat changes, advancement
++ * triggers, and notifying clients to play break animations.
++ *
++ * @param slot the slot of the stack to damage
++ * @param amount the amount of damage to do
++ */
++ void damageItemStack(org.bukkit.inventory.@NotNull EquipmentSlot slot, int amount);
++ // Paper end - ItemStack damage API
+ }
+diff --git a/src/main/java/org/bukkit/inventory/ItemStack.java b/src/main/java/org/bukkit/inventory/ItemStack.java
+index ab74890e9b6a13b76756f884d6d176bb45470191..659191a226cae406a14c67cc0992f7026f6188e6 100644
+--- a/src/main/java/org/bukkit/inventory/ItemStack.java
++++ b/src/main/java/org/bukkit/inventory/ItemStack.java
+@@ -1003,5 +1003,19 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat
+ public boolean canRepair(@NotNull ItemStack toBeRepaired) {
+ return Bukkit.getUnsafe().isValidRepairItemStack(toBeRepaired, this);
+ }
++
++ /**
++ * Damages this itemstack by the specified amount. This
++ * runs all logic associated with damaging an itemstack like
++ * events and stat changes.
++ *
++ * @param amount the amount of damage to do
++ * @param livingEntity the entity related to the damage
++ * @return the damaged itemstack or an empty one if it broke. May return the same instance of ItemStack
++ * @see org.bukkit.entity.LivingEntity#damageItemStack(EquipmentSlot, int) to damage itemstacks in equipment slots
++ */
++ public @NotNull ItemStack damage(int amount, @NotNull org.bukkit.entity.LivingEntity livingEntity) {
++ return livingEntity.damageItemStack(this, amount);
++ }
+ // Paper end
+ }