游戏叙事与剧情 / 系统课时
整合一段完整任务对话
整合一段完整任务对话
项目级任务对话不能只把几句台词接起来,还要让门槛判断、玩家选择、场景动作、状态写入和结果反馈保持同一条因果链。本节用“护送商队”场景组装一个可验收的最小闭环。
学习目标
- 把任务门槛、选项分支、场景命令和 Yarn 状态组织成一条完整流程。
- 让 Unity 世界动作与 Yarn 变量更新发生在明确的顺序中。
- 用不同前置状态验证拒绝、接受和重复交互三个结果。
先确定任务状态边界
这个示例只保留两个持久状态:$reputation 表示是否达到接任务门槛,$escort_started 表示任务是否已经接受。场景动作不承担任务真相,门是否显示、NPC 播什么动作都只是状态变化后的外在反馈。
项目变量先显式声明:
<<declare $reputation = 3>>
<<declare $escort_started = false>>这些声明由 Yarn Project 编译并管理;实际项目里可以把它们集中放到专门的声明节点或脚本区域,避免同一变量散落在多个任务文件中。
把场景动作暴露为命令
创建 QuestSceneController.cs,挂到活动 GameObject QuestScene 上,并在 Inspector 中绑定队长的 Animator 和城门阻挡对象。两个命令只负责世界表现,不直接改 Yarn 变量。
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 组件决定“世界里怎么表现”。以后即使替换动画或城门实现,也不用改任务分支结构。
串起门槛、选择、动作和状态
片段示例:把下面内容放进任务节点正文。先处理“已经接过”的重复交互,再检查信誉门槛,最后才向玩家展示接受或拒绝选项。
<<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 的预期输出为:
captain_gesture:nod
gate:open同时,对话显示“东门已经打开,商队会等你”,并且 $escort_started 变为 true。再次进入节点时应直接命中已开始分支,不再执行 open_gate。
避免状态和表现互相打架
不要先写成功台词、再执行可能失败的世界命令,否则玩家会看到“门已打开”,但场景仍被阻挡。对关键动作,先完成场景变化,再写状态和结果反馈;如果动作本身是异步过程,可以把命令实现成协程或可等待方法,让 Yarn 在动作完成后继续。
任务状态也不要只存在于场景对象里。场景重载后 gateBlocker 会重新创建,而 $escort_started 应继续代表任务已经开始。进入场景时再根据任务状态恢复门和 NPC 的表现,才能让“叙事状态”和“世界状态”在存档、切场景和重复对话后仍然一致。