游戏引擎 / 系统课时
用任务状态累计关卡目标
用任务状态累计关卡目标
本课实现一条可以现场验收的关卡任务:击败 2 名守卫并拾取 1 把门禁钥匙。敌人死亡和拾取成功时分别发布事件,由任务组件筛选、去重并累计进度;两项目标都达成后,任务只触发一次完成通知,供出口和任务界面使用。
学习目标
- 定义多目标任务的进度、完成条件与状态。
- 监听敌人死亡和物品拾取事件,按场景实例 ID 去重。
- 在 Unity 6 中模拟重复事件,验证完成通知只触发一次。
确定目标与状态
本例任务初始状态为 Active,两个目标均满足后变为 Completed。完成条件采用“并且”,而不是任一目标达标就通关。
| 目标 | 事件匹配字段 | 目标数量 | 去重依据 |
|---|---|---|---|
| 击败守卫 | enemyTypeId = guard |
2 | enemyInstanceId |
| 收集门禁钥匙 | itemId = gate_key |
1 | pickupInstanceId |
类型 ID 用来判断事件是否属于任务;实例 ID 用来判断是否已经记过这一次击杀或拾取。例如 guard-001 的死亡事件发送三次,只能计作 1 名守卫。任务组件分别保存两个 HashSet<string>,不把不同来源的 ID 混在一起。

