From a159e27b872fa26820868e05f94dd968a2370a84 Mon Sep 17 00:00:00 2001 From: Bukkit/Spigot Date: Sun, 18 Nov 2018 09:32:49 +1100 Subject: [PATCH] SPIGOT-4487: Clarify PlayerInteractEvent docs By: md_5 --- .../org/bukkit/event/player/PlayerInteractEvent.java | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java index 0c841fb1fe..fdad4cd351 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java @@ -8,6 +8,7 @@ import org.bukkit.Material; import org.bukkit.entity.Player; import org.bukkit.event.Cancellable; import org.bukkit.event.block.Action; +import org.bukkit.event.block.BlockCanBuildEvent; import org.bukkit.inventory.EquipmentSlot; /** @@ -15,8 +16,12 @@ import org.bukkit.inventory.EquipmentSlot; * air, potentially fired once for each hand. The hand can be determined using * {@link #getHand()}. *

- * This event will fire as cancelled if the vanilla behavior - * is to do nothing (e.g interacting with air) + * This event will fire as cancelled if the vanilla behavior is to do nothing + * (e.g interacting with air). For the purpose of avoiding doubt, this means + * that the event will only be in the cancelled state if it is fired as a result + * of some prediction made by the server where no subsequent code will run, + * rather than when the subsequent interaction activity (e.g. placing a block in + * an illegal position ({@link BlockCanBuildEvent}) will fail. */ public class PlayerInteractEvent extends PlayerEvent implements Cancellable { private static final HandlerList handlers = new HandlerList();