aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0396-More-Sign-Block-API.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0396-More-Sign-Block-API.patch')
-rw-r--r--patches/api/0396-More-Sign-Block-API.patch70
1 files changed, 70 insertions, 0 deletions
diff --git a/patches/api/0396-More-Sign-Block-API.patch b/patches/api/0396-More-Sign-Block-API.patch
new file mode 100644
index 0000000000..57b372521c
--- /dev/null
+++ b/patches/api/0396-More-Sign-Block-API.patch
@@ -0,0 +1,70 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Jake Potrebic <[email protected]>
+Date: Fri, 23 Jun 2023 12:16:35 -0700
+Subject: [PATCH] More Sign Block API
+
+Co-authored-by: SoSeDiK <[email protected]>
+
+diff --git a/src/main/java/org/bukkit/block/Sign.java b/src/main/java/org/bukkit/block/Sign.java
+index 1fdb1144949adc3a2b5cbc3aca94d2f8e0c6d9ee..340e3adcc57227f2e570826681ea81b9159805de 100644
+--- a/src/main/java/org/bukkit/block/Sign.java
++++ b/src/main/java/org/bukkit/block/Sign.java
+@@ -182,9 +182,58 @@ public interface Sign extends TileState, Colorable {
+ /**
+ * Gets the player that is currently allowed to edit this sign. <br>
+ * Edits from other players will be rejected if this value is not null.
++ * <br><br>You should prefer {@link #getAllowedEditorUniqueId()} if you don't
++ * need the player instance as this method will fetch the player from UUID.
+ *
+ * @return the player allowed to edit this sign, or null
+ */
+ @Nullable
+ public Player getAllowedEditor();
++ // Paper start - More Sign Block API
++ /**
++ * Gets the allowed editor's UUID.
++ * <br>Edits from other players will be rejected if this value is not null.
++ *
++ * @return the allowed editor's UUID, or null
++ */
++ @Nullable java.util.UUID getAllowedEditorUniqueId();
++
++ /**
++ * Sets the allowed editor's UUID.
++ * <br><br><b>Note:</b> the server sets the UUID back to null if the player can't
++ * interact with the sign (is either offline or outside the allowed interaction range).
++ *
++ * @param uuid the allowed editor's UUID
++ */
++ void setAllowedEditorUniqueId(@Nullable java.util.UUID uuid);
++
++ /**
++ * Compute the side facing the specified entity.
++ *
++ * @param entity the entity
++ * @return the side it is facing
++ */
++ default @NotNull Side getInteractableSideFor(org.bukkit.entity.@NotNull Entity entity) {
++ return this.getInteractableSideFor(entity.getLocation());
++ }
++
++ /**
++ * Compute the side facing the specific position.
++ *
++ * @param position the position
++ * @return the side the position is facing
++ */
++ default @NotNull Side getInteractableSideFor(io.papermc.paper.math.@NotNull Position position) {
++ return this.getInteractableSideFor(position.x(), position.z());
++ }
++
++ /**
++ * Compute the side facing the specific x and z coordinates.
++ *
++ * @param x the x coord
++ * @param z the z coord
++ * @return the side the coordinates are facing
++ */
++ @NotNull Side getInteractableSideFor(double x, double z);
++ // Paper end - More Sign Block API
+ }