分支块显示选项列表。玩家选择后,剧本执行该选项关联的 Fragment。
基本用法
在空白旁白块按 Tab,选择「分支」即可插入。
每个选项包含:
- 选项文字:玩家看到的那行字,比如「去图书馆」「回家休息」
- 跳转目标:选择后要执行的 Fragment(剧情片段)
可以直接在选项卡片中编辑文案、变量和样式,新增选项或切换跳转片段;选中分支后也可在检查器中核对完整配置。
选项配置
每个分支块可以包含任意数量的选项。每个选项需要设置:
| 设置项 | 说明 |
|---|
| 选项文字 | 玩家在游戏中看到的选择文本 |
| 目标 Fragment | 从下拉列表中选择要跳转到的 Fragment |
| 默认选项 | 可选;用于预览自动推进 |
默认选项
可将一个选项标记为「默认」:
- 预览自动推进时选择该选项
- 正式运行时仍由玩家手动选择
如果没有标记任何默认选项,预览推进时会自动选第一个。
分支块的标题
可选的标题只在编辑器中显示,用于标识分支用途,不会显示给玩家。
S30 · 选项卡片与片段目标
运行时行为
- 游戏执行到分支块时,画面上会弹出选项列表,等待玩家点选
- 玩家选择后,引擎跳转到对应 Fragment,执行该 Fragment 中的所有内容
- 目标 Fragment 结束后,返回分支块之后的下一个 Block
- 如果游戏处于自动模式或跳过模式,到达分支块时会自动暂停,等待玩家操作
执行流程:
主线 → 分支块弹出选项 → 玩家选择 → 执行目标 Fragment → 回到主线继续
默认情况下,各选项目标 Fragment 结束后都会返回同一主线。结局路线可以在目标 Fragment 中使用其他流程控制 Block。
Fragment 与分支的关系
每个选项必须指向当前章节内的一个 Fragment。Fragment 结束后返回分支块的下一项。
关于 Fragment 的详细说明,参见 编辑器 页面。
先创建目标 Fragment,再配置各选项的目标。
如果一个选项的目标 Fragment 被删除了,该选项在运行时会失效。配置完分支后,注意不要误删被引用的 Fragment。
条件选项全部隐藏时
2.0.0 会在所有选项均设置显示条件时提醒检查。如果实际运行中全部选项被条件隐藏,引擎会恢复显示所有选项,避免流程卡死。它是防卡死措施,不应作为路线设计的正常回退;需要兜底时显式保留一个可用选项,并测试所有条件都不满足的情况。