游戏叙事与剧情 / 系统课时
节点执行器怎样决定下一步
节点执行器怎样决定下一步
节点执行器真正负责的不是“把一句话显示出来”,而是读取当前节点、执行节点语义、求值条件,并确定下一节点。把这部分决策与 UI 表现拆开后,同一份剧情数据才能同时服务于正式客户端、自动测试和剧情校验工具。
学习目标
- 建立节点解析、条件求值和后继选择的执行顺序
- 区分节点执行器与对话 UI 的职责
- 实现一个能够处理普通跳转与条件分支的最小执行器
执行器只处理剧情语义
假设当前节点是一段对话,执行器可以产出“需要展示这段文本”的结果,但不应该直接寻找文本框、播放 Tween 或等待玩家点击按钮。那些行为属于表现层。
执行层更适合处理这些事情:读取节点类型、修改剧情变量、计算分支条件、决定后继节点,以及在不存在后继节点时结束剧情。表现层则负责文本、头像、动画、音频和输入交互。
这种分工的直接收益是可测试性。测试条件分支时,只需要输入剧情状态并检查执行器选择了哪个节点,不需要启动完整游戏场景。

后继节点选择要有确定规则
最简单的线性节点只有一个 next,执行完成后直接跳转。条件节点则包含若干分支,每个分支由条件和目标节点组成。执行器应按照数据约定求值,例如按配置顺序选择第一条成立的分支,并在没有条件成立时使用显式的默认分支。
不要依赖对象遍历顺序表达业务优先级,也不要在没有默认分支时静默选择任意节点。剧情分支应当是确定性的:相同节点、相同状态和相同输入,应得到相同的后继节点。
实现一个最小节点执行器
下面的 TypeScript 示例支持两种节点:普通对话节点直接跳向 next;条件节点根据 gold 变量判断玩家金币是否达到阈值。执行器本身只返回表现事件和下一节点,不操作任何 UI。
type StoryState = {
variables: Record<string, number>;
};
type DialogueNode = {
type: "dialogue";
id: string;
text: string;
next?: string;
};
type BranchNode = {
type: "branch";
id: string;
variable: string;
minValue: number;
onTrue: string;
onFalse: string;
};
type StoryNode = DialogueNode | BranchNode;
type ExecuteResult = {
presentation?: { kind: "dialogue"; text: string };
nextNodeId?: string;
};
function executeNode(node: StoryNode, state: StoryState): ExecuteResult {
if (node.type === "dialogue") {
return {
presentation: { kind: "dialogue", text: node.text },
nextNodeId: node.next
};
}
const currentValue = state.variables[node.variable] ?? 0;
return {
nextNodeId: currentValue >= node.minValue ? node.onTrue : node.onFalse
};
}
const nodes: Record<string, StoryNode> = {
checkGold: {
type: "branch",
id: "checkGold",
variable: "gold",
minValue: 10,
onTrue: "rich",
onFalse: "poor"
},
rich: {
type: "dialogue",
id: "rich",
text: "守卫让你进入了城门。"
},
poor: {
type: "dialogue",
id: "poor",
text: "守卫拦住了你。"
}
};
const state: StoryState = { variables: { gold: 12 } };
const branchResult = executeNode(nodes.checkGold, state);
console.log(branchResult.nextNodeId);
const nextNode = nodes[branchResult.nextNodeId!];
const dialogueResult = executeNode(nextNode, state);
console.log(dialogueResult.presentation?.text);预期输出:
rich
守卫让你进入了城门。这里的条件求值依赖传入的 StoryState,所以把 gold 改成 5 后,执行器会稳定选择 poor。测试时不需要模拟按钮点击或渲染文本框。
执行与表现之间用结果对象隔离
实际项目通常不会让执行器立即连续跑完所有节点。对话、选项、过场动画等节点需要等待外部交互,因此执行器可以返回一个表现结果,由 UI 消费后再提交“继续”事件。
例如对话节点返回文本,UI 显示完成并收到玩家点击后,再允许运行上下文切换到 nextNodeId。而变量赋值、无表现条件判断等瞬时节点,可以在执行循环中连续推进,直到遇到需要等待表现层的节点或剧情结束。
无法继续时不要猜下一节点
执行器还必须明确处理三个边界:目标节点不存在、节点类型无法识别、剧情到达合法终点。前两种是数据或版本错误,应记录包含当前节点 ID 和目标 ID 的诊断信息;最后一种则是正常结束,不应当作为异常。
因此,节点执行的稳定规则可以概括为:当前节点决定“做什么”,运行状态参与“条件是否成立”,节点连接决定“去哪里”,表现层只决定“怎样给玩家看到”。把这四件事分开,后续增加任务触发、选项节点或过场节点时,执行链路仍然可以保持清晰。