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

重复触发怎么避免

重复触发怎么避免

剧情重复推进通常不是判断条件写错,而是同一个事件在读档、断线重试或界面重入时被执行了第二次。要避免这类问题,需要先区分一次性事件、可重复事件和幂等更新,再把“是否允许执行”写进状态,而不是依赖调用次数。

学习目标

  • 区分一次性事件、可重复事件与幂等更新
  • 用持久化状态阻止读档后的重复触发
  • 让重试可以安全发生,而不会重复发奖励或推进剧情

先定义三类行为

一次性事件只能成功一次,例如“首次见到 NPC 后开启主线”“领取章节首通奖励”。可重复事件允许多次执行,例如“旅店休息”“随机闲聊”。幂等更新则可以被重复调用,但重复调用不会改变最终结果,例如“把门设为已解锁”。

这三类行为不能只靠函数名区分,必须在状态模型中表达。否则读档后系统只看到“条件仍然成立”,就会再次执行副作用。

类型 能否重复调用 重复后的效果 典型做法
一次性事件 可以被再次尝试 不应再次产生副作用 记录已消费事件 ID
可重复事件 可以 每次都允许产生效果 不写完成标记,按规则执行
幂等更新 可以 最终状态不变 直接写目标状态

一次性事件要先检查再提交

下面用“首次进入城镇奖励 100 金币”演示。事件 ID 会持久化在存档中,因此重新加载后仍能知道奖励是否已经发放。

剧情事件触发判定流程

ts
type GameState = {
  coins: number;
  executedEventIds: string[];
};

function triggerWelcomeReward(state: GameState): "executed" | "skipped" {
  const eventId = "welcome-town-reward";

  if (state.executedEventIds.includes(eventId)) {
    return "skipped";
  }

  // 副作用和完成标记必须属于同一次状态提交
  state.coins += 100;
  state.executedEventIds.push(eventId);
  return "executed";
}

const state: GameState = {
  coins: 50,
  executedEventIds: []
};

console.log(triggerWelcomeReward(state), state.coins);
console.log(triggerWelcomeReward(state), state.coins);

预期输出

text
executed 150
skipped 150

第二次调用仍然发生了,但结果被安全地跳过。这比“保证函数绝不调用两次”可靠得多,因为真实运行环境中的重试、恢复和界面重建往往不可避免。

检查和写入必须一起提交

最危险的实现是先检查“还没执行”,然后发奖励,最后才保存完成标记。如果程序在发奖励后崩溃,下一次读档仍会认为事件未执行,于是奖励再次发放。

因此,一次性事件应尽量把“状态副作用”和“完成标记”放在同一个事务、同一个原子写入,或至少放在同一次存档提交中。对于服务端权威状态,还可以让事件 ID 具备唯一约束,避免并发请求同时穿过检查。

幂等更新不需要额外计数

有些行为天然适合改写成“设置最终状态”,而不是“执行一次动作”。例如开门时,与其记录“开门次数 +1”,不如直接写 doorOpened = true。

ts
type WorldState = {
  doorOpened: boolean;
};

function openDoor(state: WorldState): void {
  state.doorOpened = true;
}

const world: WorldState = { doorOpened: false };

openDoor(world);
openDoor(world);
console.log(world.doorOpened);

预期输出

text
true

这种设计尤其适合读档恢复、消息重放和自动重试,因为调用次数不会改变最终状态。

可重复事件要单独设计限制

“允许重复”不等于“无限制”。例如旅店休息可以多次发生,但可能每次扣 20 金币;随机对话可以重复,但同一秒内不应连续触发十次。此时限制条件应来自业务规则,例如冷却时间、资源成本或次数上限,而不是复用一次性事件的完成标记。

真正稳定的剧情事件模型,是让每个事件先回答三个问题:它是否只能生效一次、重复执行是否必须保持相同结果、允许重试时副作用和完成标记是否一起提交。把这三点写进状态与执行入口,读档和重试就不会悄悄把剧情推进两遍。

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

目录与阅读设置

阅读设置

17

记录一个想法

重复触发怎么避免

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

登录哪都通