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

让对白推进任务状态

让对白推进任务状态

有些对白只是展示信息,有些对白会真正改变任务。本课把“说了什么”和“游戏状态发生了什么”拆开:Yarn 节点负责叙事节奏,在明确的关键点发出业务命令,由游戏侧任务服务完成状态更新,这样对话不会偷偷承担存档、奖励或任务规则。

学习目标

  • 区分叙事表现动作与会改变游戏业务状态的动作。
  • 在关键对白节点触发一次明确、可追踪的任务状态更新。
  • 用桥接层把 Yarn 命令交给任务服务,而不是让脚本直接维护业务真值。

先划清表现动作和业务动作

角色说话、播放表情、切换镜头、等待几百毫秒,都属于叙事表现;它们失败时通常只影响观感。接受任务、完成任务、发放奖励、解锁区域则属于业务动作,会影响存档、UI 和后续玩法,必须经过正式的游戏逻辑。

因此,Yarn 脚本里可以出现一个语义明确的自定义命令,例如 quest_set,但它只负责“提出更新请求”。真正的状态校验、持久化和联动仍由 C# 任务服务处理。

在关键对白处发出业务命令

接受任务时,状态变化应放在玩家选择“接受”之后,而不是放在 NPC 开场白之前。这样玩家退出对话、选择拒绝或跳过时,不会提前把任务标记为进行中。

片段示例:quest_set 是项目自定义命令,不是 Yarn Spinner 内置任务系统。

text
title: QuestOffer
---
药师: 北坡缺三株月见草,你愿意帮我找吗?

-> 接受
    玩家: 我去看看。
    <<quest_set herbs in_progress>>
    药师: 好,找到后带回来给我。

-> 以后再说
    玩家: 我现在还有别的事。
    药师: 没关系,想好了再来找我。
===

预期结果:选择“接受”时才触发一次任务更新;选择“以后再说”时不改变任务状态。

text
接受       -> herbs = in_progress
以后再说   -> herbs 保持原状态

对白命令到任务状态更新的数据流

用桥接层接住 Yarn 命令

Unity 侧可以在 DialogueRunner 上注册一个参数化命令,把脚本中的字符串参数翻译为任务系统认识的状态。下面是依赖现有 Yarn Spinner 场景的片段示例:场景中需要已经有 DialogueRunner,并把它拖到组件字段。

csharp
using System;
using System.Collections.Generic;
using UnityEngine;
using Yarn.Unity;

public sealed class QuestDialogueBridge : MonoBehaviour
{
    [SerializeField] private DialogueRunner dialogueRunner;

    private readonly Dictionary<string, QuestState> states = new();

    private void Awake()
    {
        states["herbs"] = QuestState.NotStarted;

        // Yarn 只发送命令;业务状态仍由这一层统一处理。
        dialogueRunner.AddCommandHandler<string, string>(
            "quest_set",
            SetQuestState
        );
    }

    private void SetQuestState(string questId, string rawState)
    {
        QuestState target = rawState switch
        {
            "not_started" => QuestState.NotStarted,
            "in_progress" => QuestState.InProgress,
            "completed" => QuestState.Completed,
            _ => throw new ArgumentException($"Unknown quest state: {rawState}")
        };

        states[questId] = target;
        Debug.Log($"quest {questId} -> {target}");
    }
}

public enum QuestState
{
    NotStarted,
    InProgress,
    Completed
}

预期输出:选择“接受”并执行 <<quest_set herbs in_progress>> 后,Unity Console 中的关键日志为:

text
quest herbs -> InProgress

实际项目里应把示例中的字典替换为正式 QuestService,由它负责合法迁移、存档和 UI 通知。桥接层只做参数转换和调用,不要在这里顺手发奖励、开门、改背包等一串副作用,否则命令会越来越难测试。

防止重复执行造成副作用

“设置状态为进行中”天然接近幂等:重复设置同一个值通常没有额外损失;“发放 100 金币”却不是。对话可能因读档、重连或玩家重复进入而再次执行,因此奖励和一次性解锁必须由业务层检查是否已经结算。

验收时要同时看对白和任务面板:接受任务后状态立即变为进行中,重新打开对话会进入进行中分支;拒绝任务时状态不变;重复进入已处理节点也不会重复发放一次性奖励。这样叙事脚本负责“何时提出动作”,业务系统负责“动作是否允许以及如何落地”。

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

目录与阅读设置

记录一个想法

让对白推进任务状态

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

登录哪都通