游戏叙事与剧情 / 系统课时
让对话触发任务状态变化
让对话触发任务状态变化
这节把 Ink 对话真正接到 Unity 任务系统:剧情只负责发出“任务应变化”的意图,Unity 负责校验、更新和持久化状态。完成后,玩家走到指定剧情节点时,任务可以从未接取切到进行中,并能在控制台验证调用链。
学习目标
- 理解 Ink 剧情与任务状态之间的职责边界
- 使用外部函数把剧情节点映射为 Unity 任务更新
- 验证任务更新只在目标节点执行,并识别重复触发风险
对话事件怎样到达任务系统
不要让 Ink 自己成为任务存档的唯一来源。更稳妥的做法是:Ink 在剧情节点发出动作,Unity 接收动作后交给任务服务,任务服务再负责状态合法性、存档和 UI 刷新。这样以后即使换存档格式或任务界面,也不需要重写剧情文本。

这个边界的关键是“剧情发事件,任务系统做决定”。例如同一节点被玩家重新进入时,任务系统可以拒绝非法回退,避免剧情脚本直接把已完成任务改回进行中。
在 Ink 中声明任务动作
先在 Ink 中声明外部函数,再在真正需要改变任务的节点调用它。下面是片段示例,依赖 Unity 侧绑定同名函数。
EXTERNAL SetQuestState(questId, state)
=== intro ===
守卫:仓库钥匙昨晚不见了,你能帮我找回来吗?
~ SetQuestState("quest_find_key", "active")
任务已经记录,先去旧仓库看看。
-> ENDEXTERNAL 只声明接口,不包含 Unity 实现。~ SetQuestState(...) 执行到这一行时,Ink Runtime 会调用宿主程序绑定的函数;如果 Unity 没有绑定同名函数,运行时会报外部函数未绑定的问题。
在 Unity 中绑定外部函数
下面的组件是可直接挂到 GameObject 上的最小示例。前提是项目已导入 Ink Unity Integration,并把编译后的 Ink JSON 资源赋给 inkJsonAsset。
using System.Collections.Generic;
using Ink.Runtime;
using UnityEngine;
public class QuestDialogueRunner : MonoBehaviour
{
[SerializeField] private TextAsset inkJsonAsset;
private Story story;
private readonly Dictionary<string, string> questStates =
new Dictionary<string, string>();
private void Start()
{
story = new Story(inkJsonAsset.text);
// 外部函数只负责把剧情意图交给 Unity。
story.BindExternalFunction(
"SetQuestState",
(string questId, string state) => SetQuestState(questId, state)
);
story.ChoosePathString("intro");
string dialogue = story.ContinueMaximally();
Debug.Log(dialogue.Trim());
}
private void SetQuestState(string questId, string state)
{
// 示例直接写字典;生产项目应改为调用统一的 QuestService。
questStates[questId] = state;
Debug.Log($"Quest {questId} -> {state}");
}
}预期输出:
Quest quest_find_key -> active
守卫:仓库钥匙昨晚不见了,你能帮我找回来吗?
任务已经记录,先去旧仓库看看。控制台中先出现任务状态日志,是因为 ContinueMaximally() 会先推进剧情并执行外部函数,随后才把累计文本返回给 Unity。实际日志时间戳、对象前缀等编辑器信息可能不同。
把状态校验留在 Unity
真实任务系统通常不能接受任意字符串直接覆盖状态。例如已完成任务不应被普通回访对话重新改成进行中,未知任务 ID 也不应静默创建。生产代码应让 SetQuestState 调用统一服务,由服务判断“当前状态 → 目标状态”是否合法,再决定是否落盘。
验证时至少检查三件事:进入 intro 前任务未变化;执行到外部函数后状态变为 active;再次进入同一节点时,任务服务不会产生重复奖励或非法状态回退。做到这一步,对话与任务系统的连接才算真正可用。