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

排查节点跳转和变量错误

排查节点跳转和变量错误

节点跳错、条件分支异常或某个节点永远到不了,通常不是“随机故障”,而是跳转目标、变量当前值和条件表达式三者没有对齐。本节用可观测的脚本标记和最小分支复现,把问题从整段剧情缩小到一条跳转或一次变量更新。

学习目标

  • 能检查 jump 目标与实际节点是否一致
  • 能验证条件判断发生时变量到底是什么值
  • 能区分“节点不可达”“变量未按预期更新”和“条件写反”三类问题

先把跳转路径写成可验证链路

遇到“明明应该进 B 却进了 C”,先不要盯着最终节点。沿着当前节点向前找最后一次变量赋值和最后一次 jump,确认脚本真实执行路径。节点名必须与项目中的目标节点一致,重命名节点后尤其要检查旧跳转是否仍然存在。

下面是一个最小分支示例。它展示了变量声明、赋值、条件判断和节点跳转之间的关系,可作为独立 Yarn 测试脚本使用。

text
title: RouteCheck
---
<<declare $trust = 0>>
<<set $trust to 3>>
NPC: 当前 trust = {$trust}
<<if $trust >= 3>>
    <<jump TrustedRoute>>
<<else>>
    <<jump NormalRoute>>
<<endif>>
===

title: TrustedRoute
---
NPC: 进入 TrustedRoute
===

title: NormalRoute
---
NPC: 进入 NormalRoute
===

预期结果:先看到 当前 trust = 3,随后进入 TrustedRoute。

text
当前 trust = 3
进入 TrustedRoute

如果实际进入 NormalRoute,就不要先修改跳转语句;应先确认运行时 $trust 是否真的为 3,以及是否有更早的脚本、存档恢复或外部代码覆盖了它。

节点跳转与变量条件的排查关系

验证变量值而不是猜变量值

条件错误最常见的误判,是把“我认为变量已经改了”当成“运行时变量已经改了”。在条件前临时输出关键变量,能直接看到分支判断使用的值。若变量来自存档、Unity 代码或其他节点,还要确认恢复和覆盖发生在条件判断之前还是之后。

字符串、数字和布尔值要按它们实际类型比较,不要靠视觉上相似的内容推断相等。尤其是剧情状态变量,建议一个变量只表达一个含义,例如 $has_key 表示是否持有钥匙,而不是同时拿 0、1、2 表示多个阶段。

检查不可达节点和跳转目标

一个节点“存在”不代表它“可达”。如果没有任何 jump、选项或外部启动逻辑能进入该节点,它就不会被执行。排查时从异常节点反向寻找入口,比在整个项目里顺着剧情阅读更快。

若节点名称近期改过,优先全局搜索旧名称。Yarn 编译器通常能够发现一部分无效引用,但运行路径问题仍需要你确认:当前条件是否真的走到了那条 jump,以及该跳转前是否已被其他命令提前离开节点。

可以把正式节点临时简化为只保留一条确定路径:

text
title: EntryCheck
---
NPC: 已进入 EntryCheck
<<jump TargetCheck>>
===

title: TargetCheck
---
NPC: 已进入 TargetCheck
===

预期结果:

text
已进入 EntryCheck
已进入 TargetCheck

如果最小路径可以到达,而正式路径不能,问题就在正式节点额外加入的条件、变量更新或提前跳转中;如果最小路径也失败,再检查节点名、编译结果以及启动节点配置。

修复后验证边界分支

条件修好后,不要只测“正确分支”。至少覆盖条件临界值两侧,例如阈值是 3 时分别测试 2 和 3;布尔状态则分别测试 true 和 false。这样能发现 > 与 >=、变量初始化遗漏、旧存档值污染等常见问题。

最终应能回答三个问题:进入当前节点时关键变量是什么、哪条条件决定了跳转、跳转目标是否真实存在且能到达。只要这三点都有运行时证据,节点跳错就不再是靠猜测排查的问题。

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

目录与阅读设置

记录一个想法

排查节点跳转和变量错误

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

登录哪都通