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

【进阶实战】商店周刷:行会商店的每周刷新封装

2026-09-24 12:43 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua商店周刷周期键

业务场景

行会商店每周一零点刷新货架:从 12 种候选商品里轮换上架 6 种,上周买过的限购商品重置数量。刷新的工程要点:周期判定用"年+周序号"键(跨周自动失效)、刷新过程幂等(重复触发不产生第二套货架)、上架期间玩家正在购买的并发安全(刷新只替换货架清单,不动已生成的订单)。

核心实现

周期键与货架刷新:周序号变化才刷新,刷新写货架与重置限购。示例代码如下:

lua
local CANDIDATES = {
    "强化石礼包", "祝福油礼盒", "沃玛令牌", "金创药箱",
    "魔法药箱", "随机传送卷包", "修理锤", "红名清洗水",
    "双倍经验卡", "宠物口粮", "坐骑饲料", "行会旗",
}
local function weekKey()
    local y = os.date("%Y")
    local yday = tonumber(os.date("%j")) or 1
    return y .. "_W" .. math.floor((yday - 1) / 7)
end
local function weeklyRefresh()
    local wk = weekKey()
    if tostring(getsysvar("GuildShopWeek") or "") == wk then
        return
    end
    local shelf = {}
    local pool = {}
    for i, name in ipairs(CANDIDATES) do
        pool[i] = name
    end
    for slot = 1, 6 do
        local pick = math.random(1, #pool)
        shelf[slot] = pool[pick]
        table.remove(pool, pick)
    end
    setsysvarex("GuildShopWeek", wk, 1)
    setsysvarex("GuildShopShelf", table.concat(shelf, "|"), 1)
    setsysvarex("GuildShopBuyCnt", 0, 1)
    sendmsg(nil, 1, "行会商店本周货架已刷新:" .. table.concat(shelf, "、"))
end

限购计数:本周期内每个商品全服限购 30 份,计数随周期键重置。示例代码如下:

lua
local function buyShelfItem(actor, itemName)
    actor = getplayerbyname(actor)
    local wk = weekKey()
    local cnt = tonumber(getsysvar("GuildShopBuyCnt") or 0)
    if cnt >= 30 then
        sendmsg(actor, 1, "本周该商品已售罄(限购 30 份)。")
        return
    end
    if not takeitem(actor, "金条", 2) then
        sendmsg(actor, 1, "售价 2 根金条。")
        return
    end
    giveitem(actor, itemName, 1, 1)
    setsysvarex("GuildShopBuyCnt", cnt + 1, 1)
    sendmsg(actor, 1, "购得[" .. itemName .. "],本周剩余 " .. (30 - cnt - 1) .. " 份。")
end

接口拆解

weekKey 用年积日除 7 折算周序号并拼年份,跨年自动隔离。getsysvar 对照周键:键相同直接返回(幂等),不同才刷新三件套(周键、货架、限购计数)。math.random 加 table.remove 实现不重复抽取。setsysvarex 全部 isSave 传 1:货架、周键、销量都是跨重启资产。

踩坑记录

商店周刷踩过三个坑:一是刷新在多个定时器里都可能被触发,两处同时刷新写了两套货架,幂等周键检查必须放在刷新函数的第一行;二是随机抽取没去池里移除,同一商品占多个货架位,6 个位置只有 3 种商品,抽签后必须从池里移除;三是限购计数是全服口径而玩家以为是个人限购,公告与商品详情写明"全服每周限购 30 份",口径含糊的限购就是客诉制造机。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

【策划架构】村庄共生:NPC聚落的互助设计

设计初衷 安全区村庄只是传送与摆摊的功能集散地:NPC 站桩、玩家路过、两不相干。村庄共生设计:让村庄与玩家互相需要——玩家…

2026-09-25 15:49 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】玩家武馆:武学传授与馆务经营设计

设计初衷 高战玩家的经验只在小圈子里口口相传,新手想学连门路都没有;师徒系统绑定太重,轻量的武学传授没有载体。玩家武馆设计:…

2026-09-25 15:49 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】天灾事件:全服危机的应对与重建设计

设计初衷 服务器的日常是可预期的循环:刷怪、活动、攻城——缺乏全员共同面对的异常时刻;既有的世界事件又只是打怪换皮。天灾事件…

2026-09-25 15:49 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】图染色:二分判定的普染方案

底层原理 给地图据点分阵营、要求相邻据点不同阵营——这是图的染色问题。二分染色是最简单的情形:从任一点出发做 BFS 逐层染…

2026-09-25 15:49 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】多重映射:一键多值的分组存储

底层原理 常规表一键一值;"一个玩家持有多件装备""一个行会包含多名成员"是一对多关系——多重映射(multimap):每个…

2026-09-25 15:49 996 技术组 · 0 阅读
进阶实战996引擎

【进阶实战】帮会医师:战地治疗服务的定价封装

业务场景 沙巴克战后残血只能灌药慢慢回;NPC 医师的一次性治疗要么免费无成本、要么收费高到劝退。帮会医师封装:帮会驻地常驻…

2026-09-25 15:49 996 技术组 · 0 阅读