游戏叙事与剧情 / 系统课时
分支跳转怎样避免重复触发
分支跳转怎样避免重复触发
分支剧情一旦允许跳转、回环和事件驱动,同一个节点就可能被再次进入。如果节点里包含发奖励、播过场或修改任务状态,重复执行就会产生真实业务错误。解决思路不是到处加布尔变量,而是统一管理节点执行状态和一次性副作用。
学习目标
- 识别节点重入、事件重复派发和循环路径造成的重复执行
- 用统一执行状态阻止同一节点并发或重复完成
- 把“节点是否执行过”和“副作用是否执行过”分开控制
重复触发通常从哪里出现
最常见的情况有三种:某个事件监听器注册了两次;分支 A 跳到 B 后,旧节点仍继续向下执行;或者剧情图本身存在回环,B 又跳回已经完成的 A。它们表面现象不同,但本质一致:执行器缺少“这个节点当前处于什么阶段”的统一事实来源。

因此,节点执行至少应有 NotStarted、Running、Completed 三个阶段。只判断“是否完成”还不够,因为两个事件几乎同时进入同一节点时,它们都可能看到“尚未完成”,然后同时执行副作用。
用执行登记表拦住节点重入
下面的完整 C# 示例实现两个层次的保护:节点登记表阻止同一节点重复进入;副作用登记表保证同一个奖励动作只执行一次。示例还故意让 node-b 跳回 node-a,验证循环路径不会再次发奖。
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
enum NodeState
{
NotStarted,
Running,
Completed
}
sealed class NarrativeRuntime
{
private readonly Dictionary<string, NodeState> _nodeStates = new();
private readonly HashSet<string> _executedEffects = new();
public async Task EnterNodeAsync(string nodeId)
{
NodeState state = _nodeStates.GetValueOrDefault(
nodeId, NodeState.NotStarted);
if (state == NodeState.Running)
{
Console.WriteLine($"{nodeId}: 正在执行,拒绝重入");
return;
}
if (state == NodeState.Completed)
{
Console.WriteLine($"{nodeId}: 已完成,跳过");
return;
}
_nodeStates[nodeId] = NodeState.Running;
try
{
Console.WriteLine($"{nodeId}: 开始");
if (nodeId == "node-a")
{
ExecuteEffectOnce("reward:gold:100");
await EnterNodeAsync("node-b");
}
else if (nodeId == "node-b")
{
Console.WriteLine("node-b: 跳回 node-a");
await EnterNodeAsync("node-a");
}
_nodeStates[nodeId] = NodeState.Completed;
Console.WriteLine($"{nodeId}: 完成");
}
catch
{
_nodeStates[nodeId] = NodeState.NotStarted;
throw;
}
}
private void ExecuteEffectOnce(string effectKey)
{
if (_executedEffects.Add(effectKey))
{
Console.WriteLine("发放金币 100");
}
else
{
Console.WriteLine($"{effectKey}: 副作用已执行,跳过");
}
}
}
static class Program
{
static async Task Main()
{
var runtime = new NarrativeRuntime();
await runtime.EnterNodeAsync("node-a");
await runtime.EnterNodeAsync("node-a");
}
}预期输出:
node-a: 开始
发放金币 100
node-b: 开始
node-b: 跳回 node-a
node-a: 正在执行,拒绝重入
node-b: 完成
node-a: 完成
node-a: 已完成,跳过输出中的第一次回跳发生在 node-a 仍是 Running 时,因此被判定为重入;第二次手动进入发生在它已经 Completed 之后,因此直接跳过。两种情况都不会再次执行奖励。
节点状态和副作用去重要分开
只靠节点状态不能覆盖所有业务。一个节点可能允许重复进入,但其中某个动作只能执行一次,例如首次解锁成就;反过来,一个一次性节点里也可能包含可重复展示的纯 UI 动作。
因此建议把两个概念拆开:
- 节点执行状态回答“这个节点当前能否再次进入”。
- 副作用键回答“这个不可逆动作是否已经提交过”。
effectKey 应稳定、可追踪,例如 quest:main-01:complete、reward:chapter-3:gold-100。真正上线时,这些键通常还要跟存档作用域绑定,否则读档、切换角色或新周目会误用旧状态。
分支跳转后要立即交出控制权
另一类重复触发不是重入,而是“跳转后旧节点还继续执行”。例如节点先调用 EnterNodeAsync("next"),随后又执行旧节点剩余动作,就可能同时推进两条路径。
工程上应给“跳转”明确的终止语义:一旦当前节点决定跳到其他节点,就结束当前节点的后续动作;如果使用命令列表,可以让 Jump 返回专门的控制结果,由执行循环立即退出当前列表。不要依赖开发者记得在每个跳转后手写 return。
用日志验证执行链
排查重复触发时,至少记录节点 ID、进入时间、进入来源、旧状态和本次动作。看到“同一帧两次 Enter”“Running 状态再次进入”或“Completed 节点仍执行副作用”时,就能快速判断是事件重复订阅、图结构回环,还是执行器状态控制失效。
稳定的剧情执行器不要求剧情图永远没有环,而是即使出现重复事件、回跳和并发进入,也能根据节点策略做出确定行为,并保证关键副作用只发生一次。