游戏叙事与剧情 / 系统课时
重复触发怎么避免
重复触发怎么避免
剧情重复推进通常不是判断条件写错,而是同一个事件在读档、断线重试或界面重入时被执行了第二次。要避免这类问题,需要先区分一次性事件、可重复事件和幂等更新,再把“是否允许执行”写进状态,而不是依赖调用次数。
学习目标
- 区分一次性事件、可重复事件与幂等更新
- 用持久化状态阻止读档后的重复触发
- 让重试可以安全发生,而不会重复发奖励或推进剧情
先定义三类行为
一次性事件只能成功一次,例如“首次见到 NPC 后开启主线”“领取章节首通奖励”。可重复事件允许多次执行,例如“旅店休息”“随机闲聊”。幂等更新则可以被重复调用,但重复调用不会改变最终结果,例如“把门设为已解锁”。
这三类行为不能只靠函数名区分,必须在状态模型中表达。否则读档后系统只看到“条件仍然成立”,就会再次执行副作用。
| 类型 | 能否重复调用 | 重复后的效果 | 典型做法 |
|---|---|---|---|
| 一次性事件 | 可以被再次尝试 | 不应再次产生副作用 | 记录已消费事件 ID |
| 可重复事件 | 可以 | 每次都允许产生效果 | 不写完成标记,按规则执行 |
| 幂等更新 | 可以 | 最终状态不变 | 直接写目标状态 |
一次性事件要先检查再提交
下面用“首次进入城镇奖励 100 金币”演示。事件 ID 会持久化在存档中,因此重新加载后仍能知道奖励是否已经发放。

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);预期输出
executed 150
skipped 150第二次调用仍然发生了,但结果被安全地跳过。这比“保证函数绝不调用两次”可靠得多,因为真实运行环境中的重试、恢复和界面重建往往不可避免。
检查和写入必须一起提交
最危险的实现是先检查“还没执行”,然后发奖励,最后才保存完成标记。如果程序在发奖励后崩溃,下一次读档仍会认为事件未执行,于是奖励再次发放。
因此,一次性事件应尽量把“状态副作用”和“完成标记”放在同一个事务、同一个原子写入,或至少放在同一次存档提交中。对于服务端权威状态,还可以让事件 ID 具备唯一约束,避免并发请求同时穿过检查。
幂等更新不需要额外计数
有些行为天然适合改写成“设置最终状态”,而不是“执行一次动作”。例如开门时,与其记录“开门次数 +1”,不如直接写 doorOpened = true。
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);预期输出
true这种设计尤其适合读档恢复、消息重放和自动重试,因为调用次数不会改变最终状态。
可重复事件要单独设计限制
“允许重复”不等于“无限制”。例如旅店休息可以多次发生,但可能每次扣 20 金币;随机对话可以重复,但同一秒内不应连续触发十次。此时限制条件应来自业务规则,例如冷却时间、资源成本或次数上限,而不是复用一次性事件的完成标记。
真正稳定的剧情事件模型,是让每个事件先回答三个问题:它是否只能生效一次、重复执行是否必须保持相同结果、允许重试时副作用和完成标记是否一起提交。把这三点写进状态与执行入口,读档和重试就不会悄悄把剧情推进两遍。