游戏叙事与剧情 / 系统课时
一句对话怎样推进一个任务
一句对话怎样推进一个任务
“玩家说完这句话,任务就前进一步”看起来只是一次状态修改,但真正的工程问题是如何把剧情动作稳定映射为任务命令,并保证重复触发、条件不满足或顺序错误时不会把任务状态写坏。本节用一个可运行的 C# 示例完成这条链路。
学习目标
- 把剧情节点中的任务动作映射为接取、推进、完成和失败四类明确命令。
- 在任务系统内校验当前状态,避免剧情脚本直接篡改任务对象。
- 用动作 ID 做幂等保护,使重复进入节点时不会重复推进同一任务。
让剧情发命令,而不是改任务字段
不要让剧情脚本写出 quest.Progress++ 或 quest.State = Completed。这种写法绕过了任务系统自己的条件校验,后续一旦加入前置任务、目标计数、失败状态或存档恢复,剧情侧就会不断复制业务规则。
更合适的边界是:剧情节点声明“要执行什么任务动作”,任务系统负责判断这个动作当前能不能生效。常用动作可以收敛成 Accept、Advance、Complete、Fail 四类,动作中至少携带任务 ID 和唯一动作 ID。

定义动作并集中执行
下面的示例把一句对话节点携带的 QuestAction 交给 QuestService。服务内部维护状态规则,并用 ActionId 去重。这样即使节点因为读档、回退或脚本重入被执行两次,同一个动作也只生效一次。
using System;
using System.Collections.Generic;
public enum QuestState
{
NotStarted,
InProgress,
Completed,
Failed
}
public enum QuestActionType
{
Accept,
Advance,
Complete,
Fail
}
public sealed record QuestAction(
string ActionId,
string QuestId,
QuestActionType Type,
int Amount = 1);
public sealed class Quest
{
public string Id { get; }
public QuestState State { get; set; } = QuestState.NotStarted;
public int Progress { get; set; }
public Quest(string id) => Id = id;
}
public sealed class QuestService
{
private readonly Dictionary<string, Quest> _quests = new();
private readonly HashSet<string> _handledActionIds = new();
public QuestService(IEnumerable<Quest> quests)
{
foreach (var quest in quests)
{
_quests[quest.Id] = quest;
}
}
public bool Apply(QuestAction action)
{
if (_handledActionIds.Contains(action.ActionId))
{
return false;
}
if (!_quests.TryGetValue(action.QuestId, out var quest))
{
throw new InvalidOperationException($"Unknown quest: {action.QuestId}");
}
var applied = true;
switch (action.Type)
{
case QuestActionType.Accept when quest.State == QuestState.NotStarted:
quest.State = QuestState.InProgress;
break;
case QuestActionType.Advance when quest.State == QuestState.InProgress:
quest.Progress += action.Amount;
break;
case QuestActionType.Complete when quest.State == QuestState.InProgress:
quest.State = QuestState.Completed;
break;
case QuestActionType.Fail when quest.State == QuestState.InProgress:
quest.State = QuestState.Failed;
break;
default:
// 状态不允许时拒绝该动作,不让剧情脚本越权修改任务。
applied = false;
break;
}
if (applied)
{
_handledActionIds.Add(action.ActionId);
}
return applied;
}
public Quest Get(string questId) => _quests[questId];
}
public static class Program
{
public static void Main()
{
var service = new QuestService(new[] { new Quest("quest-find-herbs") });
var actions = new[]
{
new QuestAction("dlg-001-accept", "quest-find-herbs", QuestActionType.Accept),
new QuestAction("dlg-002-progress", "quest-find-herbs", QuestActionType.Advance, 1),
new QuestAction("dlg-002-progress", "quest-find-herbs", QuestActionType.Advance, 1),
new QuestAction("dlg-003-complete", "quest-find-herbs", QuestActionType.Complete)
};
foreach (var action in actions)
{
Console.WriteLine($"{action.ActionId}: applied={service.Apply(action)}");
}
var quest = service.Get("quest-find-herbs");
Console.WriteLine($"state={quest.State}, progress={quest.Progress}");
}
}预期输出:
dlg-001-accept: applied=True
dlg-002-progress: applied=True
dlg-002-progress: applied=False
dlg-003-complete: applied=True
state=Completed, progress=1第三个动作与第二个动作使用同一个 ActionId,因此被识别为重复触发,没有让进度从 1 变成 2。这个保护在“节点进入事件可能重放”的剧情系统里很重要。
把节点配置成数据,而不是硬编码分支
实际项目通常不会在代码里写死“进入某节点就推进某任务”,而是在剧情数据中挂动作。例如一个节点可以描述:显示台词后,执行 Advance,目标任务为 quest-find-herbs,步进值为 1。
配置只是声明意图,真正执行仍要进入统一的 QuestService.Apply。这样策划可以调整映射关系,程序侧仍能保证状态机、幂等和错误处理不被绕过。
一个节点也可能挂多个动作,例如同时推进主线并设置世界标记。此时要明确执行顺序以及“前一个失败后是否继续”。如果这些动作必须同成同败,就不能只靠顺序循环,应提升为事务式剧情动作批次,并设计回滚或预校验。
区分重复触发与非法状态
幂等失败和状态失败不是一回事。重复的 ActionId 说明同一业务动作已经处理过,通常可以安静忽略;而在 NotStarted 状态直接收到 Complete,更像脚本配置错误,应记录任务 ID、动作类型和剧情节点,方便定位。
一句对话要可靠地推动任务,关键不是在节点里多写一个回调,而是把“剧情意图”和“任务状态规则”分开:剧情只声明动作,任务系统验证并落状态,再用稳定动作 ID 抵御重复执行。