From 2f8f3cf4200f9518d8cae03fd7a55dc1a24c82a3 Mon Sep 17 00:00:00 2001 From: Chad Waters Date: Sun, 17 Mar 2013 11:59:04 -0400 Subject: Add Entity.isOnGround(). Adds BUKKIT-3787 --- src/main/java/org/bukkit/entity/Entity.java | 8 ++++++++ src/main/java/org/bukkit/entity/Player.java | 11 +++++++++++ 2 files changed, 19 insertions(+) (limited to 'src') diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java index 771316d8..d33f8365 100644 --- a/src/main/java/org/bukkit/entity/Entity.java +++ b/src/main/java/org/bukkit/entity/Entity.java @@ -46,6 +46,14 @@ public interface Entity extends Metadatable { */ public Vector getVelocity(); + /** + * Returns true if the entity is supported by a block. This value is a state + * updated by the server and is not recalculated unless the entity moves. + * + * @return True if entity is on ground. + */ + public boolean isOnGround(); + /** * Gets the current world this entity resides in * diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index d287d78a..075db15f 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -530,6 +530,17 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline */ public boolean canSee(Player player); + /** + * Checks to see if this player is currently standing on a block. This information may + * not be reliable, as it is a state provided by the client, and may therefore not be accurate. + * + * @return True if the player standing on a solid block, else false. + * @deprecated Inconsistent with {@link org.bukkit.craftbukkit.entity.Entity#isOnGround()} + */ + @Override + @Deprecated + public boolean isOnGround(); + /** * Checks to see if this player is currently flying or not. * -- cgit v1.2.3