character_controller_2d.gd

Go to the documentation of this file.

extends RefCounted
 
 
 
const DEFAULT_CONFIG := {
    "run_speed": 180.0,
    "acceleration": 1200.0,
    "deceleration": 1600.0,
    "gravity": 980.0,
    "max_fall_speed": 520.0,
    "jump_velocity": -340.0,
    "coyote_time": 0.09,
    "jump_buffer": 0.10,
    "dash_speed": 420.0,
    "dash_time": 0.12,
    "dash_cooldown": 0.35
}
 
 
 
func create_state() -> Dictionary:
    return {
        "velocity": Vector2.ZERO,
        "facing": 1,
        "coyote_left": 0.0,
        "jump_buffer_left": 0.0,
        "dash_left": 0.0,
        "dash_cooldown_left": 0.0,
        "state": "idle"
    }
 
 
 
func step(state:Dictionary, input:Dictionary, delta:float, on_floor:bool, config:Dictionary = {}) -> Dictionary:
    var settings = DEFAULT_CONFIG.duplicate(true)
    for key in config.keys():
        settings[key] = config[key]
    var next = state.duplicate(true)
    var velocity = next.get("velocity", Vector2.ZERO)
    var move = clamp(float(input.get("move", 0.0)), -1.0, 1.0)
    if abs(move) > 0.01:
        next["facing"] = sign(move)
        velocity.x = move_toward(velocity.x, move * float(settings["run_speed"]), float(settings["acceleration"]) * delta)
    else:
        velocity.x = move_toward(velocity.x, 0.0, float(settings["deceleration"]) * delta)
    next["coyote_left"] = float(settings["coyote_time"]) if on_floor else max(0.0, float(next.get("coyote_left", 0.0)) - delta)
    next["jump_buffer_left"] = float(settings["jump_buffer"]) if bool(input.get("jump_pressed", false)) else max(0.0, float(next.get("jump_buffer_left", 0.0)) - delta)
    next["dash_cooldown_left"] = max(0.0, float(next.get("dash_cooldown_left", 0.0)) - delta)
    if bool(input.get("dash_pressed", false)) and float(next.get("dash_cooldown_left", 0.0)) <= 0.0:
        next["dash_left"] = float(settings["dash_time"])
        next["dash_cooldown_left"] = float(settings["dash_cooldown"])
    if float(next.get("dash_left", 0.0)) > 0.0:
        next["dash_left"] = max(0.0, float(next["dash_left"]) - delta)
        velocity = Vector2(float(next.get("facing", 1)) * float(settings["dash_speed"]), 0)
        next["state"] = "dash"
    else:
        if float(next.get("jump_buffer_left", 0.0)) > 0.0 and float(next.get("coyote_left", 0.0)) > 0.0:
            velocity.y = float(settings["jump_velocity"])
            next["jump_buffer_left"] = 0.0
            next["coyote_left"] = 0.0
        else:
            velocity.y = min(float(settings["max_fall_speed"]), velocity.y + float(settings["gravity"]) * delta)
        next["state"] = _resolve_state(move, on_floor, velocity)
    next["velocity"] = velocity
    return next
 
 
func _resolve_state(move:float, on_floor:bool, velocity:Vector2) -> String:
    if not on_floor:
        return "jump" if velocity.y < 0.0 else "fall"
    if abs(move) > 0.01:
        return "run"
    return "idle"