游戏叙事与剧情 / 系统课时

一句对话怎样推进一个任务

一句对话怎样推进一个任务

“玩家说完这句话,任务就前进一步”看起来只是一次状态修改,但真正的工程问题是如何把剧情动作稳定映射为任务命令,并保证重复触发、条件不满足或顺序错误时不会把任务状态写坏。本节用一个可运行的 C# 示例完成这条链路。

学习目标

  • 把剧情节点中的任务动作映射为接取、推进、完成和失败四类明确命令。
  • 在任务系统内校验当前状态,避免剧情脚本直接篡改任务对象。
  • 用动作 ID 做幂等保护,使重复进入节点时不会重复推进同一任务。

让剧情发命令,而不是改任务字段

不要让剧情脚本写出 quest.Progress++ 或 quest.State = Completed。这种写法绕过了任务系统自己的条件校验,后续一旦加入前置任务、目标计数、失败状态或存档恢复,剧情侧就会不断复制业务规则。

更合适的边界是:剧情节点声明“要执行什么任务动作”,任务系统负责判断这个动作当前能不能生效。常用动作可以收敛成 Accept、Advance、Complete、Fail 四类,动作中至少携带任务 ID 和唯一动作 ID。

剧情动作到任务状态变化的数据流

定义动作并集中执行

下面的示例把一句对话节点携带的 QuestAction 交给 QuestService。服务内部维护状态规则,并用 ActionId 去重。这样即使节点因为读档、回退或脚本重入被执行两次,同一个动作也只生效一次。

csharp
using System;
using System.Collections.Generic;

public enum QuestState
{
    NotStarted,
    InProgress,
    Completed,
    Failed
}

public enum QuestActionType
{
    Accept,
    Advance,
    Complete,
    Fail
}

public sealed record QuestAction(
    string ActionId,
    string QuestId,
    QuestActionType Type,
    int Amount = 1);

public sealed class Quest
{
    public string Id { get; }
    public QuestState State { get; set; } = QuestState.NotStarted;
    public int Progress { get; set; }

    public Quest(string id) => Id = id;
}

public sealed class QuestService
{
    private readonly Dictionary<string, Quest> _quests = new();
    private readonly HashSet<string> _handledActionIds = new();

    public QuestService(IEnumerable<Quest> quests)
    {
        foreach (var quest in quests)
        {
            _quests[quest.Id] = quest;
        }
    }

    public bool Apply(QuestAction action)
    {
        if (_handledActionIds.Contains(action.ActionId))
        {
            return false;
        }

        if (!_quests.TryGetValue(action.QuestId, out var quest))
        {
            throw new InvalidOperationException($"Unknown quest: {action.QuestId}");
        }

        var applied = true;

        switch (action.Type)
        {
            case QuestActionType.Accept when quest.State == QuestState.NotStarted:
                quest.State = QuestState.InProgress;
                break;

            case QuestActionType.Advance when quest.State == QuestState.InProgress:
                quest.Progress += action.Amount;
                break;

            case QuestActionType.Complete when quest.State == QuestState.InProgress:
                quest.State = QuestState.Completed;
                break;

            case QuestActionType.Fail when quest.State == QuestState.InProgress:
                quest.State = QuestState.Failed;
                break;

            default:
                // 状态不允许时拒绝该动作,不让剧情脚本越权修改任务。
                applied = false;
                break;
        }

        if (applied)
        {
            _handledActionIds.Add(action.ActionId);
        }

        return applied;
    }

    public Quest Get(string questId) => _quests[questId];
}

public static class Program
{
    public static void Main()
    {
        var service = new QuestService(new[] { new Quest("quest-find-herbs") });

        var actions = new[]
        {
            new QuestAction("dlg-001-accept", "quest-find-herbs", QuestActionType.Accept),
            new QuestAction("dlg-002-progress", "quest-find-herbs", QuestActionType.Advance, 1),
            new QuestAction("dlg-002-progress", "quest-find-herbs", QuestActionType.Advance, 1),
            new QuestAction("dlg-003-complete", "quest-find-herbs", QuestActionType.Complete)
        };

        foreach (var action in actions)
        {
            Console.WriteLine($"{action.ActionId}: applied={service.Apply(action)}");
        }

        var quest = service.Get("quest-find-herbs");
        Console.WriteLine($"state={quest.State}, progress={quest.Progress}");
    }
}

预期输出:

text
dlg-001-accept: applied=True
dlg-002-progress: applied=True
dlg-002-progress: applied=False
dlg-003-complete: applied=True
state=Completed, progress=1

第三个动作与第二个动作使用同一个 ActionId,因此被识别为重复触发,没有让进度从 1 变成 2。这个保护在“节点进入事件可能重放”的剧情系统里很重要。

把节点配置成数据,而不是硬编码分支

实际项目通常不会在代码里写死“进入某节点就推进某任务”,而是在剧情数据中挂动作。例如一个节点可以描述:显示台词后,执行 Advance,目标任务为 quest-find-herbs,步进值为 1。

配置只是声明意图,真正执行仍要进入统一的 QuestService.Apply。这样策划可以调整映射关系,程序侧仍能保证状态机、幂等和错误处理不被绕过。

一个节点也可能挂多个动作,例如同时推进主线并设置世界标记。此时要明确执行顺序以及“前一个失败后是否继续”。如果这些动作必须同成同败,就不能只靠顺序循环,应提升为事务式剧情动作批次,并设计回滚或预校验。

区分重复触发与非法状态

幂等失败和状态失败不是一回事。重复的 ActionId 说明同一业务动作已经处理过,通常可以安静忽略;而在 NotStarted 状态直接收到 Complete,更像脚本配置错误,应记录任务 ID、动作类型和剧情节点,方便定位。

一句对话要可靠地推动任务,关键不是在节点里多写一个回调,而是把“剧情意图”和“任务状态规则”分开:剧情只声明动作,任务系统验证并落状态,再用稳定动作 ID 抵御重复执行。

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

目录与阅读设置

阅读设置

17

记录一个想法

一句对话怎样推进一个任务

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

登录哪都通