游戏引擎 / 系统课时
做一个可重复使用的开门机关
做一个可重复使用的开门机关
本课制作一个能放进不同关卡重复使用的 3D 门:角色走近时获得交互资格,按下 E 键后门板绕铰链旋转,再按一次即可关门。感应范围、输入判断和动画分别承担自己的职责,避免把门的运动写死在角色控制器中。
学习目标
- 用 Area3D 判断角色是否处于可交互范围。
- 用 AnimationPlayer 驱动门板及其碰撞体开合。
- 封装独立门场景,并验证重复实例不会互相干扰。
把转轴、门板和感应区分开
创建根节点 Door(Node3D),并按职责添加以下直属子节点:
Hinge(Node3D):位于门板铰链边缘,而不是门板中心;其子节点Panel(AnimatableBody3D)承载MeshInstance3D和CollisionShape3D。Trigger(Area3D):拥有自己的CollisionShape3D,使用比门板稍大的盒形范围,负责侦测靠近角色,不负责实体阻挡。AnimationPlayer:专门控制Hinge的旋转;不直接移动角色,也不向门板施加物理冲量。
门框需要阻挡时,可另加固定的 StaticBody3D 及碰撞形状。门板选择 AnimatableBody3D,因为它适用于动画驱动的移动碰撞体;保持 Sync to Physics 开启,并让动画按物理帧更新,避免可见门板和碰撞体脱节。
把 Player(CharacterBody3D) 加入名称为 player 的组,在 Project Settings → Input Map 中新增动作 interact,绑定 E 键。Trigger 的 Monitoring 必须启用,其 Collision Mask 需要包含角色所在的碰撞层。

为门板制作开合动画
选中 AnimationPlayer,新建两个不循环的动画 open 与 close,各长 0.6 秒。给 Hinge 的 rotation_degrees 属性添加属性轨道:open 在起点记录 (0, 0, 0),在终点记录 (0, 90, 0);close 则反向记录。保持动画不自动播放,并确认场景初始状态为关门。
关键是铰链的空间位置:例如门板宽 1 个单位,Panel 的局部中心可以在铰链侧向偏移 0.5 个单位。旋转的是 Hinge,所以可见门板和它的碰撞盒会共同绕边缘摆动。如果门从错误的一侧打开,调整终点角度的正负号,不要再用角色位置硬算门板旋转。
用信号和输入控制门的状态
把下面的完整脚本挂在 Door 根节点,节点名称必须与上文一致。脚本用 body_entered 和 body_exited 维护交互资格,再通过 _unhandled_input() 处理按键;动画进行中忽略重复触发,避免门在半途被新命令打断。
extends Node3D
@export var interaction_action: StringName = &"interact"
@onready var trigger: Area3D = $Trigger
@onready var animation_player: AnimationPlayer = $AnimationPlayer
var player_in_range := false
var is_open := false
func _ready() -> void:
# 门实例自行管理自己的检测信号。
trigger.body_entered.connect(_on_body_entered)
trigger.body_exited.connect(_on_body_exited)
func _unhandled_input(event: InputEvent) -> void:
if not player_in_range or animation_player.is_playing():
return
if not event.is_action_pressed(interaction_action):
return
# 同一套脚本使用两段动画完成开关切换。
is_open = not is_open
animation_player.play("open" if is_open else "close")
get_viewport().set_input_as_handled()
func _on_body_entered(body: Node3D) -> void:
if body.is_in_group("player"):
player_in_range = true
func _on_body_exited(body: Node3D) -> void:
if body.is_in_group("player"):
player_in_range = false预期结果:角色未进入范围时按 E 没有反应;进入感应区后按一次 E,门板约用 0.6 秒从 0° 转到 90°;播放过程中连续按键不会重复触发;完成后再按 E,门板回到关闭位置。角色离开范围不自动关门,这是本例的明确规则。
封装场景并逐项验收
将根节点保存为 res://interactables/door.tscn,在关卡中放入两个实例,分别调整整个 Door 的世界位置和朝向。不要只移动 Panel,否则它与 Trigger 的相对位置可能发生偏差。每个实例各有自己的范围标记和开合状态,正常情况下只会响应靠近它的角色。
测试时重点观察三个问题:门板绕侧边铰链而非中心转动;关闭时碰撞体挡住角色,打开后通路可穿过;远离门时按 E 无效。如果感应事件不发生,检查 Monitoring、角色的 player 组和碰撞掩码;如果模型旋转而碰撞盒不动,确认碰撞体确实在 Hinge 下,且动画与物理帧同步。