Struct CharacterController 

pub struct CharacterController {
    pub position: Point3<f32>,
    pub velocity: Vector3<f32>,
    pub yaw: f32,
    pub pitch: f32,
    pub height: f32,
    pub radius: f32,
    pub eye_fraction: f32,
    pub on_ground: bool,
    pub walk_speed: f32,
    pub run_speed: f32,
    pub jump_speed: f32,
    pub gravity: f32,
}

First-person character controller.

position is the foot point — the lowest Y the player occupies. Eyes sit at position.y + height * eye_fraction.

Fields

position: Point3<f32>

Foot position (Y = the floor the player stands on).

velocity: Vector3<f32>

Current velocity in m/s.

Horizontal components are overwritten by input every tick. The vertical component accumulates gravity between frames.

yaw: f32

Horizontal look direction, radians. 0 = facing −Z (into the screen). Increases clockwise when viewed from above.

pitch: f32

Vertical look angle, radians. Clamped to ±~84°.

height: f32

Standing height in metres.

radius: f32

Horizontal half-width of the player AABB (metres).

eye_fraction: f32

Fraction of height at which the eye / camera sits (default 0.86).

on_ground: bool

true when the character is resting on a solid surface.

walk_speed: f32

Walk speed (m/s, used when InputState::sprint is false).

run_speed: f32

Run / sprint speed (m/s).

jump_speed: f32

Upward velocity applied on jump (m/s).

gravity: f32

Gravitational acceleration (m/s², positive = downward).

Implementations

impl CharacterController

pub fn new(pos: Point3<f32>) -> Self

Create a controller with sensible defaults.

The player spawns at pos with feet touching the floor (Y=pos.y). Call tick once per frame to advance the simulation.

pub fn forward_flat(&self) -> Vector3<f32>

Unit vector pointing forward in the horizontal plane (ignores pitch).

pub fn right_flat(&self) -> Vector3<f32>

Unit vector pointing right in the horizontal plane.

pub fn look_dir(&self) -> Vector3<f32>

Full 3-D look direction (yaw + pitch).

pub fn eye_position(&self) -> Point3<f32>

Camera / eye position in world space.

pub fn look_target(&self) -> Point3<f32>

Point the camera should target (eye_position + look_dir).

pub fn apply_to_camera(&self, engine: &mut K3dengine)

Write the eye position and look target into the engine camera.

pub fn tick(&mut self, input: &InputState, dt: f32, colliders: &[[f32; 6]])

Advance one frame of simulation.

Arguments

• input — this frame’s input (direction, look deltas, jump, sprint)
• dt — elapsed time in seconds (clamp to ≤ 0.05 to avoid tunnelling on lag spikes)
• colliders — world geometry as [min_x, min_y, min_z, max_x, max_y, max_z] boxes. Include floor, ceiling, and all walls.

Trait Implementations

impl Clone for CharacterController

fn clone(&self) -> CharacterController

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CharacterController

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

Formats the value using the given formatter.