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

整合一段完整任务对话

整合一段完整任务对话

项目级任务对话不能只把几句台词接起来,还要让门槛判断、玩家选择、场景动作、状态写入和结果反馈保持同一条因果链。本节用“护送商队”场景组装一个可验收的最小闭环。

学习目标

  • 把任务门槛、选项分支、场景命令和 Yarn 状态组织成一条完整流程。
  • 让 Unity 世界动作与 Yarn 变量更新发生在明确的顺序中。
  • 用不同前置状态验证拒绝、接受和重复交互三个结果。

先确定任务状态边界

这个示例只保留两个持久状态:$reputation 表示是否达到接任务门槛,$escort_started 表示任务是否已经接受。场景动作不承担任务真相,门是否显示、NPC 播什么动作都只是状态变化后的外在反馈。

项目变量先显式声明:

text
<<declare $reputation = 3>>
<<declare $escort_started = false>>

这些声明由 Yarn Project 编译并管理;实际项目里可以把它们集中放到专门的声明节点或脚本区域,避免同一变量散落在多个任务文件中。

把场景动作暴露为命令

创建 QuestSceneController.cs,挂到活动 GameObject QuestScene 上,并在 Inspector 中绑定队长的 Animator 和城门阻挡对象。两个命令只负责世界表现,不直接改 Yarn 变量。

csharp
using UnityEngine;
using Yarn.Unity;

public sealed class QuestSceneController : MonoBehaviour
{
    [SerializeField] private Animator captainAnimator;
    [SerializeField] private GameObject gateBlocker;

    [YarnCommand("captain_gesture")]
    public void CaptainGesture(string trigger)
    {
        // Animator 中需要存在与参数同名的 Trigger。
        captainAnimator.SetTrigger(trigger);
        Debug.Log($"captain_gesture:{trigger}");
    }

    [YarnCommand("open_gate")]
    public void OpenGate()
    {
        gateBlocker.SetActive(false);
        Debug.Log("gate:open");
    }
}

这层边界很重要:Yarn 决定“任务是否已接受”,Unity 组件决定“世界里怎么表现”。以后即使替换动画或城门实现,也不用改任务分支结构。

串起门槛、选择、动作和状态

片段示例:把下面内容放进任务节点正文。先处理“已经接过”的重复交互,再检查信誉门槛,最后才向玩家展示接受或拒绝选项。

text
<<if $escort_started>>
    Captain: 护送队已经出发,去东门集合。
    <<stop>>
<<endif>>

<<if $reputation < 3>>
    Captain: 你的信誉还不够,我不能把这条路线交给你。
    <<stop>>
<<endif>>

Captain: 东门外的商队缺一个护卫,你愿意接下这趟任务吗?

-> 接下护送任务
    <<captain_gesture QuestScene nod>>
    <<open_gate QuestScene>>
    <<set $escort_started to true>>
    Captain: 好。东门已经打开,商队会等你。
-> 暂时拒绝
    <<captain_gesture QuestScene shake>>
    Captain: 明白,准备好以后再来找我。

接受分支的执行顺序是“角色反馈 → 世界动作 → 状态写入 → 台词确认”。这样玩家看到“东门已经打开”时,场景对象已经完成变化,任务状态也已经写入。

完整任务对话从门槛判断到状态反馈的流程

用验收矩阵检查闭环

至少验证三条路径,而不是只点一次“接受任务”。

前置状态 玩家行为 预期世界动作 预期状态
$reputation = 2 进入对话 不开门,不执行姿态命令 $escort_started = false
$reputation = 3 选择接受 队长点头,城门阻挡关闭 $escort_started = true
$reputation = 3 接受后再次对话 不重复开门 $escort_started = true

接受任务时,Unity Console 的预期输出为:

text
captain_gesture:nod
gate:open

同时,对话显示“东门已经打开,商队会等你”,并且 $escort_started 变为 true。再次进入节点时应直接命中已开始分支,不再执行 open_gate。

避免状态和表现互相打架

不要先写成功台词、再执行可能失败的世界命令,否则玩家会看到“门已打开”,但场景仍被阻挡。对关键动作,先完成场景变化,再写状态和结果反馈;如果动作本身是异步过程,可以把命令实现成协程或可等待方法,让 Yarn 在动作完成后继续。

任务状态也不要只存在于场景对象里。场景重载后 gateBlocker 会重新创建,而 $escort_started 应继续代表任务已经开始。进入场景时再根据任务状态恢复门和 NPC 的表现,才能让“叙事状态”和“世界状态”在存档、切场景和重复对话后仍然一致。

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

目录与阅读设置

记录一个想法

整合一段完整任务对话

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

登录哪都通