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

剧情提交前检查哪些内容

剧情提交前检查哪些内容

剧情编辑器里“能保存”并不等于内容“能上线”。孤立节点、永远无法到达的分支、缺失资源和写错的条件表达式,往往要到玩家实际进入剧情后才暴露。本课把提交前检查整理成可自动执行的校验链,让错误尽量在进入版本库之前被发现。

学习目标

  • 建立覆盖结构、分支、资源和条件表达式的剧情提交检查项
  • 区分阻止提交的错误与允许提交但需要关注的警告
  • 实现一个可执行的最小校验器并读懂校验结果

先检查剧情图是否完整可达

第一层检查的是剧情结构本身。每个剧情通常至少存在一个入口节点,入口沿着分支应该能够到达预期的结束节点。编辑器中存在但从入口永远无法访问的节点,就是孤立或不可达内容。

除了不可达节点,还要检查分支目标是否真实存在。假设节点 A 的选项指向 node_b,但 node_b 已被删除,运行时就可能在玩家点击选项后中断。对于要求必须结束的剧情,还应检查是否存在没有后继关系、又未声明为结束节点的意外死路。

剧情提交前从结构到资源和条件的自动校验链

再检查资源引用和条件表达式

结构正确后,还要验证节点引用的外部内容。角色、立绘、语音、场景、本地化 key 只要有一个不存在,就应该给出包含节点 ID 和缺失资源 ID 的明确错误,而不是只输出“资源加载失败”。

条件表达式则需要同时验证语法和变量白名单。例如策划写成 has_key && quest_done,但系统只支持 Python 风格的 and,或者把变量名误写成 quest_dnoe,都应在提交阶段失败。不要等到运行时临时执行字符串后才发现异常。

实现一个最小提交校验器

下面的 Python 示例检查四类问题:重复节点、缺失分支目标、不可达节点和缺失资源。它使用队列从入口遍历剧情图,因此能够准确找出编辑器中存在、但玩家永远走不到的节点。

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)

预期输出:

text
choice: missing target missing_end
unreachable node: unused

示例中的 missing_end 不存在,因此分支引用非法;unused 虽然保存在剧情文件中,却无法从 start 到达。三个资源引用都存在,所以不会产生资源错误。

把错误和警告分级

并不是所有检查结果都应该阻止提交。会导致运行失败、数据断链或玩家无法继续的情况,应作为错误;可能影响体验但具有合理使用场景的情况,则更适合作为警告。

检查结果 建议级别 原因
分支指向不存在的节点 错误 玩家到达该分支后无法继续
引用不存在的必要资源 错误 运行时无法完整加载内容
条件表达式无法解析 错误 分支判断无法执行
从入口不可达的普通节点 错误或警告 取决于项目是否允许暂存节点
某分支没有语音但语音非必需 警告 内容仍可运行,但体验可能不完整
单个节点分支数量异常多 警告 通常是可维护性问题,不一定错误

团队应把这些规则固化进工具配置,而不是依赖审核者个人记忆。对于允许例外的警告,还可以要求填写忽略原因,避免大家形成“看到警告就全部忽略”的习惯。

让校验进入真实提交流程

校验器最好同时存在于编辑器和持续集成流程中。编辑器提供即时反馈,让策划在提交前就能定位节点;CI 再对最终提交的数据执行同一套规则,防止脚本修改、合并冲突或绕过编辑器产生非法内容。

提交门禁至少应保证:入口存在、节点 ID 唯一、所有分支目标可解析、必要结束路径合理、资源引用有效、条件表达式合法。校验结果还应包含剧情文件、节点 ID 和具体引用值,使修复者可以直接定位问题。

当这些规则能够自动执行后,剧情审核就不必逐个点击节点寻找低级错误。人工评审可以把精力放在节奏、文本质量和设计合理性上,而结构断链、资源缺失和非法条件则由工具在提交前稳定拦截。

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

目录与阅读设置

阅读设置

17

记录一个想法

剧情提交前检查哪些内容

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

登录哪都通