PaperMC/patches/api/0430-Expand-Pose-API.patch

54 lines
2 KiB
Diff
Raw Normal View History

2023-08-22 05:05:47 +02:00
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: SoSeDiK <mrsosedik@gmail.com>
Date: Wed, 11 Jan 2023 20:59:02 +0200
Subject: [PATCH] Expand Pose API
diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java
2023-12-05 18:33:18 +01:00
index 82c67193a2dbb7b0bd0d6381cd0e06af49415d18..1d0fd7ff8449f815a7d980af0b378181ea8bf8d8 100644
2023-08-22 05:05:47 +02:00
--- a/src/main/java/org/bukkit/entity/Entity.java
+++ b/src/main/java/org/bukkit/entity/Entity.java
2023-12-05 18:33:18 +01:00
@@ -799,6 +799,42 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent
2023-08-22 05:05:47 +02:00
* @param sneak true if the entity should be sneaking
*/
void setSneaking(boolean sneak);
+
+ /**
+ * Sets the entity's current {@link Pose}.
+ *
+ * <p>Note: While poses affect some things like hitboxes, they do not change the entity's state
+ * (e.g. having {@link Pose#SNEAKING} does not guarantee {@link #isSneaking()} being {@code true}).
+ *
+ * <p>If applied to the {@link Player}, they might see a different pose client-side.
+ *
+ * @param pose a new {@link Pose}
+ * @see #setPose(Pose, boolean)
+ */
+ default void setPose(@NotNull Pose pose) {
+ setPose(pose, false);
+ }
+
+ /**
+ * Sets the entity's current {@link Pose}.
+ *
+ * <p>Note: While poses affect some things like hitboxes, they do not change the entity's state
+ * (e.g. having {@link Pose#SNEAKING} does not guarantee {@link #isSneaking()} being {@code true}).
+ *
+ * <p>If applied to the {@link Player}, they might see a different pose client-side.
+ *
+ * @param pose a new {@link Pose}
+ * @param fixed whether the new {@link Pose} should stay until manually changed
+ */
+ void setPose(@NotNull Pose pose, boolean fixed);
+
+ /**
+ * Checks whether the entity has a fixed {@link Pose}
+ *
+ * @see #setPose(Pose, boolean)
+ * @return whether the entity has a fixed {@link Pose}
+ */
+ boolean hasFixedPose();
// Paper end
/**