游戏叙事与剧情 / 系统课时
接入游戏侧状态与输入
接入游戏侧状态与输入
Ink 真正接入游戏后,脚本不能只靠自身变量推进:角色生命值、任务进度等条件来自游戏侧,而玩家点击的选项又必须回传给 Story。本节把状态注入、剧情推进、选项展示和玩家输入串成一条可验证的运行时链路。
学习目标
- 将游戏侧状态写入 Ink 变量,并让剧情据此产生不同文本
- 将 Ink 的当前选项暴露给游戏界面,再把玩家选择回传给 Story
- 用明确的调用顺序验证状态、文本和输入没有脱节
交互链路应该由谁负责
游戏侧应当掌握运行循环,Ink 负责根据当前故事状态生成文本和选项。典型的一次交互是:游戏先同步条件,随后持续调用 Continue(),直到 Ink 停在选择点;界面读取 currentChoices;玩家点击后,游戏调用 ChooseChoiceIndex(),再进入下一轮推进。

这里有两个容易混淆的边界。第一,Continue() 只负责让故事继续执行,不等于替玩家选择;第二,选项索引应来自当前 currentChoices,不能缓存旧索引后跨剧情节点复用。
准备一段依赖游戏状态的剧情
下面的 Ink 脚本声明 player_hp,游戏会在运行时覆盖它。生命值大于 50 时显示状态良好的文本,否则提示先恢复体力。
VAR player_hp = 0
=== start ===
{ player_hp > 50:
你看起来状态不错。
- else:
你需要先恢复体力。
}
+ [询问守卫]
守卫问:“准备好了吗?”
-> END
+ [离开]
你暂时离开了入口。
-> END这段脚本需要先由 Ink 工具链编译为游戏运行时加载的 JSON。生效行为是:游戏写入不同的 player_hp 后,同一个剧情入口会输出不同的首段文本,但仍停在相同的两个选择上。
在 Unity 中连接状态、文本和选择
下面是一个最小运行时组件。它假设项目已经安装 Ink Unity Integration,并在 Inspector 中把编译后的 Ink JSON 赋给 storyJson。Begin() 负责创建 Story 和同步游戏状态,Advance() 负责消费玩家输入。
using System.Text;
using Ink.Runtime;
using UnityEngine;
public sealed class InkGameBridge : MonoBehaviour
{
[SerializeField] private TextAsset storyJson;
private Story story;
public void Begin(int playerHp)
{
story = new Story(storyJson.text);
// 游戏状态在剧情开始前同步,Ink 只读取这份运行时值。
story.variablesState["player_hp"] = playerHp;
PrintUntilChoice();
}
public void Advance(int choiceIndex)
{
if (story == null)
throw new System.InvalidOperationException("Story 尚未初始化");
if (choiceIndex < 0 || choiceIndex >= story.currentChoices.Count)
throw new System.ArgumentOutOfRangeException(nameof(choiceIndex));
// 索引必须对应当前选择点,选择完成后再继续推进故事。
story.ChooseChoiceIndex(choiceIndex);
PrintUntilChoice();
}
private void PrintUntilChoice()
{
var output = new StringBuilder();
while (story.canContinue)
{
string text = story.Continue().Trim();
if (text.Length > 0)
output.AppendLine(text);
}
if (output.Length > 0)
Debug.Log(output.ToString().TrimEnd());
for (int i = 0; i < story.currentChoices.Count; i++)
Debug.Log($"[{i}] {story.currentChoices[i].text}");
}
}例如游戏调用 Begin(80),随后玩家点击界面上的第一个选项并调用 Advance(0)。
预期输出:
你看起来状态不错。
[0] 询问守卫
[1] 离开
守卫问:“准备好了吗?”如果改成 Begin(30),第一行应变为“你需要先恢复体力。”,而选择列表保持不变。Unity 日志前缀、时间和对象名可能因编辑器环境不同而额外出现,但剧情文本与选择顺序应一致。
处理真实游戏中的状态同步边界
不要在每次 Continue() 前无条件把所有游戏变量重新写入 Ink。这样很容易覆盖脚本刚刚修改的状态。更稳妥的做法是先确定每个变量的所有权:生命值、装备、世界时间这类权威数据通常由游戏侧维护;只服务于叙事推进的局部变量可以由 Ink 自己维护。
玩家输入也应在界面层和 Story 之间保持单向传递:界面展示当前 currentChoices,点击时只提交对应索引,随后立即重新读取新的文本和选项。不要假设选择后一定还有文本,也不要假设一定会继续出现下一个选择。
验证接入是否真的完整
至少验证三个场景:分别用高、低生命值进入同一故事,确认条件文本变化;分别选择两个选项,确认 ChooseChoiceIndex() 推进到正确分支;到达 END 后确认界面不会继续显示上一个选择点的按钮。
这条链路稳定后,游戏侧只需要维护“同步状态、展示输出、提交输入”三个职责,Ink 就可以继续专注于分支和叙事逻辑,而不会与具体 UI 实现耦合。