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

剧情为什么突然跳阶段

剧情为什么突然跳阶段

剧情从第二阶段突然跳到第四阶段,通常不是某一行赋值单独出错,而是触发器、条件判断、状态更新和任务监听之间形成了意外链路。排查时应沿真实执行顺序逐段验证,而不是只盯着最终的 stage 值。

学习目标

  • 按触发器、条件、状态更新、监听器的顺序定位异常跳转
  • 区分重复触发、条件过宽和监听器连锁更新
  • 用事件日志复原一次错误推进的完整链路

先还原正常推进链路

一个常见设计是:玩家完成事件后触发规则,规则检查条件,通过后修改剧情状态,状态变化再通知任务系统。问题在于这四个环节都可能再次产生新事件,因此一次合法推进可能意外触发第二次推进。

剧情异常跳阶段的触发链路与排查顺序

因此排查顺序应该固定:先确认谁触发了规则,再看条件为什么通过,然后核对实际写入了什么状态,最后检查哪些监听器在状态变化后继续执行。这样可以避免只看到结果,却漏掉前面的第二次触发。

给每次推进留下可串联的日志

最有效的排查手段是给一次剧情推进分配 traceId,让触发、条件判断、状态修改和监听器都带上同一个标识。下面的最小示例故意保留一个“监听器再次推进”的问题,便于观察异常链路。

ts
type StoryState = { stage: number };

const state: StoryState = { stage: 2 };

function advanceStage(traceId: string, source: string) {
  console.log(`[${traceId}] trigger source=${source} stage=${state.stage}`);

  const allowed = state.stage >= 2;
  console.log(`[${traceId}] condition allowed=${allowed}`);

  if (!allowed) return;

  state.stage += 1;
  console.log(`[${traceId}] update stage=${state.stage}`);

  if (state.stage === 3) {
    console.log(`[${traceId}] listener quest-completed`);
    advanceStage(traceId, "quest-listener");
  }
}

advanceStage("T-001", "battle-ended");

预期输出

text
[T-001] trigger source=battle-ended stage=2
[T-001] condition allowed=true
[T-001] update stage=3
[T-001] listener quest-completed
[T-001] trigger source=quest-listener stage=3
[T-001] condition allowed=true
[T-001] update stage=4

日志已经说明根因:第一次从 2 推到 3 是正常的,但监听器又调用了同一个推进函数;同时条件写成 stage >= 2,所以第二次触发仍然通过,最终跳到 4。

分四个环节逐项定位

先查触发器是否被注册两次、事件是否重复投递、按钮或回调是否可能重复执行。若同一业务事件出现两个不同 traceId,更像是上游重复触发;若同一个 traceId 内出现两次推进,则更像内部连锁调用。

然后检查条件是否使用了过宽判断。例如剧情只允许从阶段 2 进入 3,却写成 stage >= 2,那么阶段 3 再次进入时仍然会通过。对阶段推进这类状态机规则,更适合写成“当前阶段必须等于某个值”的精确条件。

接着核对更新操作是否一次改了多个相关字段。有些系统在设置 stage=3 的同时还会写 questStatus=completed,后者又可能触发任务监听器。如果日志只记录最终对象而没有记录“谁改了哪个字段”,很难发现这类间接触发。

最后检查监听器职责。监听器可以派发奖励、刷新界面或记录日志,但如果它还能直接再次推进剧情,就容易形成隐式环路。

修复后怎样验收

修复时应同时解决“为什么会再次触发”和“为什么再次触发还能通过”两个问题。例如监听器不再直接调用推进逻辑,并把条件改成 state.stage === 2。这样即使未来再次出现重复事件,状态机本身仍有第二道保护。

验收时至少覆盖正常一次推进、同事件重复投递、监听器回调再次进入三种情况。正常路径应只产生一次阶段变化;重复调用应被条件拒绝;任意一次状态修改都能通过 traceId 找到来源。做到这三点,剧情跳阶段就不再是“偶发现象”,而会变成可以稳定复现和定位的链路问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

剧情为什么突然跳阶段

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

登录哪都通