Hull Ground Sensor

Finds the ground under the character and decides when an edge is left. It sets how close to a ledge the player can stand.

Finds the ground under the character, how steep it is and whether it can be stood on. Its footing decides what happens at an edge: a round foot rolls off, a flat foot stands until nothing is under it, a point stands until its centre passes the edge.

How it works

Finds the ground by sweeping the hull a short way down, as the reference shooter's ground trace does. The ground counts as walkable when its slope is within the motor's limit, and as grounded when the character is also not moving away from it (for example right after a jump).

Footing sets how the character stands on an edge:

• Round: the hull's own shape decides. A capsule sinks as its round bottom moves over the edge, then rolls off once the corner it rests on is too steep. Most capsule controllers feel like this.
• Flat: the character stands at full height while any of its footprint is over ground, like a cylinder, and drops cleanly once all of it is past the edge.
• Point: only the centre of the feet counts, as in classic 3D platformers. Full height until the centre passes the edge, then a drop; the body may hang over the edge by half its width. Flat and Point find the floor with rays, so they read a floor's true slope, never a corner's slanted one.

On a ledge corner a sweep reports the corner's slanted normal. With Use Surface Normal on (Round only), the sensor looks at the floor next to the corner instead, so a capsule stands a little longer before rolling off.

Combine it

• Used by the presets: Arena Shooter, Competitive Shooter, Surf, Retro Platformer, Modern Platformer, Traversal Adventure, Action RPG.

Properties

Additional resources

• How modules combine
• Known limitations