Godot 输入 input

4.5.1 2025-10-15

右上方，鼠标右键菜单点击 Icon，选择绑定脚本(Attach Script)。

脚本自动继承 Sprite2D 父类，增加 _input() 方法，通过 Input.is_action_just_pressed() 判断上下左右方向键，直接修改global_position的位置，x控制左右，y控制上下。

extends Sprite2D

func _input(_event: InputEvent) -> void:
    if Input.is_action_just_pressed("ui_left"):
        global_position.x -= 10
    elif Input.is_action_just_pressed("ui_right"):
        global_position.x += 10
    elif Input.is_action_just_pressed("ui_up"):
        global_position.y -= 10
    elif Input.is_action_just_pressed("ui_down"):
        global_position.y += 10

          

         y(-)
         ^
         |
         |
x(-) ----+----> x(+)
         |
         |
         y(+)
          

绑定事件

ui_left, ui_right, ui_up, ui_down 是默认绑定的事件名称。

Project / Project Settings / Input Map 可以自定义输入映射。

ui_select : Space, Sony Triangle, XBox Y, Nintendo X

#	Action (输入)	Sony	Xbox	Nintendo
1	Bottom (下)	Cross (叉叉)	A	B
2	Right (右)	Circle (圆圈)	B	A
3	Left (左)	Square (方块)	X	Y
4	Top (上)	Triangle (三角)	Y	X
5	Back (后退)	Select	Back	-
6	Guide (引导)	PS	Home
7	Start (开始)		Menu	+