游戏叙事与剧情 / 系统课时
台词正常但选项不出现
台词正常但选项不出现
台词能显示而按钮为空,通常说明 Ink 已经运行起来,但“推进故事、读取 currentChoices、创建按钮”之间有一步断开。排查重点不是重编剧情,而是确认选择生成时机和 UI 刷新顺序。
学习目标
- 理解
canContinue、Continue()与currentChoices的正确读取时机。 - 能用运行时状态区分“Ink 没生成选项”和“Unity 没显示选项”。
- 能实现一次完整的选项创建、点击、继续剧情闭环。
先确认选择是否已经生成
Ink 的典型循环分两段:先在 canContinue 为 true 时持续调用 Continue() 消费可输出文本;当不能继续自动推进时,再读取 currentChoices。如果只调用一次 Continue() 就立即查选项,故事可能还没走到 choice 边界。

因此最关键的诊断值只有两个:story.canContinue 和 story.currentChoices.Count。当 canContinue 仍为 true 时选项为空,先继续推进;当它为 false 且选项数量大于 0 时,Ink 已经完成自己的工作,问题应转向 Unity UI。
用一条最小剧情验证状态
先用最简单的 Ink 内容排除条件表达式、存档状态和复杂跳转。下面的内容是测试剧情源文件,在第一句台词之后会产生两个可见选项:
你走到岔路口。
* [向左走]
你走进树林。
-> END
* [向右走]
你看见河流。
-> END这段源文件由 Ink 编译后交给运行时执行。如果它在 Ink Player 中能看到两个选项,而游戏界面看不到,说明剧情定义本身不是首要嫌疑。此时应在 Unity 中直接观察运行时选择数量,不要继续盲改 Ink 文件。
把读取和 UI 刷新放在同一个闭环
下面以 Ink Unity Integration 2.x、TextMeshPro 和 Unity UI 为例。脚本会先消费当前段落,再根据 currentChoices 创建按钮;点击按钮后用对应索引调用 ChooseChoiceIndex,然后重新刷新。
using System.Text;
using Ink.Runtime;
using Ink.UnityIntegration;
using TMPro;
using UnityEngine;
using UnityEngine.UI;
public sealed class InkChoiceView : MonoBehaviour
{
[SerializeField] private InkFile inkFile;
[SerializeField] private TMP_Text dialogueText;
[SerializeField] private Transform choicesRoot;
[SerializeField] private Button choiceButtonPrefab;
private Story story;
private void Start()
{
if (inkFile == null || dialogueText == null ||
choicesRoot == null || choiceButtonPrefab == null)
{
Debug.LogError("InkChoiceView references are incomplete.");
enabled = false;
return;
}
story = new Story(inkFile.storyJson);
Refresh();
}
private void Refresh()
{
ClearChoices();
var buffer = new StringBuilder();
while (story.canContinue)
{
string line = story.Continue().Trim();
if (line.Length > 0)
{
buffer.AppendLine(line);
}
}
dialogueText.text = buffer.ToString().TrimEnd();
for (int i = 0; i < story.currentChoices.Count; i++)
{
Choice choice = story.currentChoices[i];
Button button = Instantiate(choiceButtonPrefab, choicesRoot);
TMP_Text label = button.GetComponentInChildren<TMP_Text>();
if (label == null)
{
Debug.LogError("Choice button prefab has no TMP_Text label.");
Destroy(button.gameObject);
continue;
}
label.text = choice.text;
int choiceIndex = i;
button.onClick.AddListener(() =>
{
story.ChooseChoiceIndex(choiceIndex);
Refresh();
});
}
Debug.Log(
$"canContinue={story.canContinue}, choices={story.currentChoices.Count}"
);
}
private void ClearChoices()
{
for (int i = choicesRoot.childCount - 1; i >= 0; i--)
{
GameObject child = choicesRoot.GetChild(i).gameObject;
child.SetActive(false);
Destroy(child);
}
}
}预期结果:
台词:
你走到岔路口。
按钮:
向左走
向右走
Console:
canContinue=False, choices=2点击“向左走”后,ChooseChoiceIndex(0) 会推进到对应分支,再次刷新时台词应变成“你走进树林。”,此时故事已经到达结尾,因此选择数量会变成 0。
按状态组合定位断链
如果 canContinue=true 且 choices=0,说明故事还存在未消费文本,继续调用 Continue(),直到自动推进停止。如果 canContinue=false 且 choices>0,Ink 已经生成选项,检查 Prefab、父容器、布局、Canvas 层级以及刷新函数是否真的创建了按钮。
如果 canContinue=false 且 choices=0,再回到剧情状态检查:当前路径可能本来就没有 choice,条件可能把所有 choice 过滤掉,或者加载的存档已经走过一次性选择。此时应先在 Ink Player 中用同一剧情状态复现,而不是把问题归咎于按钮代码。
点击后不推进时检查索引
按钮已经出现但点击后没反应,重点看监听器是否最终调用了 ChooseChoiceIndex,以及传入索引是否仍对应创建按钮时的 choice。示例中把循环变量复制到 choiceIndex,就是为了让每个按钮持有自己的索引。
同时确认按钮没有被透明的 UI 层遮挡、interactable 没被关闭,并且点击后确实重新执行了 Refresh()。只要形成“读文本 → 显示 choices → 选择索引 → 再读文本”的闭环,台词正常却没有选项的问题就能被明确定位在 Story 状态或 UI 刷新其中一侧。