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

【后端接口】药品冷却分组:共享冷却与独立冷却的接口管理

2026-09-23 17:01 作者:996 技术组 996引擎Lua教程传奇脚本

实战应用:用在哪里

金创药与魔法药如果各自独立冷却,打架时交替嗑药就是无限续航;同组共享五秒冷却才是设计意图。药品冷却分组接口管两类规则:同组共享冷却、特效药品独立计时,策划调参数不进代码。

分组表的冷却校验

喝药入口按药品名查分组表,组内任一成员刚使用过则拒绝,剩余秒数提示。actor是字符串,转对象后读写冷却戳。

lua
local CD_GROUP = {
    hp = { items = { "金创药", "强效金创药" }, cd = 5 },
    mp = { items = { "魔法药", "强效魔法药" }, cd = 5 },
    sp = { items = { "太阳水" }, cd = 3 },
}
local function groupOf(name)
    for g, cfg in pairs(CD_GROUP) do
        for _, n in ipairs(cfg.items) do
            if n == name then return g, cfg.cd end
        end
    end
    return nil, 0
end
function useDrug(actor, name)
    local player = class(actor)
    local g, cd = groupOf(name)
    if g == nil then return end
    local last = tonumber(getplayvar(actor, 2, "DRUG_CD_" .. g) or "0")
    local wait = cd - (os.time() - last)
    if wait > 0 then
        sendmsg(actor, 0, "药效发挥作用中," .. wait .. "秒后再试")
        return
    end
    setplayvar(actor, "HUMAN", "DRUG_CD_" .. g, os.time(), 1)
end

特效药的独立计时

太阳水走独立组,与血药互不干扰,急救combo由策划在分组表里自由编排。

lua
function grantSpecialDrug(actor)
    local player = class(actor)
    giveitem(actor, "太阳水", 3)
    setplayvar(actor, "HUMAN", "SP_UNLOCK", 1, 1)
    sendmsg(actor, 0, "获得太阳水3瓶,独立冷却3秒")
end

验证与监控

测试连嗑验证组内五秒共享、跨组互不影响;太阳水三秒独立计时单独回归。线上统计嗑药频率分布,头部玩家每秒超过一条说明有连点宏,转风控复核。

踩坑记录

DRUG_CD键按组拼接,新增分组要同步加键前缀规范,键名失控的账本前一篇文章刚吃过亏。冷却戳存的是上次使用时间而非到期时间,换算剩余秒数时跨天为正数误判可用,用os.time差值加下限校验。药品改名后分组表失配,物品库改名流程必须带上分组表同步。checkitemw式的持有校验在喝药接口不适用,喝药由物品使用触发,入口参数是药品名,别照抄背包校验模板。

作者履历与出处

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

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

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

LATEST ARTICLES

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

引擎触发猪洞七层白野猪巡回

【引擎触发】猪洞七层:白野猪的巡回触发设计

实战应用:用在哪里 猪洞七层的白野猪是中级玩家的过渡首领,巡回触发让它在三层地图间按路线巡逻,而非固定在一个点位被反复蹲守。…

2026-09-23 22:15 996 技术组
玩法策划行会目标集体目标达成

【玩法策划】行会目标系统:行会集体目标的设定与达成

实战应用:用在哪里 行会活动零散且缺乏组织性,成员不知道这周行会要做什么。行会目标系统让帮主每周设定行会集体目标(击杀指定首…

2026-09-23 22:15 996 技术组
工具链GM审计台审计回放

【工具链】GM 审计台:操作留痕的查询与回放

实战应用:用在哪里 GM 操作的审计曾散落在各系统日志里,追查一次误操作需要跨三个日志文件。GM 审计台将所有 GM 操作集…

2026-09-23 22:15 996 技术组
界面UI背包筛选器筛选过滤

【界面UI】背包筛选器:按品质与类型的快速过滤

实战应用:用在哪里 背包一百格塞满后找一件药要翻三页。背包筛选器在背包面板顶部加一排筛选标签:按品质(白绿紫橙)与类型(药品…

2026-09-23 22:15 996 技术组
网络通信区域组播组播投递

【网络通信】区域组播:按地图分组的消息投递

实战应用:用在哪里 行会广播、地图公告、活动提醒需要发给特定地图的所有玩家,逐个发送时包量随人数线性增长。区域组播按地图分组…

2026-09-23 22:15 996 技术组
运维发布故障分级响应时限

【运维发布】故障分级响应:从P0到P3的处置时限

实战应用:用在哪里 凌晨三点的数据库主从延迟和下午三点的聊天频道延迟,影响的范围和紧急度截然不同,但响应流程曾一模一样。故障…

2026-09-23 22:15 996 技术组