游戏引擎 / 系统课时

用任务状态累计关卡目标

用任务状态累计关卡目标

本课实现一条可以现场验收的关卡任务:击败 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”,任务不需要依赖敌人生命组件或背包实现细节。

csharp
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 取消注册,避免场景退出后旧监听器继续工作。

csharp
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 消息正文):

text
守卫击败:1/2
钥匙收集:1/1
守卫击败:2/2
关卡任务完成

重复发送的 guard-001 和 key-001 不会产生新的进度日志;即使测试菜单再运行一次,Completed 状态也会阻止二次完成。KillProgress、ItemProgress 和 IsCompleted 可供任务 HUD 读取,onCompleted 则负责通知通关后的动作。

在 Unity 场景中验收

以下操作适用于 Unity 6,使用内置的 Inspector、Console 和 ContextMenu,不需要额外插件。

  1. 把两个脚本放入 Assets/Scripts/Quest/,等待 Unity 编译完成。确保文件分别命名为 QuestSignals.cs 和 LevelQuestTracker.cs。
  2. 在 Hierarchy 使用 GameObject > Create Empty 建立 QuestManager,通过 Add Component 添加 Level Quest Tracker。
  3. 在 Inspector 设置 Enemy Type Id = guard、Required Kills = 2、Item Id = gate_key、Required Items = 1,并保持 State = Active。
  4. 点击 Play,打开 Window > General > Console。在 Level Quest Tracker 组件标题栏的菜单中选“测试重复事件”,核对上面的四行输出。
  5. 再执行一次测试菜单:Console 不应新增任务进度或完成消息。关闭 Play 后进度会恢复为场景原有状态,这是本例仅使用内存记录的正常行为。

要把任务完成接到关卡出口,在组件的 On Completed 事件列表里添加已有出口门对象,并选择项目中该组件的公开无参数解锁方法。若未绑定监听方法,本例只会输出“关卡任务完成”,不会自动打开门。

接入真实战斗与拾取时的边界

死亡事件只能在生命组件首次确认死亡后发出;不要每帧发现 HP 为 0 就重新发布。拾取事件要放在背包添加成功之后,不能仅凭碰撞进入触发器就累计,否则背包已满时也可能获得任务进度。即使上游发生重复投递,任务端的实例去重仍提供第二层保护。

为每个敌人和场景拾取物配置关卡内唯一的实例标识,例如 guard-001、guard-002、key-001。不要使用共享预制体名称充当实例 ID;如果需要跨存档恢复进度,应同时保存任务状态、已处理实例 ID 集合和目标配置版本,不能只保存两个数字。这样重新加载时才不会将已完成的击杀或拾取再次计入。

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

目录与阅读设置

阅读设置

17

记录一个想法

用任务状态累计关卡目标

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

登录哪都通