diff --git a/paper-api/src/main/java/io/papermc/paper/event/entity/EntityDamageItemEvent.java b/paper-api/src/main/java/io/papermc/paper/event/entity/EntityDamageItemEvent.java new file mode 100644 index 0000000000..c4cc093189 --- /dev/null +++ b/paper-api/src/main/java/io/papermc/paper/event/entity/EntityDamageItemEvent.java @@ -0,0 +1,79 @@ +package io.papermc.paper.event.entity; + +import org.bukkit.entity.Entity; +import org.bukkit.event.Cancellable; +import org.bukkit.event.HandlerList; +import org.bukkit.event.entity.EntityEvent; +import org.bukkit.inventory.ItemStack; +import org.jetbrains.annotations.ApiStatus; +import org.jspecify.annotations.NullMarked; + +/** + * Called when an item on or used by an entity takes durability damage as a result of being hit/used. + *

+ * NOTE: default vanilla behaviour dictates that armor/tools picked up by + * mobs do not take damage (except via Thorns). + */ +@NullMarked +public class EntityDamageItemEvent extends EntityEvent implements Cancellable { + + private static final HandlerList HANDLER_LIST = new HandlerList(); + + private final ItemStack item; + private int damage; + + private boolean cancelled; + + @ApiStatus.Internal + public EntityDamageItemEvent(final Entity entity, final ItemStack item, final int damage) { + super(entity); + this.item = item; + this.damage = damage; + } + + /** + * Gets the item being damaged. + * + * @return the item + */ + public ItemStack getItem() { + return this.item; + } + + /** + * Gets the amount of durability damage this item will be taking. + * + * @return durability change + */ + public int getDamage() { + return this.damage; + } + + /** + * Sets the amount of durability damage this item will be taking. + * + * @param damage the damage amount to cause + */ + public void setDamage(final int damage) { + this.damage = damage; + } + + @Override + public boolean isCancelled() { + return this.cancelled; + } + + @Override + public void setCancelled(final boolean cancel) { + this.cancelled = cancel; + } + + @Override + public HandlerList getHandlers() { + return HANDLER_LIST; + } + + public static HandlerList getHandlerList() { + return HANDLER_LIST; + } +}