CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
后端接口任务对话

【后端接口】任务对话分支:前置条件校验与选项跳转的接口

2026-09-22 08:12 作者:996 技术组 996引擎Lua教程传奇脚本后端接口任务对话

实战应用:用在哪里

屠夫的任务对话挂着三个选项:接取委托、打听线索、兑换奖励,每个选项都有前置条件,条件不满足的选项要置灰而不是点了报错。对话分支做成数据驱动的校验接口,策划加选项不动代码。

选项与条件的声明表

每个选项声明前置条件类型与参数,框架渲染时逐条校验,全过才可点击。

lua
local DIALOG = {
    { text = "接取屠夫委托", cond = { { "level", 25 }, { "item", "野牛肉", 0 } }, next = 101 },
    { text = "打听野人线索", cond = { { "level", 25 } }, next = 102 },
    { text = "兑换战利品",   cond = { { "item", "野牛肉", 10 } }, next = 103 },
}
local function checkCond(actor, cond)
    local player = class(actor)
    for _, c in ipairs(cond) do
        if c[1] == "level" and getbaseinfo(actor, 6) < c[2] then
            return false
        end
        if c[1] == "item" and c[3] > 0 and player:checkitemw(c[2], c[3]) == false then
            return false
        end
    end
    return true
end

分支跳转与状态推进

点击合法选项后跳转目标段落并写入任务变量,条件类选项在通过时扣减材料。

lua
function onPickOption(actor, idx)
    local opt = DIALOG[idx]
    if opt == nil or not checkCond(actor, opt.cond) then
        sendmsg(actor, 0, "暂时无法选择该项")
        return
    end
    local c = opt.cond[2]
    if c ~= nil and c[1] == "item" and c[3] > 0 then
        class(actor):takeitem(c[2], c[3])
    end
    setplayvar(actor, "HUMAN", "QUEST_NODE", opt.next, 1)
    sendmsg(actor, 0, "任务推进到节点" .. opt.next)
end

验证与监控

测试号覆盖低级、缺材料、正常三条路径,验证置灰与推进。上线后统计各选项点击分布,兑换选项占比低于一成说明奖励吸引力不足,反馈数值组。

踩坑记录

checkitemw第三参数是数量,传零时部分版本按不检查处理,材料类条件必须带正数,写零的判断永远为真。条件表里的等级用getbaseinfo(actor,6)读,字段编号含义以站点apidb为准,抄别处脚本前先核对。takeitem在材料不足时静默失败,校验与扣减要贴在同一函数内连续执行,中间插入其他逻辑会引入竞态。对话选项数量超过九个后界面放不下,声明表加条数上限,超限在启动时报错而不是渲染截断。

作者履历与出处

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

← 返回文章地图返回研学路径

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

玩法策划悬赏赏金防刷

【玩法策划】悬赏捕杀:悬赏发布与赏金结算

实战应用:用在哪里 悬赏捕杀把玩家之间的恩怨变成可托付的系统行为:仇家难以亲自复仇时,花费金条发布悬赏,全服玩家接单击杀目标…

2026-09-23 10:18 996 技术组
工具链配表校验引用

【工具链】配表校验器:数值边界与引用完整性

实战应用:用在哪里 策划改表是日常动作,漏填字段、引用了不存在的编号、数值越界这三类问题占了配表故障的绝大多数。等玩家报错再…

2026-09-23 10:18 996 技术组
后端接口行会擂台结算

【后端接口】行会擂台:守擂判定的接口实现

实战应用:用在哪里 行会擂台给中小行会提供了固定的对抗出口:挑战方击败守擂方后接管擂台,连胜次数决定每日结算奖励档位。接口层…

2026-09-23 10:18 996 技术组
Lua实战二叉堆排行榜伤害

【Lua实战】二叉堆:伤害排行榜的有序插入

实战应用:用在哪里 世界首领战里玩家最关心的是伤害前十名:榜单要求随时插入、随时能按序取出,每来一条伤害记录都重新排序一次太…

2026-09-23 10:18 996 技术组
网络通信九宫格视野广播

【网络通信】九宫格视野:同屏广播的范围控制

实战应用:用在哪里 百人同屏的攻城战里,把每条移动、施法消息广播给全地图是最常见的性能失误。九宫格视野的做法是把地图切成等大…

2026-09-23 10:18 996 技术组
安全加密输入校验注入拦截

【安全加密】入库防护:玩家输入的参数校验与拦截

实战应用:用在哪里 留言板、行会招募语、邮件标题这类字段会被玩家自由填写,并写入角色变量或转发给持久层。拼接式的写法一旦遇到…

2026-09-23 10:18 996 技术组