【框架设计】帮派 BOSS：伤害排名与奖励分发

实战应用：用在哪里

帮派 BOSS 每周开启两次，全帮集结输出，按伤害排名发奖，是检验帮派凝聚力的周常活动。传奇引擎里 BOSS 血量动辄上亿，伤害统计要按实时增量累计，结算时排名发放，容不得并发漏记，少记一次伤害就是一场帮派纠纷。

伤害累计

function GuildBoss.onDamage(plr, dmg)
    local gb = guildBoss
    if not gb or gb.state ~= "fight" then return end
    gb.hp = math.max(0, gb.hp - dmg)
    local rec = gb.dmgBoard[plr.id]
    if not rec then
        rec = { total = 0, hits = 0 }
        gb.dmgBoard[plr.id] = rec
    end
    rec.total = rec.total + dmg
    rec.hits = rec.hits + 1
    if gb.hp <= 0 then GuildBoss.settle() end
end

每人一条伤害记录，增量累加不重算，60 人同屏输出的结算开销保持在毫秒级。BOSS 血量归零即刻结算，结算函数加状态锁防二次触发，state 从 fight 切到 settle 后再来的伤害直接丢弃。

排名与发放

function GuildBoss.settle()
    guildBoss.state = "settle"
    local rank = {}
    for pid, rec in pairs(guildBoss.dmgBoard) do
        rank[#rank + 1] = { id = pid, dmg = rec.total }
    end
    table.sort(rank, function(a, b) return a.dmg > b.dmg end)
    for i, rec in ipairs(rank) do
        local reward = i <= 3 and BOSS_REWARD.top or BOSS_REWARD.normal
        QF_MailItems(rec.id, reward.items, "帮派BOSS 第" .. i .. "名")
    end
end

前三名拿稀有材料，参与奖保底人人有份，全部走邮件异步发放。伤害榜实时推送到帮派面板，客户端用 SL 排行控件渲染前 10 名，名次跳动实时可见，击杀瞬间全帮播放庆祝特效，截屏分享率极高。伤害占比低于 1% 的参与者标记划水，帮主后台可见，管理工具交到会长手里。

验证与监控

伤害总和与 BOSS 扣血量每周核对，差值超过 0.1% 即排查统计链路。

踩坑记录

BOSS 血量上亿的展示曾经用整数直出，九位数在界面上换行显示，界面改造时顺手做了万进制缩写。参与奖的邮件标题统一带名次，玩家从邮箱列表一眼看到自己的产出，打开率翻倍。伤害占比的实时榜曾经 5 秒刷一次，大帮内部开始内卷抢榜，改成 15 秒一刷后数据仍在而焦虑减半。周常活动的奖励通胀与行会资金盘联动监控，一个 BOSS 奖励的调档会传导到经济报表，联动意识比调参本身重要。BOSS 的刷新时间做过一次玩家投票，晚间八点半以微弱优势胜过九点，投票参与本身也成了活动预热。伤害统计的客户端展示与服务器结算偶尔有秒级误差，官方口径说明以结算为准的提示放在伤害榜底部。奖励的分档边界画在第三名与第十名，边界玩家的激励设计是运营的功夫，第四名到第十名的差距奖励只差一个宝箱位，够得着的差距才是健康的竞争。BOSS 的刷新时间做过一次玩家投票，晚间八点半以微弱优势胜过九点，投票参与本身也成了活动预热。伤害统计的客户端展示与服务器结算偶尔有秒级误差，官方口径说明以结算为准的提示放在伤害榜底部。奖励的分档边界画在第三名与第十名，边界玩家的激励设计是运营的功夫，第四名到第十名的差距奖励只差一个宝箱位，够得着的差距才是健康的竞争。

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