【框架设计】摆摊系统：上架定价与离线售卖的校验设计

实战应用：用在哪里

摆摊是玩家自由经济的门户：玩家在指定区域上架物品自定价格，离线也能持续售卖。摆摊系统的风险点集中在定价异常（1 元宝甩卖稀有物）、刷屏占位、离线欺诈三类。设计一套校验与限制，让自由经济有序运转。

上架校验与摊位结构

function Stall.list(player, slotIdx, itemId, count, price)
    -- 三道校验
    if count <= 0 or price <= 0 then return false, "数量与价格必须为正" end
    if price > STALL_PRICE_CAP then return false, "超出单件定价上限" end
    if countStallSlots(player) >= player.stallSlots then return false, "摊位已满" end
    -- 物品从背包转移到摊位（服务端托管）
    local item = Bag.takeSlot(player, slotIdx)
    stalls[player.id][#stalls[player.id] + 1] = { item = item, price = price }
    return true
end

摆摊物品由服务端托管（从背包移入摊位数据），卖家离线不影响购买。定价上限防洗钱式定价，摊位数量按 VIP 或成就扩容。

购买流程与手续费

购买走寄卖行同款的原子占用（在售切锁定），扣款、入包、卖家收款三步由任务队列串行执行。手续费按成交价 3~5% 收取（进经济回收）。购买校验三查：买家货币足额、卖家摊位仍有效、物品未过期下架——三个查询在同一个事务快照内完成，杜绝"看到有货、买时没了"的体验落差。

摆摊区域与治理

摆摊限定在安全区摆摊点（MapInfo 参数划定区域），摊位间最小间距防重叠刷屏。摆摊名称（摊位广告语）过敏感词过滤（敏感词树复用），超长广告语截断。治理数据每周复核：上架总量、成交总额、手续费收入、异常定价命中数——自由经济系统的健康度从这四个数字开始观察。

摊位的搜索与分类：寄卖界面按物品类型分页浏览，价格排序与时间排序切换。搜索与分类让买方高效找到目标，摊位的成交率才会健康，无人问津的摊位会反过来打击卖家上架意愿。

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