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

【进阶实战】邮件合并:同类奖励邮件的合并展示封装

2026-09-24 21:15 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua邮件合并sendmail

业务场景

周末活动结算给全服 5000 人各发 3 封奖励邮件,邮件列表瞬间被 15000 封灌满,玩家列表翻三页才看完,漏领与误删集中爆发,客服工单涨了 4 成。邮件合并封装:同类奖励按 mergeKey 在 24 小时窗口内合并成一条累计数量的邮件,邮件量从 3 封降到 1 封,列表占用降 67%,标题带合计数量一眼可读。

核心实现

合并登记与窗口判定:同 key 同窗口累计数量,窗口到点或数量达限即发信。示例代码如下:

lua
local mergePool = {}
local MERGE_WINDOW = 86400
local MERGE_MAX = 10
local function queueReward(actorName, key, item, num)
    local now = os.time()
    local pool = mergePool[key]
    if pool == nil or now - pool.start > MERGE_WINDOW or pool.count >= MERGE_MAX then
        if pool and pool.count > 0 then
            flushReward(key)
        end
        mergePool[key] = { start = now, count = 0, item = item, num = 0 }
        pool = mergePool[key]
    end
    pool.count = pool.count + 1
    pool.num = pool.num + num
    if pool.count >= MERGE_MAX then
        flushReward(key)
    end
end

合并发信:窗口到点或达上限时一次性发出。示例代码如下:

lua
local function flushReward(key)
    local pool = mergePool[key]
    if pool == nil or pool.count == 0 then
        return
    end
    sendmail("#" .. key, 0, "活动奖励合并(" .. pool.count .. "次)",
        "累计获得 " .. pool.item .. " 乘 " .. pool.num .. ",请查收附件。",
        pool.item .. "," .. pool.num)
    mergePool[key] = nil
end

接口拆解

mergePool 按 mergeKey(活动标识加物品名)分池,窗口 86400 秒内同 key 累计。sendmail(userid, id, title, memo, rewards) 的 userid 必须带 # 前缀表示玩家名,rewards 用 "物品名,数量" 格式传附件;MERGE_MAX 10 次封顶防窗口内无限累积,达限即发。合并只对同类奖励,不同活动的同道具用不同 key 隔离。

踩坑记录

邮件合并踩过三个坑:一是合并后附件数量超引擎单封上限,10 次累计的 100 个道具超附件堆叠上限,发信前按堆叠上限拆分数量或降 MERGE_MAX;二是玩家在窗口中途登录翻看邮件,前几笔还在池里没发,玩家以为漏发提工单,登记成功后要发一条"奖励将于次日合并发放"的即时回执;三是两个不同活动对同一道具用同一 key,奖励被并进一封邮件后活动追踪数据全错,mergeKey 必须带活动标识,合并规则是"同活动同道具才合并"。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

【策划架构】帮会试炼场:限时挑战的门票与积分设计

设计初衷 帮会活动只有攻城与聚餐两板斧:非攻城日帮会频道冷清,成员缺乏共同目标。帮会试炼场设计:帮会自有试炼场(限时挑战波次…

2026-09-26 03:53 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】帮会会费:成员会费的收缴与公示设计

设计初衷 帮会资金靠少数大佬捐献:金主一走帮会资金断崖,普通成员没有参与感也不会珍惜帮会资源。帮会会费设计:成员按职位每周缴…

2026-09-26 03:53 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】募兵编制:帮会扩军的募兵与编制作业设计

设计初衷 帮会扩张靠熟人拉人:增长有天花板、新人质量参差、老人不愿带新。募兵编制设计:帮会发布募兵任务包(新人完成入帮任务即…

2026-09-26 03:53 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】协程超时兜底:resume与pcall的组合封装

底层原理 协程体内出错时 resume 返回 ok=false 与错误对象,但协程体若死循环则 resume 永久挂起——错…

2026-09-26 03:53 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】协程双向通信:resume传参与yield回传封装

底层原理 coroutine.resume 的实参会在协程内成为首个 yield 的返回值;coroutine.yield …

2026-09-26 03:53 996 技术组 · 0 阅读
进阶实战996引擎

【进阶实战】摆摊自动补货:摊位库存的定时补齐封装

业务场景 挂摊卖药每小时断货:玩家下线前上满货,两小时后摊位空转。摊位自动补货封装:上摊时设定补货仓库(背包或帮会仓),定时…

2026-09-26 03:53 996 技术组 · 0 阅读