aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch')
-rw-r--r--patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch48
1 files changed, 48 insertions, 0 deletions
diff --git a/patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch b/patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch
new file mode 100644
index 0000000000..ffa6fc8f05
--- /dev/null
+++ b/patches/api/0310-Add-methods-to-find-targets-for-lightning-strikes.patch
@@ -0,0 +1,48 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Jakub Zacek <[email protected]>
+Date: Mon, 4 Oct 2021 08:29:36 +0200
+Subject: [PATCH] Add methods to find targets for lightning strikes
+
+
+diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java
+index f4d31d9d0f4cbd2621adf97a20b65ae83e5fd064..6953851a5177e9df3746f7a743f27ef02845e522 100644
+--- a/src/main/java/org/bukkit/World.java
++++ b/src/main/java/org/bukkit/World.java
+@@ -746,6 +746,37 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient
+ @NotNull
+ public LightningStrike strikeLightningEffect(@NotNull Location loc);
+
++ // Paper start
++ /**
++ * Finds the location of the nearest unobstructed Lightning Rod in a 128-block
++ * radius around the given location. Returns {@code null} if no Lightning Rod is found.
++ *
++ * <p>Note: To activate a Lightning Rod, the position one block above it must be struck by lightning.</p>
++ *
++ * @param location {@link Location} to search for Lightning Rod around
++ * @return {@link Location} of Lightning Rod or {@code null}
++ */
++ @Nullable
++ public Location findLightningRod(@NotNull Location location);
++
++ /**
++ * Finds a target {@link Location} for lightning to strike.
++ * <p>It selects from (in the following order):</p>
++ * <ol>
++ * <li>the block above the nearest Lightning Rod, found using {@link World#findLightningRod(Location)}</li>
++ * <li>a random {@link LivingEntity} that can see the sky in a 6x6 cuboid
++ * around input X/Z coordinates. Y ranges from <i>the highest motion-blocking
++ * block at the input X/Z - 3</i> to <i>the height limit + 3</i></li>
++ * </ol>
++ * <p>Returns {@code null} if no target is found.</p>
++ *
++ * @param location {@link Location} to search for target around
++ * @return lightning target or {@code null}
++ */
++ @Nullable
++ public Location findLightningTarget(@NotNull Location location);
++ // Paper end
++
+ /**
+ * Get a list of all entities in this World
+ *