From a33042ba9c68ca5c2188fbb669d53ac7a66d584d Mon Sep 17 00:00:00 2001 From: CJH3139 Date: Mon, 17 Aug 2026 19:07:15 -0700 Subject: [PATCH 1/2] Correct MOB_GRIEFING javadoc on explode events --- .../java/org/bukkit/event/block/BlockExplodeEvent.java | 3 --- .../org/bukkit/event/entity/EntityExplodeEvent.java | 10 +++++++--- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockExplodeEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockExplodeEvent.java index 11d5e8b21e5a..ae6ada415e07 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockExplodeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockExplodeEvent.java @@ -15,9 +15,6 @@ * Note that due to the nature of explosions, {@link #getBlock()} will always be * an air block. {@link #getExplodedBlockState()} should be used to get * information about the block state that exploded. - *

- * The event isn't called if the {@link org.bukkit.GameRules#MOB_GRIEFING} - * is disabled as no block interaction will occur. */ public class BlockExplodeEvent extends BlockEvent implements Cancellable { diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java index 84950b371521..6e903d85c981 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java @@ -11,9 +11,13 @@ import org.jetbrains.annotations.NotNull; /** - * Called when an entity explodes interacting with blocks. The - * event isn't called if the {@link org.bukkit.GameRules#MOB_GRIEFING} - * is disabled as no block interaction will occur. + * Called when an entity explodes interacting with blocks. + *

+ * Explosions caused by mobs do no tinteract with blocks + * while {@link org.bukkit.GameRules#MOB_GRIEFING} is disabled + * as no block interaction will occur. That game rule does not + * affect other explosions. For example, a wind charge still calls this event + * with an {@link ExplosionResult#TRIGGER_BLOCK} result. */ public class EntityExplodeEvent extends EntityEvent implements Cancellable { From 7f4aa4f3373914b8886f8a02de9564b458b9da62 Mon Sep 17 00:00:00 2001 From: CJH3139 Date: Wed, 19 Aug 2026 15:40:47 -0700 Subject: [PATCH 2/2] Update paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java Co-authored-by: Nassim Jahnke --- .../main/java/org/bukkit/event/entity/EntityExplodeEvent.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java index 6e903d85c981..55c2eda45420 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java @@ -13,7 +13,7 @@ /** * Called when an entity explodes interacting with blocks. *

- * Explosions caused by mobs do no tinteract with blocks + * Explosions caused by mobs do not interact with blocks * while {@link org.bukkit.GameRules#MOB_GRIEFING} is disabled * as no block interaction will occur. That game rule does not * affect other explosions. For example, a wind charge still calls this event