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

对话数据怎样支持角色与选项

对话数据怎样支持角色与选项

一条对话不只是“角色说一句话”。程序还要知道谁在说、显示什么文本、有哪些可选项、哪些选项此刻可见,以及选择后跳到哪里。本课把这些信息拆成稳定的数据边界,并用一个可运行的小例子验证运行时如何消费它们。

学习目标

  • 能把说话人、文本、选项、条件和表现资源拆成职责清晰的数据字段
  • 能设计可被运行时直接消费的选项结构,而不是把业务逻辑写进文案
  • 能判断哪些信息属于剧情逻辑,哪些只属于 UI 与音画表现

从运行时需要反推数据结构

对话数据首先服务运行时,而不是服务表格排版。一个可落地的节点至少要回答五个问题:当前节点是谁说的、说什么、怎样表现、玩家能选什么、选择后去哪里。

信息 推荐职责 不建议做法
speakerId 引用角色定义 直接重复角色姓名、头像路径等整套资料
text 当前对白文本 在文本里混入跳转指令
presentation 头像、语音、表情等表现资源 让资源缺失改变剧情分支
options 玩家可选项集合 仅保存显示文案,不保存稳定选项标识
conditions 声明选项可见条件 塞入任意脚本字符串
nextNodeId 指向下一节点 用数组下标充当长期引用

对话节点从数据到运行时的消费关系

下面的数据已经能让策划直接读懂,同时让程序不必猜测字段含义。这里的 presentation 即使缺少资源,也不应阻止主对话逻辑继续执行。

json
{
  "nodeId": "dialogue.guard.gate.001",
  "speakerId": "character.guard",
  "text": "城门已经关闭,你有什么事?",
  "presentation": {
    "portraitAssetId": "portrait.guard.neutral",
    "voiceAssetId": "voice.guard.gate.001"
  },
  "options": [
    {
      "optionId": "ask_reason",
      "text": "为什么关闭城门?",
      "conditions": [],
      "nextNodeId": "dialogue.guard.gate.002"
    },
    {
      "optionId": "show_pass",
      "text": "出示通行证",
      "conditions": [
        {
          "type": "flag_equals",
          "key": "has_gate_pass",
          "value": true
        }
      ],
      "nextNodeId": "dialogue.guard.gate.010"
    }
  ]
}

这类结构的验证重点不是“JSON 能否解析”,而是引用和规则是否完整。例如 speakerId 必须能找到角色定义,nextNodeId 必须指向真实节点,条件类型也必须属于运行时支持的白名单。

让条件保持声明式

条件最好表达“要检查什么”,而不是“执行一段什么代码”。例如 flag_equals、quest_state_is、inventory_contains 都可以由运行时统一解释;如果直接把 player.flags['x'] && ... 之类脚本放进数据,编辑器校验、跨平台执行和安全审查都会变困难。

下面的 Python 示例模拟运行时过滤可见选项。它只支持一种条件类型,便于看清核心边界。

python
def condition_matches(condition, context):
    if condition["type"] == "flag_equals":
        return context["flags"].get(condition["key"]) == condition["value"]
    raise ValueError(f"unsupported condition type: {condition['type']}")

def visible_options(node, context):
    result = []
    for option in node["options"]:
        if all(condition_matches(c, context) for c in option["conditions"]):
            result.append((option["optionId"], option["text"], option["nextNodeId"]))
    return result

node = {
    "options": [
        {
            "optionId": "ask_reason",
            "text": "为什么关闭城门?",
            "conditions": [],
            "nextNodeId": "dialogue.guard.gate.002",
        },
        {
            "optionId": "show_pass",
            "text": "出示通行证",
            "conditions": [
                {
                    "type": "flag_equals",
                    "key": "has_gate_pass",
                    "value": True,
                }
            ],
            "nextNodeId": "dialogue.guard.gate.010",
        },
    ]
}
context = {"flags": {"has_gate_pass": True}}

for option_id, text, next_node_id in visible_options(node, context):
    print(f"{option_id} -> {text} -> {next_node_id}")

预期输出:

text
ask_reason -> 为什么关闭城门? -> dialogue.guard.gate.002
show_pass -> 出示通行证 -> dialogue.guard.gate.010

把 has_gate_pass 改成 False 后,第二个选项会被过滤,但数据本身不需要改写。这样条件系统和剧情内容可以独立演进。正式加载时还可以按 nodeId、speakerId 建立哈希索引,跳转和角色查询都直接按 ID 定位,避免每次对话都线性扫描整份数据。

选项需要稳定标识而不只是文案

选项文本会频繁润色,因此日志、埋点、存档和条件回溯都不应使用显示文案作为键。optionId 应在节点内保持稳定,文案改成“给守卫看通行证”时,既有埋点仍然能识别这是同一个选择。

nextNodeId 也比“跳到第 3 项”稳定。数组顺序只是编辑器展示顺序,一旦策划插入新节点,基于下标的引用就可能悄悄跳错目标。

把表现资源放在可降级层

头像、语音、立绘和特效通常会晚于剧情逻辑完成,因此应允许这些资源为空或加载失败。运行时可以回退到默认头像、纯文本或无语音模式,但不应因为一个 voiceAssetId 失效就阻塞分支选择。

对话数据真正需要稳定的是“身份、条件和跳转”。表现资源可以丰富体验,却不应成为剧情正确性的前提。只要这条边界明确,策划可读性、资源迭代和运行时效率就能同时兼顾。

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

目录与阅读设置

阅读设置

17

记录一个想法

对话数据怎样支持角色与选项

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

登录哪都通