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

分支跳转怎样避免重复触发

分支跳转怎样避免重复触发

分支剧情一旦允许跳转、回环和事件驱动,同一个节点就可能被再次进入。如果节点里包含发奖励、播过场或修改任务状态,重复执行就会产生真实业务错误。解决思路不是到处加布尔变量,而是统一管理节点执行状态和一次性副作用。

学习目标

  • 识别节点重入、事件重复派发和循环路径造成的重复执行
  • 用统一执行状态阻止同一节点并发或重复完成
  • 把“节点是否执行过”和“副作用是否执行过”分开控制

重复触发通常从哪里出现

最常见的情况有三种:某个事件监听器注册了两次;分支 A 跳到 B 后,旧节点仍继续向下执行;或者剧情图本身存在回环,B 又跳回已经完成的 A。它们表面现象不同,但本质一致:执行器缺少“这个节点当前处于什么阶段”的统一事实来源。

剧情节点重入与状态控制流程

因此,节点执行至少应有 NotStarted、Running、Completed 三个阶段。只判断“是否完成”还不够,因为两个事件几乎同时进入同一节点时,它们都可能看到“尚未完成”,然后同时执行副作用。

用执行登记表拦住节点重入

下面的完整 C# 示例实现两个层次的保护:节点登记表阻止同一节点重复进入;副作用登记表保证同一个奖励动作只执行一次。示例还故意让 node-b 跳回 node-a,验证循环路径不会再次发奖。

csharp
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");
    }
}

预期输出:

text
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 节点仍执行副作用”时,就能快速判断是事件重复订阅、图结构回环,还是执行器状态控制失效。

稳定的剧情执行器不要求剧情图永远没有环,而是即使出现重复事件、回跳和并发进入,也能根据节点策略做出确定行为,并保证关键副作用只发生一次。

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

目录与阅读设置

阅读设置

17

记录一个想法

分支跳转怎样避免重复触发

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

登录哪都通