【框架设计】NPC 对话树：结构化对话数据与任务联动

实战应用：用在哪里

任务 NPC 的分支对话（未接取显示引导、进行中显示进度、可交付显示完成选项）需要按玩家状态动态变化。对话树方案把对话内容做成结构化数据，节点带显示条件，脚本按玩家状态自动筛选可见分支。

数据结构与条件过滤

local DIALOG = {
    start = "root",
    nodes = {
        root = { text = "冒险者，需要帮忙吗？", options = {
            { text = "接取任务", next = "quest", cond = function(p) return not hasQuest(p, 1001) end },
            { text = "交付任务", next = "done",  cond = function(p) return questReady(p, 1001) end },
            { text = "打听消息", next = "info" },
        }},
        done = { text = "干得漂亮，奖励已经备好。", action = "giveReward" },
    },
}

-- 渲染前按条件过滤选项
for _, opt in ipairs(node.options) do
    if opt.cond and not opt.cond(player) then opt.hidden = true end
end

cond 条件引用玩家状态（等级、任务进度、好感度），未满足条件的选项对当前玩家隐藏——玩家只会看到可执行的分支。

与任务系统的联动

对话节点的 action 调用任务接口（接取、交付），任务的进度变化通过事件总线广播给红点与引导系统。三处联动：任务可接取时 NPC 头顶出现叹号（红点系统驱动）、对话中显示接取选项（对话树条件驱动）、交付后自动推进引导（事件驱动）。三处的数据源都是任务状态表，单一事实源保证三处显示一致。

维护成本

对话数据与逻辑分离后，策划改对话文案、调整分支不需要程序参与；程序新增 action 类型（发奖、开商店、传送）时注册到 action 表即可被对话引用。某项目迁移到结构化对话树后，NPC 对话的平均配置时间从 2 小时降到 20 分钟，对话相关的脚本 bug 清零。

对话树的调试工具：给 NPC 加一个调试模式开关，开启后对话渲染时显示每个选项的 cond 条件判断结果（命中或隐藏及原因），策划配置的显示条件错误当场可见。调试模式只在测试构建生效，正式包编译期剔除。对话数据的错误三类：条件写反（该显示的被隐藏）、next 指向不存在的节点、action 名未注册——三类都能在加载期静态校验出来。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。