游戏叙事与剧情 / 系统课时
写出可运行的 Yarn 节点
写出可运行的 Yarn 节点
本课用一份最小脚本把 Yarn 的“节点、台词、选项、跳转”串成完整执行链。完成后,你可以从 Start 节点进入对话,根据玩家选择跳到不同节点,并在 Unity 中验证实际显示结果。
学习目标
- 写出包含合法标题、正文边界和角色台词的 Yarn 节点
- 使用选项与
<<jump>>组织最小分支 - 把脚本加入 Yarn Project,并从 Dialogue Runner 跑通分支
节点为什么能被执行
Yarn 脚本由一个或多个节点组成。每个节点至少包含 title 头部、正文开始标记 --- 和结束标记 ===。title 是运行器定位节点和跳转目标使用的名字,并不会直接显示给玩家。
节点标题应以字母开头,只使用字母、数字和下划线;例如 Start、Forest_1 合法,而带空格、句点或以数字开头的标题不适合作为节点名。正文区域中既可以写普通台词,也可以写选项和命令。
写一份完整的分支脚本
创建或打开一个 .yarn 文件,将内容替换为下面这份脚本。它包含入口节点 Start,以及两个可跳转的目标节点:
title: Start
---
Guide: 欢迎来到路口。
Guide: 你想往哪里走?
-> 进入森林
<<jump Forest>>
-> 返回营地
<<jump Camp>>
===
title: Forest
---
Guide: 你走进森林,听见远处的溪水声。
Guide: 前方的道路暂时安全。
===
title: Camp
---
Guide: 你回到营地,篝火还没有熄灭。
Guide: 这次探索先到这里。
===预期结果:
Guide: 欢迎来到路口。
Guide: 你想往哪里走?
[选项] 进入森林
[选项] 返回营地选择“进入森林”后,接下来显示:
Guide: 你走进森林,听见远处的溪水声。
Guide: 前方的道路暂时安全。-> 定义玩家可选内容,缩进在该选项下的 <<jump Forest>> 只会在这个选项被选中时执行。<<jump>> 后面的名字必须与目标节点的 title 完全一致,否则编译或运行时无法找到目标节点。

把脚本接入 Unity
如果当前项目还没有 Yarn Spinner,先完成安装并在场景中通过 GameObject > Yarn Spinner > Dialogue System 创建 Dialogue System。然后通过 Assets > Create > Yarn Spinner > Yarn Script 创建脚本资源,并把上面的内容保存进去。
选中该 Yarn Script,在 Inspector 中创建 Yarn Project;如果已经有 Yarn Project,也可以把脚本纳入现有项目。随后选中场景里的 Dialogue Runner,把对应 Yarn Project 赋给 Yarn Project 字段。入口节点使用脚本中的 Start。
点击 Play 后,Dialogue Runner 会从 Start 开始执行:先显示两句台词,再等待玩家选择。选择其中一个选项后,运行器执行对应的 <<jump>>,切换到目标节点并继续显示台词。
快速定位脚本错误
如果对话没有按预期跳转,先从脚本结构而不是 UI 样式查起。最常见的是目标标题拼写不一致、节点缺少 --- 或 ===、以及 <<jump>> 没有缩进到对应选项之下。
当脚本能显示两个选项,且两个选项分别进入 Forest 与 Camp,这份 Yarn 文件就已经具备最小的可执行结构:入口明确、分支可选、目标可达。