Godot中TopDown 2D游戏虚拟摇杆触摸移动实现求助

一、节点基础配置检查 #

• 优先使用Control系节点搭建摇杆：用TextureRect做摇杆背景，再添加一个子TextureRect作为可拖动的摇杆核心。必须勾选两个节点的input_pickable选项，否则无法接收触摸事件。
• 锚点与初始位置设置：建议将背景锚点设为(0, 1)固定在屏幕左下角，摇杆子节点初始位置设为背景节点的中心（rect_size / 2），避免拖动时出现偏移。

二、触摸事件处理代码实现 #

直接在摇杆核心节点中编写触摸逻辑，无需依赖全局输入映射，避免冲突：

extends TextureRect

var start_touch_pos: Vector2  # 触摸起始全局坐标
var max_joystick_radius: float = 60.0  # 摇杆最大拖动半径
var dead_zone: float = 12.0  # 死区，过滤微小触摸抖动

func _gui_input(event: InputEvent) -> void:
    if event is InputEventScreenTouch:
        if event.pressed:
            start_touch_pos = get_global_mouse_position()
        else:
            # 触摸松开后重置摇杆位置与移动方向
            rect_position = get_parent().rect_size / 2 - rect_size / 2
            get_tree().get_nodes_in_group("player")[0].move_dir = Vector2.ZERO
    elif event is InputEventScreenDrag:
        var current_touch_pos = get_global_mouse_position()
        var offset = current_touch_pos - start_touch_pos
        
        # 限制摇杆拖动范围
        var clamped_offset = offset.clamped(max_joystick_radius)
        rect_position = (start_touch_pos - rect_size / 2) + clamped_offset
        
        # 计算移动方向，死区内输出零向量
        var move_dir = offset.normalized()
        if offset.length() < dead_zone:
            move_dir = Vector2.ZERO
        get_tree().get_nodes_in_group("player")[0].move_dir = move_dir

三、玩家移动逻辑适配 #

玩家节点（如KinematicBody2D）需监听摇杆传递的方向向量，确保移动逻辑仅依赖触摸输入：

extends KinematicBody2D

var move_dir: Vector2 = Vector2.ZERO
var move_speed: float = 220.0

func _physics_process(delta: float) -> void:
    var velocity = move_dir * move_speed
    velocity = move_and_slide(velocity)

四、常见问题排查 #

• 触摸事件被抢占：将摇杆节点的mouse_filter设为STOP，阻止触摸事件向下传递到下层节点。
• 坐标混淆错误：处理触摸位置时，严格区分get_global_mouse_position()（全局坐标）与rect_position（局部坐标），避免计算偏移时出错。
• 死区设置不当：死区半径建议设为摇杆最大半径的1/5~1/6，过小会导致移动抖动，过大则无法触发轻微触摸。

五、调试技巧 #

• 使用Godot远程调试功能，在手机运行时实时查看move_dir的数值变化，确认触摸操作是否正确输出方向向量。
• 先剥离所有额外逻辑，仅保留摇杆拖动与方向输出功能，测试正常后再逐步添加动画、碰撞等其他模块。

内容的提问来源于stack exchange，提问作者D4r1O