游戏叙事与剧情 / 系统课时
任务设计文档写哪些字段
任务设计文档写哪些字段
任务设计文档的价值不是“把剧情写完整”,而是把策划意图转换成程序、配置和测试都能消费的交付数据。本节建立一套最小但完整的字段集合,让一个任务从目标、触发条件、节点推进到奖励、失败与最终状态都有明确落点。
学习目标
- 确定任务设计文档中必须稳定交付的核心字段
- 理清任务、节点、条件、奖励、失败处理与状态之间的关系
- 用可检查的数据结构发现缺失字段和悬空引用
先把任务拆成可执行对象
一个任务至少要回答三个层面的问题:它是谁、怎样推进、最终怎样结束。只写“击败首领后获得宝物”远远不够,因为程序仍然不知道什么时候激活任务、击败哪个对象才算完成,以及失败后能否再次尝试。
建议把字段分成任务级和节点级。任务级描述整个任务的身份与生命周期,节点级描述一次具体推进动作。条件和奖励不要只写自然语言,而要尽量拆成类型与参数,方便程序读取和测试人员构造场景。
| 层级 | 核心字段 | 作用 |
|---|---|---|
| 任务 | questId |
全局稳定标识,供存档、脚本和日志引用 |
| 任务 | objective |
玩家看到或策划约定的最终目标 |
| 任务 | startConditions |
决定任务何时可以接取或自动激活 |
| 任务 | initialNodeId |
指定任务开始执行的第一个节点 |
| 任务 | rewards |
整个任务完成后统一结算的奖励 |
| 任务 | failurePolicy |
失败后重试、重置或永久失败的规则 |
| 任务 | states |
定义允许出现的生命周期状态 |
| 节点 | nodeId |
节点唯一标识 |
| 节点 | completionConditions |
当前节点完成所需条件 |
| 节点 | nextNodeIds |
当前节点完成后可能进入的后继节点 |

字段要能被程序唯一解释
自然语言适合描述设计意图,但不适合作为唯一执行规则。例如“玩家等级较高时开放”无法直接测试,因为“较高”没有边界。交付时应把条件拆成稳定类型和明确参数,例如等级至少 10 级。
下面是一份可以直接作为策划与程序讨论基准的任务数据示例。这里重点展示字段边界,不限定具体项目必须使用 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,但文档里没有对应节点,运行时就会进入无法继续的状态。
可以在交付前做一次简单的结构检查。下面的脚本验证起始节点和所有后继节点是否真实存在。
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))预期输出:
OK如果把 defeat-leader 改成一个不存在的 ID,检查脚本应立即报告引用错误,而不是等到游戏运行后由玩家触发。
状态和失败规则要单独交付
节点描述“当前要做什么”,状态描述“整个任务现在处于什么阶段”。两者不要混成一个字段。一个常见的最小状态集合是 LOCKED、ACTIVE、COMPLETED 和 FAILED,项目需要暂停、废弃或等待选择时再扩展。
失败处理同样必须明确。限时任务超时后究竟是重试当前节点、从头重置,还是永久失败,会直接影响存档数据和测试用例。使用 RETRY_CURRENT_NODE、RESET_QUEST 这类可枚举值,比“失败后重新来”更容易落地。
一份可以交付的任务设计文档不需要字段越多越好,而要确保每个执行决策都有唯一、可验证的表达:任务用稳定 ID 定位,条件决定何时推进,节点形成闭合引用,奖励和失败规则给出明确结果,状态则记录整个任务链当前所处的位置。