Jumping

Queues deterministic jumps with optional coyote time and input buffering.

jump() does not immediately modify position. It queues a request that the high-level fixed-step pre-pass dispatches before the native character update.

Basic jump#

if (keyboard_check_pressed(vk_space)) {
    player.jump();
}

jolt_update();

if (player.just_jumped()) {
    audio_play_sound(snd_jump, 0, false);
}

Jump velocity#

player.set_jump_speed(7);
var jump_speed = player.get_jump_speed();

A successful jump adds jump_speed along the controller's current up vector. The value must be finite and non-negative.

Coyote time and jump buffer#

player.set_coyote_time(0.10);
player.set_jump_buffer(0.12);

var coyote_left = player.get_coyote_remaining();
var buffer_left = player.get_jump_buffer_remaining();

• Coyote time allows a forced jump shortly after leaving supported ground.
• Jump buffering retains a request made shortly before landing.
• Both timers are measured and consumed by fixed physics steps.
• A value of 0 disables the corresponding allowance.

Related transitions#

player.just_landed()
player.just_left_ground()
player.is_grounded()
player.is_in_air()

These transient flags make animation and sound changes independent of how many fixed steps were required for the current render frame.

Configuration versus countdown#

show_debug_message(player.get_coyote_time());
show_debug_message(player.get_coyote_remaining());

Verified operation contracts#

These contracts distinguish units, return values, errors and lifetime according to the current implementation. Check results: false, 0 and undefined can mean different things for different methods.