Add Entity.isOnGround(). Adds BUKKIT-3787

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
      *

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.
      *