定义事件与唯一标识
在 Assets/Scripts/Quest/ 新建 QuestSignals.cs。两个事件都传入“类型或定义 ID”和“场景实例 ID”,任务不需要依赖敌人生命组件或背包实现细节。
using System;
public static class QuestSignals
{
// 前一个参数用于目标匹配,后一个用于实例去重。
public static event Action<string, string> EnemyDied;
public static event Action<string, string> ItemCollected;
public static void RaiseEnemyDied(string enemyTypeId, string enemyInstanceId)
{
EnemyDied?.Invoke(enemyTypeId, enemyInstanceId);
}
public static void RaiseItemCollected(string itemId, string pickupInstanceId)
{
ItemCollected?.Invoke(itemId, pickupInstanceId);
}
}这是事件接口定义,不会单独打印日志。实际接入时,敌人生命值首次从正数降至 0 并切换死亡状态后,调用 QuestSignals.RaiseEnemyDied("guard", "guard-001");场景拾取物确认入包成功后,再调用 QuestSignals.RaiseItemCollected("gate_key", "key-001")。后一个 ID 必须属于拾取物实例,不能所有钥匙都传相同的 gate_key。
记录进度并触发完成
新建 LevelQuestTracker.cs。HashSet.Add 仅在首次收到某实例 ID 时返回 true;达到目标数量后停止累计。OnEnable 注册事件,OnDisable 取消注册,避免场景退出后旧监听器继续工作。
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Events;
public sealed class LevelQuestTracker : MonoBehaviour
{
private enum QuestState { Active, Completed }
[Header("击败目标")]
[SerializeField] private string enemyTypeId = "guard";
[Min(1)] [SerializeField] private int requiredKills = 2;
[Header("收集目标")]
[SerializeField] private string itemId = "gate_key";
[Min(1)] [SerializeField] private int requiredItems = 1;
[SerializeField] private QuestState state = QuestState.Active;
[SerializeField] private UnityEvent onCompleted = new UnityEvent();
private readonly HashSet<string> killedIds = new HashSet<string>();
private readonly HashSet<string> pickedIds = new HashSet<string>();
public int KillProgress => killedIds.Count;
public int ItemProgress => pickedIds.Count;
public bool IsCompleted => state == QuestState.Completed;
private void Awake()
{
requiredKills = Mathf.Max(1, requiredKills);
requiredItems = Mathf.Max(1, requiredItems);
}
private void OnEnable()
{
if (!Application.isPlaying) return;
QuestSignals.EnemyDied += OnEnemyDied;
QuestSignals.ItemCollected += OnItemCollected;
}
private void OnDisable()
{
QuestSignals.EnemyDied -= OnEnemyDied;
QuestSignals.ItemCollected -= OnItemCollected;
}
private void OnEnemyDied(string typeId, string instanceId)
{
if (state != QuestState.Active || typeId != enemyTypeId ||
string.IsNullOrEmpty(instanceId) || killedIds.Count >= requiredKills ||
!killedIds.Add(instanceId)) return;
Debug.Log($"守卫击败:{KillProgress}/{requiredKills}");
CheckCompletion();
}
private void OnItemCollected(string definitionId, string instanceId)
{
if (state != QuestState.Active || definitionId != itemId ||
string.IsNullOrEmpty(instanceId) || pickedIds.Count >= requiredItems ||
!pickedIds.Add(instanceId)) return;
Debug.Log($"钥匙收集:{ItemProgress}/{requiredItems}");
CheckCompletion();
}
private void CheckCompletion()
{
// 状态先切换,再通知外部,防止回调中再次完成。
if (state != QuestState.Active ||
KillProgress < requiredKills || ItemProgress < requiredItems) return;
state = QuestState.Completed;
Debug.Log("关卡任务完成");
onCompleted.Invoke();
}
[ContextMenu("测试重复事件")]
private void SimulateEvents()
{
if (!Application.isPlaying) return;
// 同一敌人和同一拾取物各重复投递一次。
QuestSignals.RaiseEnemyDied("guard", "guard-001");
QuestSignals.RaiseEnemyDied("guard", "guard-001");
QuestSignals.RaiseItemCollected("gate_key", "key-001");
QuestSignals.RaiseItemCollected("gate_key", "key-001");
QuestSignals.RaiseEnemyDied("guard", "guard-002");
}
}预期输出(按下一节步骤在运行模式执行一次测试菜单,观察 Console 消息正文):
守卫击败:1/2
钥匙收集:1/1
守卫击败:2/2
关卡任务完成重复发送的 guard-001 和 key-001 不会产生新的进度日志;即使测试菜单再运行一次,Completed 状态也会阻止二次完成。KillProgress、ItemProgress 和 IsCompleted 可供任务 HUD 读取,onCompleted 则负责通知通关后的动作。
在 Unity 场景中验收
以下操作适用于 Unity 6,使用内置的 Inspector、Console 和 ContextMenu,不需要额外插件。
- 把两个脚本放入
Assets/Scripts/Quest/,等待 Unity 编译完成。确保文件分别命名为QuestSignals.cs和LevelQuestTracker.cs。 - 在 Hierarchy 使用
GameObject > Create Empty建立QuestManager,通过Add Component添加Level Quest Tracker。 - 在 Inspector 设置
Enemy Type Id = guard、Required Kills = 2、Item Id = gate_key、Required Items = 1,并保持State = Active。 - 点击 Play,打开
Window > General > Console。在Level Quest Tracker组件标题栏的菜单中选“测试重复事件”,核对上面的四行输出。 - 再执行一次测试菜单:Console 不应新增任务进度或完成消息。关闭 Play 后进度会恢复为场景原有状态,这是本例仅使用内存记录的正常行为。
要把任务完成接到关卡出口,在组件的 On Completed 事件列表里添加已有出口门对象,并选择项目中该组件的公开无参数解锁方法。若未绑定监听方法,本例只会输出“关卡任务完成”,不会自动打开门。
接入真实战斗与拾取时的边界
死亡事件只能在生命组件首次确认死亡后发出;不要每帧发现 HP 为 0 就重新发布。拾取事件要放在背包添加成功之后,不能仅凭碰撞进入触发器就累计,否则背包已满时也可能获得任务进度。即使上游发生重复投递,任务端的实例去重仍提供第二层保护。
为每个敌人和场景拾取物配置关卡内唯一的实例标识,例如 guard-001、guard-002、key-001。不要使用共享预制体名称充当实例 ID;如果需要跨存档恢复进度,应同时保存任务状态、已处理实例 ID 集合和目标配置版本,不能只保存两个数字。这样重新加载时才不会将已完成的击杀或拾取再次计入。