diff --git a/paper-api/src/main/java/org/bukkit/entity/Entity.java b/paper-api/src/main/java/org/bukkit/entity/Entity.java index dd3b760621..6f99fe217b 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Entity.java +++ b/paper-api/src/main/java/org/bukkit/entity/Entity.java @@ -94,6 +94,7 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent * moves. * * @return True if entity is on ground. + * @see Player#isOnGround() */ public boolean isOnGround(); diff --git a/paper-api/src/main/java/org/bukkit/entity/Player.java b/paper-api/src/main/java/org/bukkit/entity/Player.java index 263b242b40..1d5bfca29b 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Player.java +++ b/paper-api/src/main/java/org/bukkit/entity/Player.java @@ -163,6 +163,20 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM */ public boolean performCommand(@NotNull String command); + /** + * Returns true if the entity is supported by a block. + * + * This value is a state updated by the client after each movement. + * + * @return True if entity is on ground. + * @deprecated This value is controlled only by the client and is therefore + * unreliable and vulnerable to spoofing and/or desync depending on the + * context/time which it is accessed + */ + @Override + @Deprecated + public boolean isOnGround(); + /** * Returns if the player is in sneak mode *