游戏引擎 / 系统课时
用场景触发器控制通关门
用场景触发器控制通关门
玩家抵达出口时,游戏必须先检查任务目标,不能只凭一次碰撞就通关。本课用两个目标区域、一扇实体门和一个出口触发区,完成锁门、解锁、显示通关面板以及重复进入保护,并给出能在 Unity 6 场景中直接验证的实现。
学习目标
- 配置不会阻挡角色移动的出口触发器,并让实体门独立承担碰撞阻挡。
- 用唯一目标 ID 登记任务进度,完成全部目标后解锁通关门。
- 验证提前抵达、完成任务后返回、重复进入及停留期间解锁四种情况。
确定门与任务的判定关系
示例关卡要求取得钥匙 key 并激活机关 switch。只有两个不同的目标都被登记,门才解除阻挡;玩家进入门前的 ExitZone 时,系统再次检查完成状态,未满足条件只提示锁定,满足条件才触发一次通关。
任务完成事件还负责刷新门状态。如果玩家恰好停在出口触发区内时完成最后一个目标,不必强迫其退出再进入;收到完成事件后可直接结算。目标登记和通关结算分别去重,避免一次碰撞产生多次奖励。

在场景中布置碰撞与 UI
以下按 Unity 6(6000.x)使用内置 3D 物理触发器。先在 Hierarchy 建立一个空物体 Mission,再创建 KeyZone、SwitchZone、DoorPanel、ExitZone;在 Canvas 中创建通关面板 WinPanel 并先取消激活。
DoorPanel放在门洞处,保留可见模型和普通Box Collider,不要勾选Is Trigger。它只负责阻挡和外观,后续会被独立禁用。ExitZone放在门的可到达一侧,添加Box Collider,勾选Is Trigger;可将Center设为(0, 1, 0)、Size设为(2.4, 2, 1.2),再按门宽微调。KeyZone、SwitchZone各添加Box Collider并勾选Is Trigger;示例触发盒尺寸均为(1.5, 1.8, 1.5),分别放在钥匙和机关附近。- 给上述三个触发区各添加
Rigidbody,设置Is Kinematic = true、Use Gravity = false,使触发事件有明确的物理参与方。玩家根物体使用CharacterController,Tag 设为Player。 - 确认
ExitZone不是DoorPanel的子物体;否则门关闭或隐藏时,出口检测可能一起失效。
用目标 ID 记录一次性完成进度
新建 MissionProgress.cs 并挂到 Mission。requiredIds 是本关的任务白名单;HashSet 按 ID 去重,避免同一机关连续触发两次就误判为两个目标。Changed 仅在首次完成合法目标时发送。
using System;
using System.Collections.Generic;
using UnityEngine;
public sealed class MissionProgress : MonoBehaviour
{
[SerializeField] private string[] requiredIds = { "key", "switch" };
private HashSet<string> required;
private readonly HashSet<string> done = new HashSet<string>();
public event Action Changed;
public bool AllDone => required != null && required.Count > 0
&& done.Count == required.Count;
private void Awake()
{
required = new HashSet<string>(requiredIds, StringComparer.Ordinal);
required.RemoveWhere(string.IsNullOrWhiteSpace);
}
public bool Complete(string id)
{
// 只接受任务清单内尚未完成的目标。
if (string.IsNullOrWhiteSpace(id) || !required.Contains(id) ||
!done.Add(id)) return false;
Debug.Log($"GOAL_DONE {id} ({done.Count}/{required.Count})");
Changed?.Invoke();
return true;
}
}预期结果:场景启动时无任务完成日志;首次调用 Complete("key") 会登记 1/2 并发出 Changed,再次传入相同 ID 则返回 false。下一脚本负责从场景触发器发起这次调用。
再新建 GoalZone.cs,分别挂到 KeyZone、SwitchZone。它们只传递任务 ID;项目已有拾取或机关交互系统时,也可以在交互成功后直接调用 MissionProgress.Complete(id),无需复制这两个触发区。
using UnityEngine;
[RequireComponent(typeof(BoxCollider))]
public sealed class GoalZone : MonoBehaviour
{
[SerializeField] private MissionProgress progress;
[SerializeField] private string goalId = "key";
private void OnTriggerEnter(Collider other)
{
if (!other.CompareTag("Player")) return;
// 首次登记后停用本区域,阻止重复拾取。
if (progress.Complete(goalId))
gameObject.SetActive(false);
}
}预期结果:KeyZone 的 Goal Id 为 key、SwitchZone 的为 switch,分别进入后各出现一次 GOAL_DONE 日志;只有两项均完成,AllDone 才返回 true。这些脚本是同一场景示例的前两部分,需连同下一节的出口脚本一起挂载并绑定引用。
监听解锁事件并只结算一次
新建 ExitGate.cs,挂在 ExitZone。门板单独控制启用状态;出口区域始终处于激活状态。进入出口区时检查任务,如果最后一个目标在区域内完成,则由进度事件再次尝试结算。
using UnityEngine;
[RequireComponent(typeof(BoxCollider))]
public sealed class ExitGate : MonoBehaviour
{
[SerializeField] private MissionProgress progress;
[SerializeField] private GameObject doorPanel;
[SerializeField] private GameObject winPanel;
private bool playerInside;
private bool finished;
private void OnEnable()
{
if (progress != null) progress.Changed += RefreshGate;
}
private void OnDisable()
{
// 避免对象停用后留下失效事件订阅。
if (progress != null) progress.Changed -= RefreshGate;
}
private void Start()
{
winPanel.SetActive(false);
RefreshGate();
}
private void RefreshGate()
{
bool unlocked = progress.AllDone;
doorPanel.SetActive(!unlocked);
if (unlocked && playerInside) Finish();
}
private void OnTriggerEnter(Collider other)
{
if (!other.CompareTag("Player")) return;
playerInside = true;
if (!progress.AllDone)
{
Debug.Log("EXIT_LOCKED");
return;
}
Finish();
}
private void OnTriggerExit(Collider other)
{
if (other.CompareTag("Player")) playerInside = false;
}
private void Finish()
{
if (finished) return; // 防止重复发奖、重复显示或多次切关。
finished = true;
winPanel.SetActive(true);
Debug.Log("LEVEL_COMPLETE");
}
}预期结果:目标未完成时 DoorPanel 保持可见且阻挡;完成两项目标后门板被禁用;玩家进入 ExitZone 时 WinPanel 显示,Console 只出现一次 LEVEL_COMPLETE。这是最小可运行通关表现,后续可把隐藏门板替换为开门 Animator,并在动画合适的时刻关闭阻挡碰撞体。
绑定引用并逐项验收
在 Inspector 中把两个 GoalZone.Progress 和 ExitGate.Progress 都指向 Mission 上的 MissionProgress;ExitGate.Door Panel 指向 DoorPanel,Win Panel 指向 Canvas 下的 WinPanel。目标 ID 必须与 MissionProgress.Required Ids 完全一致且不能重复,大小写也须一致。
按 Play 后进行以下验收,建议每条从全新进入 Play 模式开始检查:
| 测试操作 | 预期结果 |
|---|---|
| 未收集任何目标,先走到出口区 | Console 显示 EXIT_LOCKED;门阻挡,面板不显示 |
只进入 KeyZone |
输出 GOAL_DONE key (1/2);门仍锁定 |
再进入 SwitchZone |
输出 GOAL_DONE switch (2/2);门板消失 |
| 返回出口,反复进出触发区 | 首次显示 LEVEL_COMPLETE,之后不重复结算 |
| 角色停留在出口区时,由其他交互完成最后目标 | 门解锁,立刻结算,不依赖下一次 OnTriggerEnter |
上述测试顺序对应的关键日志如下;Console 的实际时间戳和其他系统日志可能不同。
EXIT_LOCKED
GOAL_DONE key (1/2)
GOAL_DONE switch (2/2)
LEVEL_COMPLETE若完全没有触发日志,先检查 Tag 是否在 CharacterController 所在的玩家根物体上,再核对 Is Trigger、运动学 Rigidbody、Layer Collision Matrix 和触发区位置。若门消失后检测也失效,通常是把 ExitZone 错误地放在被禁用的门板下面;若进度不增加,优先核对目标 ID 和 Inspector 的 Progress 引用。
本实现的进度和通关状态只在当前关卡运行期间保存;重新加载场景后会重新开始。正式项目如需保存通关记录,应在 Finish() 首次执行时交给关卡会话或存档服务处理。