2019-09-10 18:51:02 +00:00
|
|
|
From e31205e58fdc02cb6102c7f710a61a1ff8499067 Mon Sep 17 00:00:00 2001
|
2018-08-04 23:38:58 +00:00
|
|
|
From: Aikar <aikar@aikar.co>
|
|
|
|
Date: Sat, 4 Aug 2018 19:37:35 -0400
|
|
|
|
Subject: [PATCH] Provide Chunk Coordinates as a Long API
|
|
|
|
|
|
|
|
Allows you to easily access the chunks X/z as a long, and a method
|
|
|
|
to look up by the long key too.
|
|
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/Chunk.java b/src/main/java/org/bukkit/Chunk.java
|
2019-09-10 18:51:02 +00:00
|
|
|
index 95e485ee..7b0424d5 100644
|
2018-08-04 23:38:58 +00:00
|
|
|
--- a/src/main/java/org/bukkit/Chunk.java
|
|
|
|
+++ b/src/main/java/org/bukkit/Chunk.java
|
2019-09-10 18:51:02 +00:00
|
|
|
@@ -27,6 +27,32 @@ public interface Chunk {
|
2018-08-04 23:38:58 +00:00
|
|
|
*/
|
|
|
|
int getZ();
|
|
|
|
|
|
|
|
+ // Paper start
|
|
|
|
+ /**
|
|
|
|
+ * @return The Chunks X and Z coordinates packed into a long
|
|
|
|
+ */
|
|
|
|
+ default long getChunkKey() {
|
2018-09-21 20:56:08 +00:00
|
|
|
+ return getChunkKey(getX(), getZ());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param loc Location to get chunk key
|
|
|
|
+ * @return Location's chunk coordinates packed into a long
|
|
|
|
+ */
|
2019-03-20 00:28:15 +00:00
|
|
|
+ static long getChunkKey(@NotNull Location loc) {
|
2018-09-21 20:56:08 +00:00
|
|
|
+ return getChunkKey((int) Math.floor(loc.getX()) << 4, (int) Math.floor(loc.getZ()) << 4);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param x X Coordinate
|
|
|
|
+ * @param z Z Coordinate
|
|
|
|
+ * @return Chunk coordinates packed into a long
|
|
|
|
+ */
|
|
|
|
+ static long getChunkKey(int x, int z) {
|
|
|
|
+ return (long) x & 0xffffffffL | ((long) z & 0xffffffffL) << 32;
|
2018-08-04 23:38:58 +00:00
|
|
|
+ }
|
|
|
|
+ // Paper end
|
|
|
|
+
|
|
|
|
/**
|
|
|
|
* Gets the world containing this chunk
|
|
|
|
*
|
|
|
|
diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java
|
2019-09-10 18:51:02 +00:00
|
|
|
index 59cfe1ce..00a542f8 100644
|
2018-08-04 23:38:58 +00:00
|
|
|
--- a/src/main/java/org/bukkit/World.java
|
|
|
|
+++ b/src/main/java/org/bukkit/World.java
|
2019-07-11 16:59:21 +00:00
|
|
|
@@ -158,6 +158,22 @@ public interface World extends PluginMessageRecipient, Metadatable {
|
2019-03-20 00:28:15 +00:00
|
|
|
@NotNull
|
|
|
|
public Chunk getChunkAt(@NotNull Block block);
|
2018-08-04 23:38:58 +00:00
|
|
|
|
|
|
|
+ // Paper start
|
|
|
|
+ /**
|
|
|
|
+ * Gets the chunk at the specified chunk key, which is the X and Z packed into a long.
|
|
|
|
+ *
|
|
|
|
+ * See {@link Chunk#getChunkKey()} for easy access to the key, or you may calculate it as:
|
2018-08-16 11:20:58 +00:00
|
|
|
+ * long chunkKey = (long) chunkX & 0xffffffffL | ((long) chunkZ & 0xffffffffL) >> 32;
|
2018-08-04 23:38:58 +00:00
|
|
|
+ *
|
|
|
|
+ * @param chunkKey The Chunk Key to look up the chunk by
|
|
|
|
+ * @return The chunk at the specified key
|
|
|
|
+ */
|
2019-03-20 00:28:15 +00:00
|
|
|
+ @NotNull
|
2018-08-04 23:38:58 +00:00
|
|
|
+ public default Chunk getChunkAt(long chunkKey) {
|
|
|
|
+ return getChunkAt((int) chunkKey, (int) (chunkKey >> 32));
|
|
|
|
+ }
|
|
|
|
+ // Paper end
|
|
|
|
+
|
|
|
|
/**
|
2018-09-21 20:56:08 +00:00
|
|
|
* Checks if the specified {@link Chunk} is loaded
|
|
|
|
*
|
2018-08-04 23:38:58 +00:00
|
|
|
--
|
2019-09-10 18:51:02 +00:00
|
|
|
2.23.0
|
2018-08-04 23:38:58 +00:00
|
|
|
|