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

任务设计文档写哪些字段

任务设计文档写哪些字段

任务设计文档的价值不是“把剧情写完整”,而是把策划意图转换成程序、配置和测试都能消费的交付数据。本节建立一套最小但完整的字段集合,让一个任务从目标、触发条件、节点推进到奖励、失败与最终状态都有明确落点。

学习目标

  • 确定任务设计文档中必须稳定交付的核心字段
  • 理清任务、节点、条件、奖励、失败处理与状态之间的关系
  • 用可检查的数据结构发现缺失字段和悬空引用

先把任务拆成可执行对象

一个任务至少要回答三个层面的问题:它是谁、怎样推进、最终怎样结束。只写“击败首领后获得宝物”远远不够,因为程序仍然不知道什么时候激活任务、击败哪个对象才算完成,以及失败后能否再次尝试。

建议把字段分成任务级和节点级。任务级描述整个任务的身份与生命周期,节点级描述一次具体推进动作。条件和奖励不要只写自然语言,而要尽量拆成类型与参数,方便程序读取和测试人员构造场景。

层级 核心字段 作用
任务 questId 全局稳定标识,供存档、脚本和日志引用
任务 objective 玩家看到或策划约定的最终目标
任务 startConditions 决定任务何时可以接取或自动激活
任务 initialNodeId 指定任务开始执行的第一个节点
任务 rewards 整个任务完成后统一结算的奖励
任务 failurePolicy 失败后重试、重置或永久失败的规则
任务 states 定义允许出现的生命周期状态
节点 nodeId 节点唯一标识
节点 completionConditions 当前节点完成所需条件
节点 nextNodeIds 当前节点完成后可能进入的后继节点

任务设计文档中的对象关系

字段要能被程序唯一解释

自然语言适合描述设计意图,但不适合作为唯一执行规则。例如“玩家等级较高时开放”无法直接测试,因为“较高”没有边界。交付时应把条件拆成稳定类型和明确参数,例如等级至少 10 级。

下面是一份可以直接作为策划与程序讨论基准的任务数据示例。这里重点展示字段边界,不限定具体项目必须使用 JSON 存储。

json
{
  "questId": "quest-bandit-camp",
  "objective": "击败营地首领并返回村庄",
  "startConditions": [
    {
      "type": "PLAYER_LEVEL_AT_LEAST",
      "value": 10
    }
  ],
  "initialNodeId": "reach-camp",
  "states": ["LOCKED", "ACTIVE", "COMPLETED", "FAILED"],
  "nodes": [
    {
      "nodeId": "reach-camp",
      "completionConditions": [
        {
          "type": "ENTER_AREA",
          "targetId": "bandit-camp"
        }
      ],
      "nextNodeIds": ["defeat-leader"]
    },
    {
      "nodeId": "defeat-leader",
      "completionConditions": [
        {
          "type": "KILL_TARGET",
          "targetId": "bandit-leader",
          "count": 1
        }
      ],
      "nextNodeIds": []
    }
  ],
  "rewards": {
    "gold": 500,
    "experience": 1200
  },
  "failurePolicy": "RETRY_CURRENT_NODE"
}

这份数据生效后,应满足三个可验证行为:等级不足时任务不可激活;进入营地后推进到 defeat-leader;击败指定首领后任务完成并结算奖励。实际项目可以增加对话、阵营、时间限制等字段,但不要把暂时用不到的信息预先塞进基础结构。

节点引用必须闭合

复杂任务最常见的问题不是少写一句剧情,而是出现“引用了一个不存在的节点”。例如 nextNodeIds 写成 return-village,但文档里没有对应节点,运行时就会进入无法继续的状态。

可以在交付前做一次简单的结构检查。下面的脚本验证起始节点和所有后继节点是否真实存在。

python
quest = {
    "initialNodeId": "reach-camp",
    "nodes": [
        {"nodeId": "reach-camp", "nextNodeIds": ["defeat-leader"]},
        {"nodeId": "defeat-leader", "nextNodeIds": []},
    ],
}

node_ids = {node["nodeId"] for node in quest["nodes"]}
errors = []

if quest["initialNodeId"] not in node_ids:
    errors.append(f"missing initial node: {quest['initialNodeId']}")

for node in quest["nodes"]:
    for next_id in node["nextNodeIds"]:
        if next_id not in node_ids:
            errors.append(f"{node['nodeId']} references missing node: {next_id}")

print("OK" if not errors else "\n".join(errors))

预期输出:

text
OK

如果把 defeat-leader 改成一个不存在的 ID,检查脚本应立即报告引用错误,而不是等到游戏运行后由玩家触发。

状态和失败规则要单独交付

节点描述“当前要做什么”,状态描述“整个任务现在处于什么阶段”。两者不要混成一个字段。一个常见的最小状态集合是 LOCKED、ACTIVE、COMPLETED 和 FAILED,项目需要暂停、废弃或等待选择时再扩展。

失败处理同样必须明确。限时任务超时后究竟是重试当前节点、从头重置,还是永久失败,会直接影响存档数据和测试用例。使用 RETRY_CURRENT_NODE、RESET_QUEST 这类可枚举值,比“失败后重新来”更容易落地。

一份可以交付的任务设计文档不需要字段越多越好,而要确保每个执行决策都有唯一、可验证的表达:任务用稳定 ID 定位,条件决定何时推进,节点形成闭合引用,奖励和失败规则给出明确结果,状态则记录整个任务链当前所处的位置。

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

目录与阅读设置

阅读设置

17

记录一个想法

任务设计文档写哪些字段

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

登录哪都通