游戏叙事与剧情 / 系统课时
启动一段剧情要先加载什么
启动一段剧情要先加载什么
启动剧情并不是拿到第一句台词就开始播放。稳定的执行链路应先取得剧情资源,验证入口节点,再建立本次运行使用的状态上下文,最后才把入口节点交给执行器。这样才能让存档恢复、条件判断和错误处理拥有明确边界。
学习目标
- 理清剧情资源、入口节点和运行状态的初始化顺序
- 设计一个能够拒绝无效剧情资源的启动流程
- 区分静态剧情定义与本次播放产生的运行状态
启动前需要准备三类数据
剧情启动至少涉及三个对象。剧情资源描述节点以及节点之间的连接,是设计阶段产生的静态数据;入口节点决定本次从哪里开始执行;运行状态保存变量、已访问节点等会随播放变化的数据。
不要把这三者混成一个对象。例如角色好感度属于运行状态,而“节点 intro 的下一节点是 meet”属于剧情资源。前者可能从存档恢复,后者通常来自配置文件或资源包。

推荐的启动顺序
实际工程中可以把启动动作固定成一条不可跳步的管线:
- 根据剧情 ID 从资源管理器取得剧情定义。
- 检查资源是否存在,并确认入口节点 ID 非空。
- 在节点表中查找入口节点,找不到时立即终止启动。
- 创建新的运行状态,或从存档恢复已有状态。
- 把剧情定义、当前节点和运行状态组合成运行上下文。
- 将上下文交给节点执行器,正式进入节点循环。
这里最重要的原则是先验证,再改变运行状态。如果入口节点本身不存在,却已经写入“剧情已开始”或扣除了任务道具,后续失败就会留下难以回滚的半初始化状态。
用最小程序跑通初始化
下面用 TypeScript 模拟资源加载和剧情启动。示例故意不接入具体游戏引擎,只保留工程上真正需要的对象边界。
type StoryNode = {
id: string;
text: string;
};
type StoryResource = {
id: string;
entryNodeId: string;
nodes: Record<string, StoryNode>;
};
type StoryState = {
variables: Record<string, number>;
visited: Set<string>;
};
type StoryContext = {
resource: StoryResource;
state: StoryState;
currentNode: StoryNode;
};
const resources: Record<string, StoryResource> = {
prologue: {
id: "prologue",
entryNodeId: "intro",
nodes: {
intro: { id: "intro", text: "雨夜里,你来到城门前。" }
}
}
};
function loadStory(id: string): StoryResource {
const resource = resources[id];
if (!resource) {
throw new Error(`story not found: ${id}`);
}
return resource;
}
function startStory(id: string): StoryContext {
const resource = loadStory(id);
const entry = resource.nodes[resource.entryNodeId];
if (!entry) {
throw new Error(`entry node not found: ${resource.entryNodeId}`);
}
// 状态属于本次运行,不能直接写回静态剧情资源。
const state: StoryState = {
variables: {},
visited: new Set<string>()
};
return { resource, state, currentNode: entry };
}
const context = startStory("prologue");
console.log(context.resource.id);
console.log(context.currentNode.id);
console.log(context.currentNode.text);
console.log(context.state.visited.size);预期输出:
prologue
intro
雨夜里,你来到城门前。
0这段代码的关键不是 Record 或 Set 的写法,而是启动函数只在资源和入口都有效时才返回完整上下文。真正接入资源系统后,loadStory 可以改成磁盘、AssetBundle、Addressables 或服务端数据来源,而启动流程本身无需改变。
加载失败要在入口处暴露
剧情资源不存在、入口 ID 写错、节点表缺失,都属于启动阶段就能发现的问题,不应等到 UI 播放器拿到空节点后才报错。入口函数应该返回明确错误或抛出可识别异常,并让上层决定显示降级界面、终止任务还是记录日志。
如果项目支持读档,还要在恢复状态后检查存档中的当前节点是否仍存在。资源版本更新可能删除旧节点,因此“成功加载存档文件”并不等于“能够继续执行剧情”。
一个可靠的剧情启动入口最终只需要保证一件事:交给执行器的上下文中,剧情定义有效、当前节点明确、运行状态已经建立。只要这三个条件同时成立,后面的节点执行和画面表现就可以在稳定前提下继续。