---

name: input-system description: Handle player input in Godot across keyboard, mouse, gamepad, and touch devices. Use this skill when configuring input actions, processing keyboard/mouse/gamepad events, implementing touch controls, setting up virtual joysticks, managing mouse modes, or building remappable input systems. metadata: author: godot-dev version: "1.0"

Input System

Input Actions

Setup in Project Settings

Project Settings → Input Map
- Add action: "jump"
- Add key: Space
- Add gamepad button: A

Using Input Actions

extends Node

func _input(event):
    if event.is_action_pressed("jump"):
        jump()
    if event.is_action_released("jump"):
        stop_jump()

func _process(delta):
    if Input.is_action_pressed("move_right"):
        move_right()
    if Input.is_action_just_pressed("attack"):
        attack()
    if Input.is_action_just_released("attack"):
        end_attack()

    var move_x = Input.get_axis("move_left", "move_right")
    var move_y = Input.get_axis("move_up", "move_down")
    var direction = Input.get_vector("move_left", "move_right", "move_up", "move_down")

Keyboard Input

extends Node

func _input(event):
    if event is InputEventKey:
        if event.pressed:
            match event.keycode:
                KEY_SPACE:
                    jump()
                KEY_ESCAPE:
                    pause()
                KEY_F1:
                    toggle_debug()

        if event.ctrl_pressed and event.keycode == KEY_S:
            save_game()

Mouse Input

extends Node

func _input(event):
    if event is InputEventMouseButton:
        if event.button_index == MOUSE_BUTTON_LEFT and event.pressed:
            shoot()
        if event.button_index == MOUSE_BUTTON_RIGHT:
            if event.pressed:
                start_aim()
            else:
                end_aim()
        if event.button_index == MOUSE_BUTTON_WHEEL_UP:
            zoom_in()
        if event.button_index == MOUSE_BUTTON_WHEEL_DOWN:
            zoom_out()

    if event is InputEventMouseMotion:
        var delta = event.relative
        rotate_camera(delta)
        var pos = event.position
        update_cursor(pos)

Gamepad Input

extends Node

func _input(event):
    if event is InputEventJoypadButton:
        if event.pressed:
            match event.button_index:
                JOY_BUTTON_A:
                    jump()
                JOY_BUTTON_B:
                    cancel()
                JOY_BUTTON_START:
                    pause()

    if event is InputEventJoypadMotion:
        if event.axis == JOY_AXIS_LEFT_X:
            move_horizontal(event.axis_value)
        if event.axis == JOY_AXIS_LEFT_Y:
            move_vertical(event.axis_value)
        if event.axis == JOY_AXIS_TRIGGER_RIGHT:
            if event.axis_value > 0.5:
                shoot()

func get_stick_vector() -> Vector2:
    return Vector2(
        Input.get_joy_axis(0, JOY_AXIS_LEFT_X),
        Input.get_joy_axis(0, JOY_AXIS_LEFT_Y)
    )

Touch Input

extends Node

func _input(event):
    if event is InputEventScreenTouch:
        if event.pressed:
            on_touch_down(event.position, event.index)
        else:
            on_touch_up(event.position, event.index)

    if event is InputEventScreenDrag:
        on_touch_move(event.position, event.index)

func on_touch_down(pos: Vector2, index: int):
    print("Touch down at: ", pos, " index: ", index)

func on_touch_up(pos: Vector2, index: int):
    print("Touch up at: ", pos, " index: ", index)

func on_touch_move(pos: Vector2, index: int):
    print("Touch move at: ", pos, " index: ", index)

Virtual Joystick (Touch)

extends TouchScreenButton

signal joystick_input(direction: Vector2)

var touch_index = -1
var deadzone = 0.15

func _input(event):
    if event is InputEventScreenTouch:
        if event.pressed and is_point_inside(event.position):
            touch_index = event.index
        elif not event.pressed and event.index == touch_index:
            touch_index = -1
            joystick_input.emit(Vector2.ZERO)

    if event is InputEventScreenDrag and event.index == touch_index:
        var center = global_position + texture_normal.get_size() / 2
        var direction = (event.position - center).normalized()
        var distance = event.position.distance_to(center)
        if distance > deadzone * texture_normal.get_size().x:
            joystick_input.emit(direction)
        else:
            joystick_input.emit(Vector2.ZERO)

func is_point_inside(point: Vector2) -> bool:
    var rect = Rect2(global_position, texture_normal.get_size())
    return rect.has_point(point)

Input Mapping Standards

FPS Controls

move_forward: W, Up, Left Stick Up
move_back: S, Down, Left Stick Down
move_left: A, Left, Left Stick Left
move_right: D, Right, Left Stick Right
jump: Space, A Button
crouch: Left Ctrl, B Button
sprint: Left Shift, Left Stick Press
interact: E, X Button
attack: Left Mouse, Right Trigger

Platformer Controls

move_left: A, Left, Left Stick Left
move_right: D, Right, Left Stick Right
jump: Space, A Button
attack: Z, X Button
dash: Shift, B Button

Mouse Modes

extends Node

func _ready():
    Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
    Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
    Input.set_mouse_mode(Input.MOUSE_MODE_HIDDEN)
    Input.set_mouse_mode(Input.MOUSE_MODE_CONFINED)

func _input(event):
    if event.is_action_pressed("ui_cancel"):
        Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)

Best Practices

1. Use Input Actions: Not raw keycodes
2. Support multiple devices: Keyboard + Gamepad
3. Deadzones: For analog sticks
4. Remappable inputs: Let players customize
5. Touch gestures: Implement for mobile
6. Input buffering: For responsive controls