CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
框架设计

【框架设计】摆摊系统:线下挂单与离线交易实现

2026-09-22 20:38 作者:996 技术组 框架设计

实战应用:用在哪里

摆摊让玩家在主城把多余装备挂出去,人下线摊位仍在,是传奇引擎玩家经济的毛细血管,主城夜市摆满摊位的画面本身就是热闹的招牌。实现要点是摊位与角色状态解耦:摊位数据独立落盘,角色掉线不影响已挂商品,买家随时下单。

挂单结构

lua

function Stall.list(plr, slot, price)
    local item = plr.bag[slot]
    if not item or item.bind then return false, "绑定物品不可出售" end
    if price < 100 or price > 99999999 then return false, "价格越界" end
    plr.bag[slot] = nil
    local stand = {
        owner = plr.id, item = item, price = price,
        city = plr.mapId, at = os.time(),
    }
    stallBoard[plr.id .. ":" .. slot] = stand
    return true
end

物品从包裹移除后进入摊位表,绑定物品与越界价格直接拒绝,价格下限 100 金币挡住手滑一分钱卖极品的事故。摊位键用角色加槽位拼接,同一角色可同时挂 8 件,上架数量在摊位面板实时可见。

购买与下架

lua

function Stall.buy(buyer, standKey)
    local stand = stallBoard[standKey]
    if not stand then return false, "商品已售出" end
    if not QF_CostGold(buyer, stand.price) then return false, "金币不足" end
    QF_GiveItem(buyer, stand.item)
    QF_MailGold(stand.owner, math.floor(stand.price * 0.95), "摆摊售出")
    stallBoard[standKey] = nil
    QF_LogTrade("stall", buyer.id, stand.owner, stand.item.id, stand.price)
    return true
end

交易收 5% 手续费,卖家离线时收益进邮箱,上线即收。每笔成交写流水,争议对账按流水回放,几分钟内可还原交易现场。金币扣除与摊位移除在同步代码段内完成,天然无并发缝隙。摊位列表用 GUI:ScrollView 分页渲染,支持按价格与品类排序,点击摊位播放 SL 音效反馈,摊位招牌展示卖家自定义的吆喝语。

验证与监控

摆摊成交量按小时统计,单价偏离挂单价均值 5 倍以上的成交进风控复核。

踩坑记录

价格下限 100 金币这条规则定立之前,真的出现过一分钱卖屠龙的截图事故,买家秒拍之后卖家把客服电话打爆。摊位与角色解耦后,又出现角色改名后摊主名字不更新的显示问题,摊位键用 ID 而非名字的设计避开了数据错乱,只剩展示层需要刷新。吆喝语的自定义输入同样接了敏感词库,摊位招牌是主城的门面,脏话上墙的代价是全服可见。

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

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

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

工具链

【工具链】风格检查器:Lua 脚本命名与规范的自动审查

实战应用:用在哪里 脚本的规范靠人盯盯不过来:命名风格漂移、全局变量乱用、缩进混着来——风格检查器把这些规则的执行自动化。提…

2026-09-22 22:32 996 技术组
界面UI

【界面UI】拍卖行界面:出价流程与截拍提醒

实战应用:用在哪里 拍卖行的出价是一场与时间的博弈:出价的按钮、倒计时的紧迫、截拍瞬间的悬念——拍卖界面的要点是出价的流程、…

2026-09-22 21:12 996 技术组
框架设计

【框架设计】幸运值机制:强化失败的隐性补偿

实战应用:用在哪里 强化连败七次是什么体验?幸运值机制给失败的玩家一个隐性的承诺:每次失败累加幸运值,幸运值越高下一次的成功…

2026-09-22 21:12 996 技术组
安全加密

【安全加密】日志防篡改:哈希链与异地备份

实战应用:用在哪里 审计日志的价值在于不可抵赖:被改过的日志比没有日志更危险——纠纷的追溯、内部的追责都建立在「日志没被动过…

2026-09-22 21:12 996 技术组
性能调优

【性能调优】批量邮件:活动奖励的分批投递

实战应用:用在哪里 活动结束给 3 万玩家发奖励:一次性群发让邮件表瞬间多 3 万行、投递的队列堵塞正常的通信。批量邮件的分…

2026-09-22 21:12 996 技术组
网络通信

【网络通信】面对面交易:握手、锁定与确认的协议

实战应用:用在哪里 面对面的交易是传奇最经典的交互:两人面对面、各自放入物品与金币、双方确认后成交。交易的协议要点是会话的建…

2026-09-22 21:12 996 技术组