mirror of
https://github.com/PaperMC/Paper.git
synced 2024-08-26 06:33:07 +02:00
423 lines
13 KiB
Diff
423 lines
13 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Jake Potrebic <jake.m.potrebic@gmail.com>
|
|
Date: Sun, 20 Mar 2022 10:42:28 -0700
|
|
Subject: [PATCH] Add Position
|
|
|
|
|
|
diff --git a/src/main/java/io/papermc/paper/math/BlockPosition.java b/src/main/java/io/papermc/paper/math/BlockPosition.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..f164d32cfbd5bfd84f3067a149d34bb1185a7e00
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/math/BlockPosition.java
|
|
@@ -0,0 +1,98 @@
|
|
+package io.papermc.paper.math;
|
|
+
|
|
+import org.bukkit.Axis;
|
|
+import org.bukkit.block.BlockFace;
|
|
+import org.jetbrains.annotations.ApiStatus;
|
|
+import org.jetbrains.annotations.Contract;
|
|
+import org.jetbrains.annotations.NotNull;
|
|
+
|
|
+/**
|
|
+ * A position represented with integers.
|
|
+ * <p>
|
|
+ * <b>May see breaking changes until Experimental annotation is removed.</b>
|
|
+ * @see FinePosition
|
|
+ */
|
|
+@ApiStatus.Experimental
|
|
+public interface BlockPosition extends Position {
|
|
+
|
|
+ @Override
|
|
+ default double x() {
|
|
+ return this.blockX();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default double y() {
|
|
+ return this.blockY();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default double z() {
|
|
+ return this.blockZ();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default boolean isBlock() {
|
|
+ return true;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default boolean isFine() {
|
|
+ return false;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull BlockPosition toBlock() {
|
|
+ return this;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull BlockPosition offset(int x, int y, int z) {
|
|
+ return x == 0 && y == 0 && z == 0 ? this : new BlockPositionImpl(this.blockX() + x, this.blockY() + y, this.blockZ() + z);
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull FinePosition offset(double x, double y, double z) {
|
|
+ return new FinePositionImpl(this.blockX() + z, this.blockY() + y, this.blockZ() + z);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Returns a block position offset by 1 in the direction specified.
|
|
+ *
|
|
+ * @param blockFace the block face to offset towards
|
|
+ * @return the offset block position
|
|
+ */
|
|
+ @Contract(value = "_ -> new", pure = true)
|
|
+ default @NotNull BlockPosition offset(@NotNull BlockFace blockFace) {
|
|
+ return this.offset(blockFace, 1);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Returns a block position offset in the direction specified
|
|
+ * multiplied by the amount.
|
|
+ *
|
|
+ * @param blockFace the block face to offset towards
|
|
+ * @param amount the number of times to move in that direction
|
|
+ * @return the offset block position
|
|
+ */
|
|
+ @Contract(pure = true)
|
|
+ default @NotNull BlockPosition offset(@NotNull BlockFace blockFace, int amount) {
|
|
+ return amount == 0 ? this : new BlockPositionImpl(this.blockX() + (blockFace.getModX() * amount), this.blockY() + (blockFace.getModY() * amount), this.blockZ() + (blockFace.getModZ() * amount));
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Returns a block position offset by the amount along
|
|
+ * the specified axis.
|
|
+ *
|
|
+ * @param axis the axis to offset along
|
|
+ * @param amount the amount to offset along that axis
|
|
+ * @return the offset block position
|
|
+ */
|
|
+ @Contract(pure = true)
|
|
+ default @NotNull BlockPosition offset(@NotNull Axis axis, int amount) {
|
|
+ return amount == 0 ? this : switch (axis) {
|
|
+ case X -> new BlockPositionImpl(this.blockX() + amount, this.blockY(), this.blockZ());
|
|
+ case Y -> new BlockPositionImpl(this.blockX(), this.blockY() + amount, this.blockZ());
|
|
+ case Z -> new BlockPositionImpl(this.blockX(), this.blockY(), this.blockZ() + amount);
|
|
+ };
|
|
+ }
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/math/BlockPositionImpl.java b/src/main/java/io/papermc/paper/math/BlockPositionImpl.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..eb5a3f26c7ba56c6715827f52c0013a860ec7d9a
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/math/BlockPositionImpl.java
|
|
@@ -0,0 +1,4 @@
|
|
+package io.papermc.paper.math;
|
|
+
|
|
+record BlockPositionImpl(int blockX, int blockY, int blockZ) implements BlockPosition {
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/math/FinePosition.java b/src/main/java/io/papermc/paper/math/FinePosition.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..d8df70d731573cf2446044925f218876d62fd7cf
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/math/FinePosition.java
|
|
@@ -0,0 +1,56 @@
|
|
+package io.papermc.paper.math;
|
|
+
|
|
+import org.bukkit.util.NumberConversions;
|
|
+import org.bukkit.util.Vector;
|
|
+import org.jetbrains.annotations.ApiStatus;
|
|
+import org.jetbrains.annotations.NotNull;
|
|
+
|
|
+/**
|
|
+ * A position represented with doubles.
|
|
+ * <p>
|
|
+ * <b>May see breaking changes until Experimental annotation is removed.</b>
|
|
+ * @see BlockPosition
|
|
+ */
|
|
+@ApiStatus.Experimental
|
|
+public interface FinePosition extends Position {
|
|
+
|
|
+ @Override
|
|
+ default int blockX() {
|
|
+ return NumberConversions.floor(this.x());
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default int blockY() {
|
|
+ return NumberConversions.floor(this.y());
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default int blockZ() {
|
|
+ return NumberConversions.floor(this.z());
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default boolean isBlock() {
|
|
+ return false;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default boolean isFine() {
|
|
+ return true;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull BlockPosition toBlock() {
|
|
+ return new BlockPositionImpl(this.blockX(), this.blockY(), this.blockZ());
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull FinePosition offset(int x, int y, int z) {
|
|
+ return this.offset((double) x, y, z);
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ default @NotNull FinePosition offset(double x, double y, double z) {
|
|
+ return x == 0.0 && y == 0.0 && z == 0.0 ? this : new FinePositionImpl(this.x() + x, this.y() + y, this.z() + z);
|
|
+ }
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/math/FinePositionImpl.java b/src/main/java/io/papermc/paper/math/FinePositionImpl.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..93476aaf8d21efb5a30b6d2cc2eeda8100fb72d0
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/math/FinePositionImpl.java
|
|
@@ -0,0 +1,4 @@
|
|
+package io.papermc.paper.math;
|
|
+
|
|
+record FinePositionImpl(double x, double y, double z) implements FinePosition {
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/math/Position.java b/src/main/java/io/papermc/paper/math/Position.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..300da713dcc303b340efad70efe57facf5422964
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/math/Position.java
|
|
@@ -0,0 +1,184 @@
|
|
+package io.papermc.paper.math;
|
|
+
|
|
+import org.bukkit.Location;
|
|
+import org.bukkit.World;
|
|
+import org.bukkit.util.Vector;
|
|
+import org.jetbrains.annotations.ApiStatus;
|
|
+import org.jetbrains.annotations.Contract;
|
|
+import org.jetbrains.annotations.NotNull;
|
|
+
|
|
+/**
|
|
+ * Common interface for {@link FinePosition} and {@link BlockPosition}.
|
|
+ * <p>
|
|
+ * <b>May see breaking changes until Experimental annotation is removed.</b>
|
|
+ */
|
|
+@ApiStatus.Experimental
|
|
+public interface Position {
|
|
+
|
|
+ FinePosition FINE_ZERO = new FinePositionImpl(0, 0, 0);
|
|
+ BlockPosition BLOCK_ZERO = new BlockPositionImpl(0, 0, 0);
|
|
+
|
|
+ /**
|
|
+ * Gets the block x value for this position
|
|
+ *
|
|
+ * @return the block x value
|
|
+ */
|
|
+ int blockX();
|
|
+
|
|
+ /**
|
|
+ * Gets the block x value for this position
|
|
+ *
|
|
+ * @return the block x value
|
|
+ */
|
|
+ int blockY();
|
|
+
|
|
+ /**
|
|
+ * Gets the block x value for this position
|
|
+ *
|
|
+ * @return the block x value
|
|
+ */
|
|
+ int blockZ();
|
|
+
|
|
+ /**
|
|
+ * Gets the x value for this position
|
|
+ *
|
|
+ * @return the x value
|
|
+ */
|
|
+ double x();
|
|
+
|
|
+ /**
|
|
+ * Gets the y value for this position
|
|
+ *
|
|
+ * @return the y value
|
|
+ */
|
|
+ double y();
|
|
+
|
|
+ /**
|
|
+ * Gets the z value for this position
|
|
+ *
|
|
+ * @return the z value
|
|
+ */
|
|
+ double z();
|
|
+
|
|
+ /**
|
|
+ * Checks of this position represents a {@link BlockPosition}
|
|
+ *
|
|
+ * @return true if block
|
|
+ */
|
|
+ boolean isBlock();
|
|
+
|
|
+ /**
|
|
+ * Checks if this position represents a {@link FinePosition}
|
|
+ *
|
|
+ * @return true if fine
|
|
+ */
|
|
+ boolean isFine();
|
|
+
|
|
+ /**
|
|
+ * Returns a position offset by the specified amounts.
|
|
+ *
|
|
+ * @param x x value to offset
|
|
+ * @param y y value to offset
|
|
+ * @param z z value to offset
|
|
+ * @return the offset position
|
|
+ */
|
|
+ @NotNull Position offset(int x, int y, int z);
|
|
+
|
|
+ /**
|
|
+ * Returns a position offset by the specified amounts.
|
|
+ *
|
|
+ * @param x x value to offset
|
|
+ * @param y y value to offset
|
|
+ * @param z z value to offset
|
|
+ * @return the offset position
|
|
+ */
|
|
+ @NotNull FinePosition offset(double x, double y, double z);
|
|
+
|
|
+ /**
|
|
+ * Returns a new position at the center of the block position this represents
|
|
+ *
|
|
+ * @return a new center position
|
|
+ */
|
|
+ @Contract(value = "-> new", pure = true)
|
|
+ default @NotNull FinePosition toCenter() {
|
|
+ return new FinePositionImpl(this.blockX() + 0.5, this.blockY() + 0.5, this.blockZ() + 0.5);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Returns the block position of this position
|
|
+ * or itself if it already is a block position
|
|
+ *
|
|
+ * @return the block position
|
|
+ */
|
|
+ @Contract(pure = true)
|
|
+ @NotNull BlockPosition toBlock();
|
|
+
|
|
+ /**
|
|
+ * Converts this position to a vector
|
|
+ *
|
|
+ * @return a new vector
|
|
+ */
|
|
+ @Contract(value = "-> new", pure = true)
|
|
+ default @NotNull Vector toVector() {
|
|
+ return new Vector(this.x(), this.y(), this.z());
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Creates a new location object at this position with the specified world
|
|
+ *
|
|
+ * @param world the world for the location object
|
|
+ * @return a new location
|
|
+ */
|
|
+ @Contract(value = "_ -> new", pure = true)
|
|
+ default @NotNull Location toLocation(@NotNull World world) {
|
|
+ return new Location(world, this.x(), this.y(), this.z());
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Creates a position at the coordinates
|
|
+ *
|
|
+ * @param x x coord
|
|
+ * @param y y coord
|
|
+ * @param z z coord
|
|
+ * @return a position with those coords
|
|
+ */
|
|
+ @Contract(value = "_, _, _ -> new", pure = true)
|
|
+ static @NotNull BlockPosition block(int x, int y, int z) {
|
|
+ return new BlockPositionImpl(x, y, z);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Creates a position from the location.
|
|
+ *
|
|
+ * @param location the location to copy the position of
|
|
+ * @return a new position at that location
|
|
+ */
|
|
+ @Contract(value = "_ -> new", pure = true)
|
|
+ static @NotNull BlockPosition block(@NotNull Location location) {
|
|
+ return new BlockPositionImpl(location.getBlockX(), location.getBlockY(), location.getBlockZ());
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Creates a position at the coordinates
|
|
+ *
|
|
+ * @param x x coord
|
|
+ * @param y y coord
|
|
+ * @param z z coord
|
|
+ * @return a position with those coords
|
|
+ */
|
|
+ @Contract(value = "_, _, _ -> new", pure = true)
|
|
+ static @NotNull FinePosition fine(double x, double y, double z) {
|
|
+ return new FinePositionImpl(x, y, z);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Creates a position from the location.
|
|
+ *
|
|
+ * @param location the location to copy the position of
|
|
+ * @return a new position at that location
|
|
+ */
|
|
+ @Contract(value = "_ -> new", pure = true)
|
|
+ static @NotNull FinePosition fine(@NotNull Location location) {
|
|
+ return new FinePositionImpl(location.getX(), location.getY(), location.getZ());
|
|
+ }
|
|
+}
|
|
diff --git a/src/main/java/org/bukkit/Location.java b/src/main/java/org/bukkit/Location.java
|
|
index 7c4db051472fb6a6c6d24092dc6f75487356690a..3b99f359f556e6f2c341d55fa69b7462e69b6546 100644
|
|
--- a/src/main/java/org/bukkit/Location.java
|
|
+++ b/src/main/java/org/bukkit/Location.java
|
|
@@ -20,7 +20,7 @@ import org.jetbrains.annotations.Nullable;
|
|
* magnitude than 360 are valid, but may be normalized to any other equivalent
|
|
* representation by the implementation.
|
|
*/
|
|
-public class Location implements Cloneable, ConfigurationSerializable {
|
|
+public class Location implements Cloneable, ConfigurationSerializable, io.papermc.paper.math.FinePosition { // Paper
|
|
private Reference<World> world;
|
|
private double x;
|
|
private double y;
|
|
@@ -706,4 +706,26 @@ public class Location implements Cloneable, ConfigurationSerializable {
|
|
}
|
|
return pitch;
|
|
}
|
|
+
|
|
+ // Paper - add Position
|
|
+ @Override
|
|
+ public double x() {
|
|
+ return this.getX();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ public double y() {
|
|
+ return this.getY();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ public double z() {
|
|
+ return this.getZ();
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ public @NotNull Location toLocation(@NotNull World world) {
|
|
+ return new Location(world, this.x(), this.y(), this.z(), this.getYaw(), this.getPitch());
|
|
+ }
|
|
+ // Paper end
|
|
}
|