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

设计剧情节点与连接关系

设计剧情节点与连接关系

剧情一旦出现选择、条件和回流,单纯把“下一句是谁”写在节点里就会迅速失控。本节建立统一的节点与连接模型,让线性剧情和分支剧情使用同一种结构,并在加载阶段就发现重复 ID、悬空连接和不合法出口。

学习目标

  • 设计能同时表达线性与分支路径的节点、边数据结构
  • 为节点建立稳定且可校验的唯一标识
  • 在数据进入运行时前验证连接完整性和出口规则

节点负责内容,连接负责去向

最常见的早期设计,是在每个节点里直接写一个 nextNodeId。它对线性剧情很方便,但一旦加入二选一、条件分支或失败出口,就会不断出现 nextNodeId、successNextId、failNextId、optionNextIds 等字段,数据结构会被节点类型拖着走。

更稳定的做法是把“节点”和“连接”拆开。节点只描述本节点是什么、需要哪些业务数据;连接单独描述从哪个节点出发、到哪个节点,以及这条边在什么条件或端口下成立。线性剧情只是“每个节点恰好有一条默认边”的特例。

剧情节点与连接关系结构图

用统一结构表达节点和边

下面示例用一组节点和一组边表达剧情图,并在加载时校验 ID 与引用关系。port 用来描述边从哪个语义出口离开节点,而不是把不同分支字段硬编码进节点公共结构。

ts
type NodeType = "dialogue" | "choice" | "condition" | "end";

interface NarrativeNode {
  id: string;
  type: NodeType;
  data: Record<string, unknown>;
}

interface NarrativeEdge {
  from: string;
  to: string;
  port: string;
}

interface NarrativeGraph {
  startNodeId: string;
  nodes: NarrativeNode[];
  edges: NarrativeEdge[];
}

function validateGraph(graph: NarrativeGraph): string[] {
  const errors: string[] = [];
  const ids = new Set<string>();

  for (const node of graph.nodes) {
    if (ids.has(node.id)) {
      errors.push(`duplicate node id: ${node.id}`);
    }
    ids.add(node.id);
  }

  if (!ids.has(graph.startNodeId)) {
    errors.push(`missing start node: ${graph.startNodeId}`);
  }

  for (const edge of graph.edges) {
    if (!ids.has(edge.from)) {
      errors.push(`edge source not found: ${edge.from}`);
    }
    if (!ids.has(edge.to)) {
      errors.push(`edge target not found: ${edge.to}`);
    }
  }

  return errors;
}

const graph: NarrativeGraph = {
  startNodeId: "dialogue-01",
  nodes: [
    { id: "dialogue-01", type: "dialogue", data: { text: "要接任务吗?" } },
    { id: "choice-01", type: "choice", data: { options: ["accept", "decline"] } },
    { id: "quest-accepted", type: "end", data: { result: "accepted" } },
    { id: "end-declined", type: "end", data: { result: "declined" } }
  ],
  edges: [
    { from: "dialogue-01", to: "choice-01", port: "default" },
    { from: "choice-01", to: "quest-accepted", port: "accept" },
    { from: "choice-01", to: "end-declined", port: "decline" }
  ]
};

console.log(validateGraph(graph));

预期输出

text
[]

空数组表示基础结构校验通过。实际项目还应继续验证节点类型自己的规则,例如 choice 节点是否至少存在两个合法出口,但这类规则应建立在同一套图结构之上。

唯一标识必须脱离显示文本

节点 ID 不应由对白文本、编辑器坐标或数组下标临时生成。文本会被本地化,坐标会被拖动,数组顺序会被重新保存;如果这些变化导致 ID 改变,存档、测试快照和外部任务引用都会失效。

工程上可以使用 UUID、ULID,或由编辑器创建时生成的稳定字符串。关键要求只有两个:同一剧情资源内不能重复,节点内容修改时 ID 不能无故变化。运行时和存档应引用 ID,而不是依赖“第几个节点”。

给连接规则加上可验证约束

只有“from 和 to 都存在”还不够。不同节点类型通常有不同出口约束:普通对白通常只有一个 default 出口;选择节点的 port 应对应某个选项;终止节点不应再有出边。把这些规则放在导入或构建阶段,比运行到半小时后才发现死路更容易定位。

可以把验证分成三层:结构层检查重复 ID 与悬空引用;类型层检查节点自己的必填数据;图层检查不可达节点、非法出口和是否存在预期终点。这样错误信息能准确告诉内容作者“哪一个节点、哪一条边、违反了什么规则”。

线性与分支不需要两套模型

当连接被独立建模后,线性路径只是每个非终点节点只有一条可用边;分支路径只是某些节点拥有多条带不同 port 的边。运行时只需根据当前节点执行结果选择一个出口,再从边表中找到目标节点,不必维护两套跳转逻辑。

这个结构还为后续条件表达式、任务状态、编辑器可视化和静态检查保留了扩展空间。真正需要守住的边界是:节点描述“发生什么”,连接描述“接下来去哪”,稳定 ID 负责让两者可以被可靠引用。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计剧情节点与连接关系

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

登录哪都通