Abrupt slide off on platform

[vinf100]

Godot version:

3.0

OS/device including version:

Ubuntu 17.10

Issue description:

When using a kinematic body, when the body goes over the edge, instead of smoothly falling, it abruptly drops very quickly. This is unrelated to gravity, as changing the gravity constant has no effect. Also, when the character jumps, the gravity works as expected.

Steps to reproduce:
Have a platform with a collision box and a static body. Have a kinematic body, with a script for movement (using move_and_slide) and gravity, go over the edge of the platform.

Minimal reproduction project:

Test.zip

[Alexander-Alekseev]

Just update your velocity after move_and_slide call:
velocity = move_and_slide(velocity, Vector3(0, -1, 0));

See also: http://docs.godotengine.org/en/3.0/classes/class_kinematicbody.html#class-kinematicbody-move-and-slide

Returns the movement that remained when the body stopped.

[vinf100]

Thank you, that works. Would it be possible to update the documentation on move_and_slide, and the the tutorial for a kinematic character? The documentation is not very clear, and the tutorial makes no mention of having to set the velocity to the return value.

[FeralBytes]

@vinf100 please be more specific, what documentation do you want updated? As Physics Introduction Line 416 shows

velocity = move_and_slide(velocity, Vector2(0, -1))

How do you think the documentation should be changed?

[Calinou]

Maybe this could be mentioned in the class reference to make it more obvious, but I'm not sure how exactly.

[KoBeWi]

Seems like overlooked physics issue
CC @pouleyKetchoupp