游戏叙事与剧情 / 系统课时
从一段支线搭出完整闭环
从一段支线搭出完整闭环
这一课把“分支、对话、事件、任务接口”真正串成一条可运行支线:玩家接触 NPC 后,根据任务状态进入不同对话分支,对话节点触发事件,事件再推进任务。重点不是堆功能,而是建立一条可验证、可回放、可定位问题的最小闭环。
学习目标
- 把条件分支、对话节点、事件和任务状态串成稳定执行链。
- 用最小接口隔离剧情系统与任务系统,避免两边直接互相改状态。
- 通过日志与断言验证一段支线是否完整闭环。
先定义这段支线的完成条件
假设支线内容很简单:玩家第一次与“守门人”交谈会接到任务;取得钥匙后再次交谈,任务完成;任务完成后再交谈只播放收尾台词。
这段支线看似只有三段对白,但工程上至少涉及四类信息:任务状态决定分支、对话节点负责表现、事件负责产生副作用、任务接口负责真正修改任务状态。如果把这些职责都写进一个对话脚本,后续增加存档、跳过、回放或多人协作时会迅速失控。

最小可验收规则可以写成三条:第一次交互后任务为 Accepted;持有钥匙时交互后任务为 Completed;完成后重复交互不再产生任务副作用。
用接口切开剧情与任务系统
下面示例使用 .NET 8 控制台程序模拟完整链路。剧情执行器只依赖 IQuestService,并通过剧情事件决定何时调用任务接口。这样以后把任务系统替换成真正的 ECS、组件系统或服务端状态模块时,对话分支逻辑不需要整体重写。
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));
}
}预期输出:
[守门人] 城门钥匙不见了,帮我找回来。
[Event] quest.accept
State=Accepted
[玩家] 钥匙找到了。
[守门人] 太好了,城门终于能重新开启。
[Event] quest.complete
State=Completed
[守门人] 多亏了你,城门已经恢复通行。这个例子里最重要的不是 if 本身,而是副作用的位置。分支只负责选内容;Emit 表示剧情层产生语义事件;任务状态只由 IQuestService 修改。真正接入引擎后,可以把 Emit 换成事件总线,把 QuestService 换成正式任务模块。
让事件具备幂等边界
剧情很容易因为读档、断线重连、重复点击或“跳过到节点末尾”而再次执行同一个结束节点。如果“完成任务”“发奖励”“扣道具”没有幂等保护,重复进入一次节点就可能重复产生副作用。
最小策略是让状态写入接口自己拒绝非法重复迁移。示例中的 Accept 只允许 NotStarted -> Accepted,Complete 只允许 Accepted -> Completed。这样即使剧情层重复发出同一个事件,任务状态也不会继续变化。
如果任务系统还需要扣除钥匙,最好把“校验钥匙、消耗钥匙、完成任务”放在同一业务事务或同一权威状态提交中,而不是让三个独立剧情节点分别修改。
按链路验证,而不是只看对白能不能播
剧情验收至少要覆盖正常路径和重复路径。最简单的做法是把每次执行后的关键状态打印出来,再对照预期。自动化测试中可以进一步把 Console.WriteLine 替换成事件记录器,对事件顺序做断言。
建议按下面顺序检查:
- 新存档进入支线时,读取到
NotStarted,只能进入接取分支。 - 接取后再次交互但没有钥匙,只播放提示,不改变任务状态。
- 持有钥匙后交互,先播放交付对白,再产生完成事件,状态变成
Completed。 - 完成后重复交互,不再次触发接取、完成或奖励类事件。
- 从
Accepted存档恢复时,系统直接进入进行中分支,不依赖“之前那段对白是否播放过”。
把闭环做成可交付资产
一段支线达到“可交付”,不只是设计表里有对白,而是内容、条件和副作用都能被工程系统识别。实际项目中可以把节点配置成数据,把执行器保持通用;但无论使用 JSON、ScriptableObject、DataTable 还是自研编辑器,都应保证每个节点至少能回答三个问题:进入条件是什么、显示什么内容、结束时产生什么事件。
当这三个问题都能从数据和日志中被直接追踪,并且任务状态有唯一写入入口时,这段支线才真正形成工程闭环:内容人员能配置,程序能接入,测试能复现,存档恢复后也能继续执行。