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

从一段支线搭出完整闭环

从一段支线搭出完整闭环

这一课把“分支、对话、事件、任务接口”真正串成一条可运行支线:玩家接触 NPC 后,根据任务状态进入不同对话分支,对话节点触发事件,事件再推进任务。重点不是堆功能,而是建立一条可验证、可回放、可定位问题的最小闭环。

学习目标

  • 把条件分支、对话节点、事件和任务状态串成稳定执行链。
  • 用最小接口隔离剧情系统与任务系统,避免两边直接互相改状态。
  • 通过日志与断言验证一段支线是否完整闭环。

先定义这段支线的完成条件

假设支线内容很简单:玩家第一次与“守门人”交谈会接到任务;取得钥匙后再次交谈,任务完成;任务完成后再交谈只播放收尾台词。

这段支线看似只有三段对白,但工程上至少涉及四类信息:任务状态决定分支、对话节点负责表现、事件负责产生副作用、任务接口负责真正修改任务状态。如果把这些职责都写进一个对话脚本,后续增加存档、跳过、回放或多人协作时会迅速失控。

支线从条件判断到任务推进的执行闭环

最小可验收规则可以写成三条:第一次交互后任务为 Accepted;持有钥匙时交互后任务为 Completed;完成后重复交互不再产生任务副作用。

用接口切开剧情与任务系统

下面示例使用 .NET 8 控制台程序模拟完整链路。剧情执行器只依赖 IQuestService,并通过剧情事件决定何时调用任务接口。这样以后把任务系统替换成真正的 ECS、组件系统或服务端状态模块时,对话分支逻辑不需要整体重写。

csharp
using System;
using System.Collections.Generic;

enum QuestState
{
    NotStarted,
    Accepted,
    Completed
}

interface IQuestService
{
    QuestState GetState(string questId);
    void Accept(string questId);
    void Complete(string questId);
}

sealed class QuestService : IQuestService
{
    private readonly Dictionary<string, QuestState> _states = new();

    public QuestState GetState(string questId) =>
        _states.TryGetValue(questId, out var state) ? state : QuestState.NotStarted;

    public void Accept(string questId)
    {
        if (GetState(questId) == QuestState.NotStarted)
            _states[questId] = QuestState.Accepted;
    }

    public void Complete(string questId)
    {
        if (GetState(questId) == QuestState.Accepted)
            _states[questId] = QuestState.Completed;
    }
}

sealed record NarrativeContext(bool HasKey);

sealed class SideQuestRunner
{
    private const string QuestId = "gate_key";
    private readonly IQuestService _quests;

    public SideQuestRunner(IQuestService quests)
    {
        _quests = quests;
    }

    public void TalkToGatekeeper(NarrativeContext context)
    {
        var state = _quests.GetState(QuestId);

        if (state == QuestState.NotStarted)
        {
            Say("守门人", "城门钥匙不见了,帮我找回来。");
            Emit("quest.accept");
            _quests.Accept(QuestId);
            return;
        }

        if (state == QuestState.Accepted && context.HasKey)
        {
            Say("玩家", "钥匙找到了。");
            Say("守门人", "太好了,城门终于能重新开启。");
            Emit("quest.complete");
            _quests.Complete(QuestId);
            return;
        }

        if (state == QuestState.Accepted)
        {
            Say("守门人", "钥匙应该还在旧仓库附近。");
            return;
        }

        Say("守门人", "多亏了你,城门已经恢复通行。");
    }

    private static void Say(string speaker, string text) =>
        Console.WriteLine($"[{speaker}] {text}");

    private static void Emit(string eventName) =>
        Console.WriteLine($"[Event] {eventName}");
}

class Program
{
    static void Main()
    {
        var quests = new QuestService();
        var runner = new SideQuestRunner(quests);

        const string questId = "gate_key";
        runner.TalkToGatekeeper(new NarrativeContext(HasKey: false));
        Console.WriteLine($"State={quests.GetState(questId)}");

        runner.TalkToGatekeeper(new NarrativeContext(HasKey: true));
        Console.WriteLine($"State={quests.GetState(questId)}");

        runner.TalkToGatekeeper(new NarrativeContext(HasKey: true));
    }
}

预期输出:

text
[守门人] 城门钥匙不见了,帮我找回来。
[Event] quest.accept
State=Accepted
[玩家] 钥匙找到了。
[守门人] 太好了,城门终于能重新开启。
[Event] quest.complete
State=Completed
[守门人] 多亏了你,城门已经恢复通行。

这个例子里最重要的不是 if 本身,而是副作用的位置。分支只负责选内容;Emit 表示剧情层产生语义事件;任务状态只由 IQuestService 修改。真正接入引擎后,可以把 Emit 换成事件总线,把 QuestService 换成正式任务模块。

让事件具备幂等边界

剧情很容易因为读档、断线重连、重复点击或“跳过到节点末尾”而再次执行同一个结束节点。如果“完成任务”“发奖励”“扣道具”没有幂等保护,重复进入一次节点就可能重复产生副作用。

最小策略是让状态写入接口自己拒绝非法重复迁移。示例中的 Accept 只允许 NotStarted -> Accepted,Complete 只允许 Accepted -> Completed。这样即使剧情层重复发出同一个事件,任务状态也不会继续变化。

如果任务系统还需要扣除钥匙,最好把“校验钥匙、消耗钥匙、完成任务”放在同一业务事务或同一权威状态提交中,而不是让三个独立剧情节点分别修改。

按链路验证,而不是只看对白能不能播

剧情验收至少要覆盖正常路径和重复路径。最简单的做法是把每次执行后的关键状态打印出来,再对照预期。自动化测试中可以进一步把 Console.WriteLine 替换成事件记录器,对事件顺序做断言。

建议按下面顺序检查:

  1. 新存档进入支线时,读取到 NotStarted,只能进入接取分支。
  2. 接取后再次交互但没有钥匙,只播放提示,不改变任务状态。
  3. 持有钥匙后交互,先播放交付对白,再产生完成事件,状态变成 Completed。
  4. 完成后重复交互,不再次触发接取、完成或奖励类事件。
  5. 从 Accepted 存档恢复时,系统直接进入进行中分支,不依赖“之前那段对白是否播放过”。

把闭环做成可交付资产

一段支线达到“可交付”,不只是设计表里有对白,而是内容、条件和副作用都能被工程系统识别。实际项目中可以把节点配置成数据,把执行器保持通用;但无论使用 JSON、ScriptableObject、DataTable 还是自研编辑器,都应保证每个节点至少能回答三个问题:进入条件是什么、显示什么内容、结束时产生什么事件。

当这三个问题都能从数据和日志中被直接追踪,并且任务状态有唯一写入入口时,这段支线才真正形成工程闭环:内容人员能配置,程序能接入,测试能复现,存档恢复后也能继续执行。

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

目录与阅读设置

阅读设置

17

记录一个想法

从一段支线搭出完整闭环

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

登录哪都通