Struct CharacterController 

pub struct CharacterController {
    pub position: Vec3Fix,
    pub velocity: Vec3Fix,
    pub grounded: bool,
    pub config: CharacterConfig,
    pub ground_body_index: Option<usize>,
    pub platform_velocity: Vec3Fix,
}

Kinematic character controller

Fields

position: Vec3Fix

Current position (capsule center)

velocity: Vec3Fix

Current velocity

grounded: bool

Whether the character is on the ground

config: CharacterConfig

Configuration

ground_body_index: Option<usize>

Index of the ground body (for moving platform support)

platform_velocity: Vec3Fix

Velocity inherited from the moving platform

Implementations

impl CharacterController

pub const fn new(position: Vec3Fix, config: CharacterConfig) -> Self

Create a new character controller at the given position

pub fn new_default(position: Vec3Fix) -> Self

Create with default config

pub fn feet_position(&self) -> Vec3Fix

Get the bottom of the capsule (feet position)

pub fn move_and_slide( &mut self, displacement: Vec3Fix, bodies: &[RigidBody], sdf_colliders: &[SdfCollider], ) -> MoveResult

Move the character by the given displacement, sliding along colliders.

Uses the “collide and slide” algorithm:

1. Try to move the full displacement
2. On collision, project remaining displacement onto the collision plane
3. Repeat up to max_slides times

Static bodies are seen as spheres of the character’s radius at their positions (see sweep_against_bodies); for the true shapes and the world’s static colliders use crate::solver::PhysicsWorld::move_character.

pub fn compute_push_impulses( &self, bodies: &[RigidBody], body_radius: Fix128, ) -> Vec<PushImpulse>

Compute push impulses for dynamic bodies overlapping the character.

Call this after move_and_slide to get impulses that should be applied to nearby dynamic bodies. Apply them via body.apply_impulse_at().

pub const fn get_platform_velocity(&self) -> Vec3Fix

Get the velocity of the platform the character is standing on

pub fn apply_gravity(&mut self, gravity: Vec3Fix, dt: Fix128)

Integrate gravity into the velocity while airborne (v += g·dt).

Does not move the character; the position update happens in the controller’s own step / move path (before 1.2.0 the doc claimed “and update position”, which the code never did).

Trait Implementations

impl Debug for CharacterController

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.