added 'on_ground' and clarifications around motion.

docs/scarpet/Full.md

@@ -2567,12 +2567,18 @@ Returns a 3d vector where the entity is looking.
 
 ### `query(e, 'motion')`
 
-Triple of entity's motion vector, `l(motion_x, motion_y, motion_z)`
+Triple of entity's motion vector, `l(motion_x, motion_y, motion_z)`. Motion represents the velocity from all the forces
+that exert on the given entity. Things that are not 'forces' like voluntary movement, or reaction from the ground are
+not part of said forces.
 
 ### `query(e, 'motion_x'), query(e, 'motion_y'), query(e, 'motion_z')`
 
 Respective component of the entity's motion vector
 
+### `query(e, 'on_ground')`
+
+Returns `true` if en entity is standing on firm ground and falling down due to that.
+
 ### `query(e, 'name'), query(e, 'display_name'), query(e, 'custom_name'), query(e, 'type')`
 
 String of entity name

docs/scarpet/api/Entities.md

@@ -133,12 +133,18 @@ Returns a 3d vector where the entity is looking.
 
 ### `query(e, 'motion')`
 
-Triple of entity's motion vector, `l(motion_x, motion_y, motion_z)`
+Triple of entity's motion vector, `l(motion_x, motion_y, motion_z)`. Motion represents the velocity from all the forces
+that exert on the given entity. Things that are not 'forces' like voluntary movement, or reaction from the ground are
+not part of said forces.
 
 ### `query(e, 'motion_x'), query(e, 'motion_y'), query(e, 'motion_z')`
 
 Respective component of the entity's motion vector
 
+### `query(e, 'on_ground')`
+
+Returns `true` if en entity is standing on firm ground and falling down due to that.
+
 ### `query(e, 'name'), query(e, 'display_name'), query(e, 'custom_name'), query(e, 'type')`
 
 String of entity name

src/main/java/carpet/script/value/EntityValue.java

@@ -277,6 +277,7 @@ public class EntityValue extends Value
         put("motion_x", (e, a) -> new NumericValue(e.getVelocity().x));
         put("motion_y", (e, a) -> new NumericValue(e.getVelocity().y));
         put("motion_z", (e, a) -> new NumericValue(e.getVelocity().z));
+        put("on_ground", (e, a) -> new NumericValue(e.onGround));
         put("name", (e, a) -> new StringValue(e.getName().getString()));
         put("display_name", (e, a) -> new StringValue(e.getDisplayName().getString()));
         put("command_name", (e, a) -> new StringValue(e.getEntityName()));