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

【引擎触发】itemexpired:装备到期触发的结算

2026-09-21 12:45 作者:996 技术组 引擎触发

实战应用:用在哪里

限时装备(限时称号、活动武器)到期时引擎触发 itemexpired:到期装备的属性剥离、视觉还原与替代方案的推送全在这一个触发里处理。到期系统的核心是让装备的消失有仪式感而非突兀地消失。

到期的结算

lua

---装备到期触发
function itemexpired(actor, item)
    local def = ITEM_DEF[item.id]
    if def.expireAction == "remove" then
        actor:RemoveEquip(item)
        sendmsg(actor, 1, item:GetName() .. " 已到期并回收")
    elseif def.expireAction == "downgrade" then
        item:SetQuality(1)
        item:StripAffixes()
        sendmsg(actor, 1, item:GetName() .. " 已到期,品质降为白色")
    end
    recalcabilitys(actor)
    QF_LogItemExpiry(actor:GetUserId(), item, os.time())
end

到期装备的两种处置:直接移除(限时活动装备)或降级为白色品质(付费限时装备),降级的方案让付费玩家保留装备框位。到期的结算立即重算属性面板,属性的变化实时反映在角色面板。

到期的缓冲

lua

---到期前的三次提醒:72小时/24小时/1小时
local REMIND_INTERVALS = { 259200, 86400, 3600 }
function checkExpiryWarnings(actor, item)
    local remaining = item.expireAt - os.time()
    for _, interval in ipairs(REMIND_INTERVALS) do
        if remaining <= interval and remaining > interval - 3600 then
            local hours = math.floor(remaining / 3600)
            sendmsg(actor, 1, item:GetName() .. " 将在 " .. hours .. " 小时后到期")
        end
    end
end

到期前的三次提醒(72 小时、24 小时、1 小时)分阶段推送,提醒的通道走邮件与客户端飘字双通道。到期后的替代方案推送:限时称号到期后推送永久称号的购买入口,商业的衔接自然而非强推。

验证与监控

到期的结算流水与属性面板的变化对账,到期后属性残留即为结算遗漏的信号。

踩坑记录

到期的结算曾经漏了附灵属性,装备移除后附灵的加成仍然生效,附灵的清理与装备移除绑定在同一事务。到期提醒的推送曾经用了固定间隔而非相对间隔,跨时区的玩家收到的时间提示不准确,相对间隔的计算修复。

上线要点

到期前的提醒间隔进配置表,不同价值的装备配不同的提醒密度。到期后的替代方案(购买入口或永久版本)在到期通知中展示,商业的衔接不留空白。到期装备的处理流水进资产审计,限时装备的发放与回收对账。

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

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

玩法策划远征编制

【玩法策划】跨服远征编制:借鉴MMO远征的分层推进方案

实战应用:用在哪里 跨服远征分先锋、主力、后勤三队独立推进,三线全通合围BOSS。不同战力成员都有参与感。 策划要点与配置 …

2026-09-22 21:15 996 技术组
案例复盘副本难度

【案例复盘】副本超时惩罚倍率复盘

实战应用:用在哪里 副本限时挑战加入超时血量惩罚:超时后BOSS攻击递增。上线后BOSS攻击叠到十倍秒杀全队。 事故还原与补…

2026-09-22 21:15 996 技术组
界面UI神兽特效

【界面UI】混沌麒麟入场特效:神兽召唤的三段演出设计

实战应用:用在哪里 混沌麒麟召唤是全服高光时刻:暗幕聚合、裂缝展开、麒麟着陆三段演出各1.3秒。 三段式入场演出编排 围观镜…

2026-09-22 21:15 996 技术组
前端接口任务回看

【前端接口】任务对话历史回看:对话记录的界面查询实现

实战应用:用在哪里 任务对话一闪而过玩家想回顾。回看接口把对话按节点存档,面板翻阅全部对话记录。 对话存档与查询渲染 当前章…

2026-09-22 21:15 996 技术组
引擎触发懒加载地图

【引擎触发】挂机地图按需激活:地图实例懒加载设计

实战应用:用在哪里 服务器承载六十张地图,空闲地图白耗资源。按需激活,末人离开后六十秒休眠。 激活与休眠触发 休眠回收 验证…

2026-09-22 21:15 996 技术组
Lua实战坐骑洗炼

【Lua实战】坐骑资质洗炼与锁定:资质系统的Lua实现

实战应用:用在哪里 坐骑资质洗炼随机重滚五条属性,锁定满意的条目不再重滚,锁定越多消耗越大。 洗炼与锁定 锁定消耗递增 验证…

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