游戏叙事与剧情 / 系统课时

让对话触发任务状态变化

让对话触发任务状态变化

这节把 Ink 对话真正接到 Unity 任务系统:剧情只负责发出“任务应变化”的意图,Unity 负责校验、更新和持久化状态。完成后,玩家走到指定剧情节点时,任务可以从未接取切到进行中,并能在控制台验证调用链。

学习目标

  • 理解 Ink 剧情与任务状态之间的职责边界
  • 使用外部函数把剧情节点映射为 Unity 任务更新
  • 验证任务更新只在目标节点执行,并识别重复触发风险

对话事件怎样到达任务系统

不要让 Ink 自己成为任务存档的唯一来源。更稳妥的做法是:Ink 在剧情节点发出动作,Unity 接收动作后交给任务服务,任务服务再负责状态合法性、存档和 UI 刷新。这样以后即使换存档格式或任务界面,也不需要重写剧情文本。

Ink 对话触发 Unity 任务状态的数据流

这个边界的关键是“剧情发事件,任务系统做决定”。例如同一节点被玩家重新进入时,任务系统可以拒绝非法回退,避免剧情脚本直接把已完成任务改回进行中。

在 Ink 中声明任务动作

先在 Ink 中声明外部函数,再在真正需要改变任务的节点调用它。下面是片段示例,依赖 Unity 侧绑定同名函数。

text
EXTERNAL SetQuestState(questId, state)

=== intro ===
守卫:仓库钥匙昨晚不见了,你能帮我找回来吗?
~ SetQuestState("quest_find_key", "active")
任务已经记录,先去旧仓库看看。
-> END

EXTERNAL 只声明接口,不包含 Unity 实现。~ SetQuestState(...) 执行到这一行时,Ink Runtime 会调用宿主程序绑定的函数;如果 Unity 没有绑定同名函数,运行时会报外部函数未绑定的问题。

在 Unity 中绑定外部函数

下面的组件是可直接挂到 GameObject 上的最小示例。前提是项目已导入 Ink Unity Integration,并把编译后的 Ink JSON 资源赋给 inkJsonAsset。

csharp
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}");
    }
}

预期输出:

text
Quest quest_find_key -> active
守卫:仓库钥匙昨晚不见了,你能帮我找回来吗?
任务已经记录,先去旧仓库看看。

控制台中先出现任务状态日志,是因为 ContinueMaximally() 会先推进剧情并执行外部函数,随后才把累计文本返回给 Unity。实际日志时间戳、对象前缀等编辑器信息可能不同。

把状态校验留在 Unity

真实任务系统通常不能接受任意字符串直接覆盖状态。例如已完成任务不应被普通回访对话重新改成进行中,未知任务 ID 也不应静默创建。生产代码应让 SetQuestState 调用统一服务,由服务判断“当前状态 → 目标状态”是否合法,再决定是否落盘。

验证时至少检查三件事:进入 intro 前任务未变化;执行到外部函数后状态变为 active;再次进入同一节点时,任务服务不会产生重复奖励或非法状态回退。做到这一步,对话与任务系统的连接才算真正可用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让对话触发任务状态变化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通