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

【进阶实战】建造者模式组装复杂邮件:流式封装

2026-09-24 22:22 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua建造者模式邮件组装

业务场景

赛季补偿邮件有 12 个参数:收件人、标题、正文、三段附件、有效期、来源标识——位置传参错一处就出事故:标题当正文发出去、附件串进 memo 字段,上线三个月出错 3 次。建造者模式封装:链式调用逐段设置,build 时统一校验并发送,参数按名归类不再依赖位置记忆。

核心实现

MailBuilder 链式组装器:逐段设置、build 统一校验发送。示例代码如下:

lua
local MailBuilder = {}
MailBuilder.__index = MailBuilder
function MailBuilder.new()
    return setmetatable({ to = nil, title = "", body = "",
        rewards = "", expireH = 72 }, MailBuilder)
end
function MailBuilder:to(name)
    self.to = name
    return self
end
function MailBuilder:title(t)
    self.title = t
    return self
end
function MailBuilder:body(b)
    self.body = b
    return self
end
function MailBuilder:attach(item, num)
    if self.rewards ~= "" then
        self.rewards = self.rewards .. ";" .. item .. "," .. num
    else
        self.rewards = item .. "," .. num
    end
    return self
end
function MailBuilder:build()
    assert(self.to, "收件人未设置")
    assert(self.rewards ~= "", "补偿邮件必须带附件")
    local uid = "#" .. self.to
    sendmail(uid, 0, self.title, self.body, self.rewards)
    sendmsg(getplayerbyname(self.to), 1, "补偿邮件已送达,有效期 " .. self.expireH .. " 小时。")
    return true
end

组装一份裁决之杖补偿邮件示例代码如下:

lua
MailBuilder.new()
    :to("无名小卒")
    :title("装备异常补偿")
    :body("3 月 12 日装备回滚补偿,请查收。")
    :attach("裁决之杖", 1)
    :attach("金币", 500000)
    :build()

接口拆解

sendmail(userid, id, title, memo, rewards) 的 userid 必须带 # 前缀标识玩家名,builder 在 build 内统一补齐,调用方不再记忆前缀规则。rewards 多附件用分号分隔、单件用"物品名,数量"格式,attach 方法负责拼接格式,调用方只管逐件挂。assert 双校验(收件人、附件非空)把漏设参数拦在发送前而不是发成残废邮件。

踩坑记录

邮件组装器踩过三个坑:一是链式调用漏了 build,对象只被构造未发送,调用方以为发成功了——build 改为显式必需并在 code review 清单里单列,另有打包函数把"构造到发送"包成一个调用减少漏环;二是附件超过引擎单封 10 格上限,sendmail 静默丢弃超量附件,builder 在 attach 时计数、达 10 格自动拆分成第二封延续标题;三是收件人在发送瞬间改名,#旧名 发送失败且无回执,大额补偿改走"名字换算 ID 后按 ID 发送"的通道并在 build 校验收件人在线状态。

作者履历与出处

本文由 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 阅读