游戏引擎 / 系统课时

制作靠近触发的交互区域

制作靠近触发的交互区域

靠近门口、拾取点或 NPC 时,游戏往往需要自动提示“可以交互”,离开后又立即取消提示。本课用 Godot 4 的 Area3D 监听玩家进入与离开,在区域内按 E 才执行一次交互,并通过输出验证完整过程。

学习目标

  • 区分不会阻挡角色的 Area3D 与实体碰撞体。
  • 配置触发区域的形状、碰撞掩码和信号。
  • 记录玩家是否在范围内,并限制交互输入的生效时机。

区域检测是重叠事件,不是实体阻挡

Area3D 使用子节点 CollisionShape3D 定义检测体积。当玩家的 CharacterBody3D 进入这片体积时,区域发出 body_entered;离开时发出 body_exited。区域本身不会像墙壁那样挡住玩家,且信号发生在进入或离开的边界时刻,并非每帧重复发送。

本课使用一个布尔值保存单人游戏中的“玩家在范围内”状态,让输入处理只在该状态为真时执行。如果需要同时判断角色是否正看着门,可以在此基础上再加入摄像机射线条件。

玩家进入和离开Area3D触发体积的状态变化

配置可以穿过的触发体积

在关卡中添加 DoorZone(Area3D),为其创建直属子节点 CollisionShape3D,将 Shape 设为 SphereShape3D,半径例如 2 米,并把区域放在门前。球形范围仅决定何时发出重叠信号,门是否阻挡玩家仍由门自己的 StaticBody3D 决定。

将 DoorZone 的 Monitoring 设为开启,Collision Mask 勾选第 1 层;玩家的 CharacterBody3D 需要启用第 1 碰撞层并拥有有效碰撞形状,同时将玩家的 CharacterBody3D 根节点加入 player 组。再在 Input Map 中设置 interact 动作并绑定 E 键。这里检测的是玩家物理体,所以使用 body_entered 而非 area_entered。

用信号维护区域内状态

把以下完整脚本挂到 DoorZone。在 _ready() 中通过代码连接两个信号,进入时保存状态并提示操作,离开时清除状态;不必在编辑器中重复连接相同信号。

gdscript
extends Area3D

var player_inside := false

func _ready() -> void:
    # 信号只响应进出边界,避免手动每帧扫描重叠体。
    body_entered.connect(_on_body_entered)
    body_exited.connect(_on_body_exited)

func _on_body_entered(body: Node3D) -> void:
    if not body.is_in_group("player"):
        return
    player_inside = true
    print("进入区域:可按 E 交互")

func _on_body_exited(body: Node3D) -> void:
    if not body.is_in_group("player"):
        return
    player_inside = false
    print("离开区域")

func _physics_process(_delta: float) -> void:
    # 仅允许区域内的一次按键触发一次行为。
    if player_inside and Input.is_action_just_pressed("interact"):
        print("区域交互触发")

预期输出(从区域外走进来,按一次 E,再走出区域):

text
进入区域:可按 E 交互
区域交互触发
离开区域

如果只进出、不按 E,则只有首尾两行;在区域外按 E 不应输出交互日志。真正制作 UI 时,可以把进出日志替换成显示和隐藏“按 E 交互”的提示,把交互日志替换成开门等业务操作。

无信号或错误触发时怎么查

先在运行时显示碰撞形状,确认球形区域确实覆盖玩家移动路线,并检查区域的 Monitoring、碰撞掩码与玩家碰撞层是否匹配。如果信号完全不来,还要确认玩家是 CharacterBody3D 等物理实体、有启用的碰撞形状,且 player 组加在实际进入区域的物理体上。

若角色站在墙另一侧却仍触发提示,通常不是信号故障:Area3D 只检测体积重叠,不验证视线是否被遮挡。要求“靠近且看得到”时,应将区域状态与射线首次命中共同作为交互条件。当前布尔写法针对单个受控玩家;多人场景应分别记录各玩家的进入与离开,避免一人离开就清除所有人的状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

制作靠近触发的交互区域

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通