游戏叙事与剧情 / 系统课时
把玩家数据带入剧情判断
把玩家数据带入剧情判断
剧情经常要读取好感度、钥匙持有状态或任务进度。如果每个分支都回调 Unity 查询一次,脚本会迅速被接口细节淹没。本节把玩家状态集中映射到 Ink 变量,让剧情只关心条件本身,并掌握何时同步才不会读到旧数据。
学习目标
- 用
variablesState把 Unity 玩家数据写入 Ink 全局变量 - 在 Ink 中用布尔值和数值组合剧情条件,减少玩法层硬编码
- 选择正确的同步时机,避免存档恢复或状态变化后继续使用旧值
先把游戏状态变成剧情输入
玩家系统和剧情系统的数据模型不应该完全相同。Unity 里可能有复杂的背包对象、任务实体和角色关系表,但 Ink 判断通常只需要少量稳定事实,例如 affection、has_key、quest_done。
因此应在两侧之间增加一层映射:Unity 负责把复杂对象整理成剧情需要的基础类型,再一次性写入 Story.variablesState。Ink 不需要知道钥匙来自哪个背包槽位,也不需要理解任务系统的类结构。

建立变量并完成同步
先在 Ink 文件中声明可从 Unity 写入的全局变量,再直接使用这些变量进行分支判断。
VAR affection = 0
VAR has_key = false
VAR quest_done = false
{
- quest_done:
The gatekeeper nods. Your task is already complete.
- has_key && affection >= 5:
The gatekeeper trusts you and lets you use the key.
- else:
The gatekeeper refuses to let you pass.
}
-> ENDUnity 侧在推进剧情前完成一次映射。下面示例使用固定初始值,方便验证;真实项目中把三个字段替换为玩家存档或运行时状态即可。
using Ink.Runtime;
using UnityEngine;
public class InkPlayerStateDemo : MonoBehaviour
{
[SerializeField] private TextAsset inkJsonAsset;
[SerializeField] private int affection = 6;
[SerializeField] private bool hasKey = true;
[SerializeField] private bool questDone = false;
private Story story;
private void Start()
{
story = new Story(inkJsonAsset.text);
SyncPlayerStateToInk();
string text = story.ContinueMaximally().Trim();
Debug.Log(text);
}
private void SyncPlayerStateToInk()
{
// 统一映射,避免剧情推进代码到处散落变量名。
story.variablesState["affection"] = affection;
story.variablesState["has_key"] = hasKey;
story.variablesState["quest_done"] = questDone;
}
}保持示例默认值时,预期输出为:
The gatekeeper trusts you and lets you use the key.把 questDone 改为 true 后重新运行,第一条条件会优先命中;把 hasKey 改为 false,且任务未完成时,则会进入拒绝分支。这样可以直接验证 Unity 状态确实参与了 Ink 条件判断。
为什么不要在分支里硬编码玩法查询
一种常见写法是为 has_key、get_affection、is_quest_done 分别定义外部函数,然后在多个剧情条件里反复调用。它能工作,但会让剧情执行过程依赖大量 Unity 回调,也让存档回放、测试和脱离 Unity 的剧情检查变得更困难。
把稳定状态同步成变量后,Ink 看到的是一次确定的快照。编剧可以直接阅读条件,自动化测试也能通过修改变量构造不同路径。只有“执行一个游戏动作”时,才更适合使用外部函数。
选择同步时机
最关键的原则是:在剧情即将依赖这些值之前同步,而不是每帧同步。 新建 Story、读取存档后恢复剧情、玩家完成任务后准备进入下一段关键对话,都是合适时机。
如果一段对话中途允许玩家通过玩法改变状态,应在再次调用 Continue() 或选择会读取该状态的分支前重新执行同步。反过来,如果数据在整段对话期间不会变化,就没有必要每次推进一句文本都重复写入。
集中映射让两套系统的职责保持稳定:Unity 保存真实玩家状态,Ink 保存当前剧情判断所需的输入快照。只要同步点选对,剧情条件就能保持简洁,同时避免把玩法实现细节硬编码进脚本。