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

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

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

实战应用:用在哪里

限时装备(限时称号、活动武器)到期时引擎触发 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 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

策划架构996引擎数值设计抽奖期望管理

【策划架构】十连期望:单抽与十连的保底差设计

设计初衷 单抽与十连卖的是一个奖池,买的是两种心情:单抽是概率的刺激,十连是确定的体面。数值设计要回答三问:十连的保底值多少…

2026-09-24 06:45 996 技术组
策划架构996引擎数值设计养成线裁决之杖

【策划架构】装备养成线:强化精炼铭刻的主次关系设计

设计初衷 裁决之杖能走三条养成线:强化加攻击、精炼加防御、铭刻加特殊词条。玩家资源有限,三线齐开的结果是每条都浅、战力密度稀…

2026-09-24 06:45 996 技术组
高级技巧996引擎Lua缓存LRU

【高级技巧】LRU淘汰:热身缓存的容量治理

底层原理 缓存的两难:无上限则内存失控,弱引用交给 GC 又没有容量语义(上轮弱表方案的短板正是无法承诺"最多占多少")。L…

2026-09-24 06:45 996 技术组
高级技巧996引擎Lua随机过程祖玛教主

【高级技巧】泊松到达:怪物刷新的随机间隔建模

底层原理 固定周期刷新(祖玛教主每 14400 秒一只)有个致命副作用:全程可预测。蹲点脚本掐着表守在刷新点,普通人永远抢不…

2026-09-24 06:45 996 技术组
策划架构996引擎数值设计疲劳值产能控制

【策划架构】疲劳值:日产能上限与时段定价的数值设计

设计初衷 挂机与副本的产出没有天花板时,肝帝一天刷出普通人一周的产能,经济投放失控、玩家差距撕开。疲劳值的立场不是禁止而是衰…

2026-09-24 06:45 996 技术组
进阶实战996引擎Lua定时器称号

【进阶实战】临时称号:到期回收与续期封装

业务场景 活动发"沙巴克功勋"称号,7 天有效。散装写法只发不收,到期后称号属性一直挂着,白嫖队列越排越长;补收又靠每日扫描…

2026-09-24 06:45 996 技术组