游戏叙事与剧情 / 系统课时
剧情提交前检查哪些内容
剧情提交前检查哪些内容
剧情编辑器里“能保存”并不等于内容“能上线”。孤立节点、永远无法到达的分支、缺失资源和写错的条件表达式,往往要到玩家实际进入剧情后才暴露。本课把提交前检查整理成可自动执行的校验链,让错误尽量在进入版本库之前被发现。
学习目标
- 建立覆盖结构、分支、资源和条件表达式的剧情提交检查项
- 区分阻止提交的错误与允许提交但需要关注的警告
- 实现一个可执行的最小校验器并读懂校验结果
先检查剧情图是否完整可达
第一层检查的是剧情结构本身。每个剧情通常至少存在一个入口节点,入口沿着分支应该能够到达预期的结束节点。编辑器中存在但从入口永远无法访问的节点,就是孤立或不可达内容。
除了不可达节点,还要检查分支目标是否真实存在。假设节点 A 的选项指向 node_b,但 node_b 已被删除,运行时就可能在玩家点击选项后中断。对于要求必须结束的剧情,还应检查是否存在没有后继关系、又未声明为结束节点的意外死路。

再检查资源引用和条件表达式
结构正确后,还要验证节点引用的外部内容。角色、立绘、语音、场景、本地化 key 只要有一个不存在,就应该给出包含节点 ID 和缺失资源 ID 的明确错误,而不是只输出“资源加载失败”。
条件表达式则需要同时验证语法和变量白名单。例如策划写成 has_key && quest_done,但系统只支持 Python 风格的 and,或者把变量名误写成 quest_dnoe,都应在提交阶段失败。不要等到运行时临时执行字符串后才发现异常。
实现一个最小提交校验器
下面的 Python 示例检查四类问题:重复节点、缺失分支目标、不可达节点和缺失资源。它使用队列从入口遍历剧情图,因此能够准确找出编辑器中存在、但玩家永远走不到的节点。
from collections import deque
STORY = {
"entry": "start",
"nodes": [
{"id": "start", "next": ["choice"], "resources": ["char.alice"]},
{"id": "choice", "next": ["good_end", "missing_end"], "resources": ["portrait.alice.happy"]},
{"id": "good_end", "next": [], "resources": ["voice.good_end"]},
{"id": "unused", "next": [], "resources": []},
],
}
RESOURCE_IDS = {
"char.alice",
"portrait.alice.happy",
"voice.good_end",
}
def validate_story(story: dict, resources: set[str]) -> list[str]:
errors: list[str] = []
nodes = story["nodes"]
node_map = {node["id"]: node for node in nodes}
if len(node_map) != len(nodes):
errors.append("duplicate node id")
entry = story["entry"]
if entry not in node_map:
return [f"missing entry node: {entry}"]
for node in nodes:
for target in node["next"]:
if target not in node_map:
errors.append(f"{node['id']}: missing target {target}")
for resource_id in node["resources"]:
if resource_id not in resources:
errors.append(f"{node['id']}: missing resource {resource_id}")
reachable: set[str] = set()
queue = deque([entry])
while queue:
node_id = queue.popleft()
if node_id in reachable or node_id not in node_map:
continue
reachable.add(node_id)
queue.extend(node_map[node_id]["next"])
for node_id in sorted(node_map.keys() - reachable):
errors.append(f"unreachable node: {node_id}")
return errors
if __name__ == "__main__":
for error in validate_story(STORY, RESOURCE_IDS):
print(error)预期输出:
choice: missing target missing_end
unreachable node: unused示例中的 missing_end 不存在,因此分支引用非法;unused 虽然保存在剧情文件中,却无法从 start 到达。三个资源引用都存在,所以不会产生资源错误。
把错误和警告分级
并不是所有检查结果都应该阻止提交。会导致运行失败、数据断链或玩家无法继续的情况,应作为错误;可能影响体验但具有合理使用场景的情况,则更适合作为警告。
| 检查结果 | 建议级别 | 原因 |
|---|---|---|
| 分支指向不存在的节点 | 错误 | 玩家到达该分支后无法继续 |
| 引用不存在的必要资源 | 错误 | 运行时无法完整加载内容 |
| 条件表达式无法解析 | 错误 | 分支判断无法执行 |
| 从入口不可达的普通节点 | 错误或警告 | 取决于项目是否允许暂存节点 |
| 某分支没有语音但语音非必需 | 警告 | 内容仍可运行,但体验可能不完整 |
| 单个节点分支数量异常多 | 警告 | 通常是可维护性问题,不一定错误 |
团队应把这些规则固化进工具配置,而不是依赖审核者个人记忆。对于允许例外的警告,还可以要求填写忽略原因,避免大家形成“看到警告就全部忽略”的习惯。
让校验进入真实提交流程
校验器最好同时存在于编辑器和持续集成流程中。编辑器提供即时反馈,让策划在提交前就能定位节点;CI 再对最终提交的数据执行同一套规则,防止脚本修改、合并冲突或绕过编辑器产生非法内容。
提交门禁至少应保证:入口存在、节点 ID 唯一、所有分支目标可解析、必要结束路径合理、资源引用有效、条件表达式合法。校验结果还应包含剧情文件、节点 ID 和具体引用值,使修复者可以直接定位问题。
当这些规则能够自动执行后,剧情审核就不必逐个点击节点寻找低级错误。人工评审可以把精力放在节奏、文本质量和设计合理性上,而结构断链、资源缺失和非法条件则由工具在提交前稳定拦截。