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

避免重复领取与重复结算

避免重复领取与重复结算

任务奖励最怕“同一句对话执行两次”:玩家反复点 NPC、读档重进,甚至在结算对白期间再次触发,都可能让金币、道具或关键事件重复发放。本课用任务状态与领取标记组成双重门槛,让结算逻辑具备幂等性。

学习目标

  • 区分“任务已完成”和“奖励已领取”两个独立状态
  • 用条件门槛保证同一任务最多成功结算一次
  • 设计重复进入场景,验证奖励不会二次发放

不要把完成状态等同于已结算

completed 只说明任务目标已经满足,不代表奖励已经发放。玩家可能在完成目标后还没回到 NPC,也可能在结算对白播放到一半时退出。因此至少要保留两类持久状态:任务进度状态,以及奖励是否已领取。

最小状态可以是 $quest_state = "active" | "completed" 与 $reward_claimed = false | true。只有“任务已完成且奖励未领取”时,结算入口才允许继续。这样即使同一个对话节点被反复进入,判断结果也不会依赖“玩家上一次停在哪一行”。

任务完成与奖励领取的幂等门禁

把门禁放在副作用之前

下面是一个 Yarn Script 片段示例。示例约定项目已经提供 grant_reward 命令,用来把奖励真正写入背包或货币系统;游戏侧也应按稳定任务 ID 做重复结算检查。脚本先判断条件,再写入领取标记,最后才触发奖励命令。

text
title: HerbQuestTurnIn
---
<<if $quest_state != "completed">>
村民:还差一些药草,找到后再来吧。
<<elseif $reward_claimed>>
村民:报酬已经给过你了,多谢帮忙。
<<else>>
<<set $reward_claimed to true>>
<<grant_reward "herb_quest" 100>>
村民:这是约好的 100 金币。
<<endif>>
===

预期结果:

text
第一次在 quest_state=completed、reward_claimed=false 时进入:
奖励命令执行 1 次,reward_claimed 变为 true。

第二次及之后再次进入:
只显示“报酬已经给过你了”,奖励命令不再执行。

把标记写在副作用前面,是为了缩小“奖励已发出但标记还没更新”的风险窗口。不过如果奖励写入和存档本身可能失败,最终可靠性不能只靠 Yarn 变量;游戏侧的 grant_reward 仍应检查稳定任务 ID,并让“奖励到账”和“任务已结算”保持一致。

关键剧情事件也要使用同一原则

幂等不仅用于金币和道具。解锁传送点、开启唯一宝箱、推进章节、生成唯一 NPC 等操作都属于副作用。判断标准很简单:如果同一个命令执行两次会改变最终结果,就需要独立的“已处理”标记,或由游戏侧提供幂等接口。

对于一次性事件,推荐使用稳定标识,例如 herb_quest_reward、chapter_2_gate_opened,不要把节点名、行号或临时对象实例 ID 当作业务键。这样脚本重构后,既有存档仍能识别“这件事已经发生过”。

验证重复触发不会破坏状态

至少覆盖三种测试:任务未完成时进入、首次完成后结算、结算后再次进入。还应额外验证“结算后保存并重新载入”,确认 $reward_claimed 和游戏侧奖励记录仍然一致。

如果测试中出现奖励翻倍,不要先修改对白,而要沿着“条件判断 -> 标记写入 -> 奖励命令 -> 存档”顺序检查。只要任何一步仍以“执行次数”代替“最终业务状态”,重复触发就仍有机会穿过门禁。

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

目录与阅读设置

记录一个想法

避免重复领取与重复结算

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

登录哪都通