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

【进阶实战】捐献实时榜:行会仓库捐献的即时排行封装

2026-09-24 21:15 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战996引擎Lua捐献排行行会仓库

业务场景

行会捐献月末才结算公示,平时捐多捐少无人知晓,活跃成员觉得捐了白捐。捐献实时榜封装:每次捐献即时累加进内存榜,全行会可查前 10 名,周日晚结算给前三发金条奖励,单笔捐献设 10 万金币上限防大额冲榜,把捐献从义务变成有即时反馈的竞争。

核心实现

捐献登记与周键重置:内存榜按周重置,个人累计落库。示例代码如下:

lua
local donateBoard = {}
local boardWeek = ""
local function weekKey()
    return os.date("%Y") .. "_W" .. math.ceil(tonumber(os.date("%j")) / 7)
end
local function donate(actor, amount)
    actor = getplayerbyname(actor)
    amount = tonumber(amount) or 0
    if amount <= 0 or amount > 100000 then
        sendmsg(actor, 1, "单笔捐献限 1 到 10 万金币。")
        return
    end
    if boardWeek ~= weekKey() then
        donateBoard = {}
        boardWeek = weekKey()
    end
    local name = tostring(actor)
    donateBoard[name] = (donateBoard[name] or 0) + amount
    local total = tonumber(getplayvar(actor, "HUMAN", "DonateTotal")) or 0
    setplayvar(actor, "HUMAN", "DonateTotal", total + amount, 1)
    sendmsg(actor, 1, "捐献 " .. amount .. " 金币,本周累计 " .. donateBoard[name] .. "。")
end

榜单查询与周奖发放示例代码如下:

lua
local function showBoard(actorName)
    local actor = getplayerbyname(actorName)
    local rows = {}
    for name, amt in pairs(donateBoard) do
        if amt > 0 then
            rows[#rows + 1] = { name = name, amt = amt }
        end
    end
    table.sort(rows, function(a, b)
        return a.amt > b.amt
    end
    )
    for i = 1, math.min(10, #rows) do
        sendmsg(actor, 1, "第" .. i .. "名 " .. rows[i].name .. " 捐 " .. rows[i].amt .. " 金币")
    end
end

接口拆解

donateBoard 内存表按 weekKey 换周清零,历史累计走 setplayvar(actor, "HUMAN", "DonateTotal", 值, 1) 落库,重启不丢个人数据。单笔上限 10 万在入口拦截,防大额冲榜把榜值撑爆。table.sort 配降序比较器排名,展示前 10 名并过滤零捐献条目,pairs 出来的 0 值行不再占聊天框。

踩坑记录

捐献实时榜踩过三个坑:一是榜单纯内存,服务器重启后榜值归零,周日晚结算前一次重启让全行会白捐,榜值变更时同步写一份快照到全局变量,重启后从快照恢复;二是换周瞬间(周日晚 23:59:59 捐入、周一 0:00:01 查询)旧榜数据跨周残留,weekKey 在登记与查询两处都做比对,不一致先清再算;三是同名字玩家改名后榜上旧名变成孤儿条目,新名字重新从零累计,改名钩子里要把旧榜值迁移到新名下。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026-09-26 03:53 996 技术组