Paper/patches/api/0448-Add-Structure-check-API.patch

42 lines
1.7 KiB
Diff
Raw Normal View History

2023-12-03 03:11:57 +01:00
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Jake Potrebic <jake.m.potrebic@gmail.com>
Date: Mon, 27 Mar 2023 10:20:06 -0700
Subject: [PATCH] Add Structure check API
diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java
index f72f0f0f8eee95f95adc969d55ba7de82ee30e2a..567a36a4887da8994c9170e2885aa8cc357efa0c 100644
--- a/src/main/java/org/bukkit/World.java
+++ b/src/main/java/org/bukkit/World.java
@@ -76,6 +76,30 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient
*/
int getPlayerCount();
// Paper end
+ // Paper start - structure check API
+ /**
+ * Check if the naturally-generated structure exists at the position.
+ * <p>
+ * Note that if the position is not loaded, this may cause chunk loads/generation
+ * to check if a structure is at that position. Use {@link #isPositionLoaded(io.papermc.paper.math.Position)}
+ * to check if a position is loaded
+ *
+ * @param position the position to check at
+ * @param structure the structure to check for
+ * @return true if that structure exists at the position
+ */
+ boolean hasStructureAt(io.papermc.paper.math.@NotNull Position position, @NotNull Structure structure);
+
+ /**
+ * Checks if this position is loaded.
+ *
+ * @param position position to check
+ * @return true if loaded
+ */
+ default boolean isPositionLoaded(io.papermc.paper.math.@NotNull Position position) {
+ return this.isChunkLoaded(position.blockX() >> 4, position.blockZ() >> 4);
+ }
+ // Paper end
/**
* Gets the {@link Block} at the given coordinates