【1.12-26.X|Folia】WarZMall —— 划铺招租商业街+押金租约状态机+内置箱店+十二类大区保护

原创 付费 游戏模式 【1.12-26.X|Folia】WarZMall —— 划铺招租商业街+押金租约状态机+内置箱店+十二类大区保护 1.0.0

请登录后获取
新增(首发:租赁生命周期 + 内置箱店 + 大区保护)

  • 摊位划区:选区木锄(pos1/pos2 粒子描边)+ /wzma create 一键划铺,注视墙面自动放墙牌、脚下立牌兜底;[wzm] 手写招牌管理员重绑
  • 租约生命周期:VACANT→RENTED→GRACE→清退 状态机;押金+租金签约、续租顺延、GRACE 续租复活、主动退租退押金、宽限尽强制清退(商品退邮箱/押金没收/展示清除/快照还原)、到期前 24h 提醒去重
  • 内置箱店:商品 NBT 序列化入 DB(无实体库存防 dup),放槽上架 + 聊天定价(money/points 双轨、上架费、超时退物)、原子抢占防双买、成交税、货款进店主邮箱、TradeLog 全量流水
  • 展示引擎:ItemFrame 展示 clone(fixed/invulnerable 反射隔离)+ 价签全息(DecentHolograms 优先 / Marker 盔甲架零依赖兜底),展示位上限、孤儿实体三层对账清扫(onEnable/区块加载/周期任务)
  • 大区保护:破坏/放置/水桶/点火/容器/门按钮压力板/画框盔甲架/双爆炸/双活塞/火焰蔓延/实体换方块全拦,招牌与展示位连店主不可直拆,wzmall.admin.bypass 管理通行
  • ClaimBox 邮箱:货款/退回/押金全量进邮箱,原子领取防重领,上线待领取提示;可配置转发 WarZExtract
  • GUI 十页:browse/rent/manage/shelf/shelf-edit(放槽)/shop/confirm/claim/top/log 全走 WarZInventory 按钮规范,内容区空槽保持 AIR
  • 配套:/wzm 玩家六令 + /wzma 管理十四令、PAPI 五变量、三个 API 事件、snapshot 区域还原、四 ORM 表自动建

修复(实机验收)

  • 释放顺序丢货丢押金(严重):quit/evict 先 atomicRelease 清空 owner 再 reclaimAll,导致在售商品标记 EXPIRED/REMOVED 却不生成邮箱退回、退租押金也寄往空 UUID;改为释放前捕获 owner 并显式传入 reclaimAll(stall, evict, ownerUuid),实机复测「清退退回/押金退回」邮箱记录均正常生成
  • 异步线程同步 callEvent 崩栈:StallRentedEvent/GoodsSoldEvent/StallEvictedEvent 在异步点击线程同步派发被 Paper 拒绝,且异常截断后续招牌刷新(招牌卡「待租」);GUI 点击层与管理子命令统一回归同步执行(对齐 WarZExtract 基线),事件派发改由同步链路触发
  • 启动对账不纠脏招牌:历史异常留下的 RENTED 招牌文本不自愈;onEnable 对账阶段补 refreshSign,重启后摊位招牌与实际状态一致

兼容性

  • Spigot / Paper / Purpur / Folia,Minecraft 1.12–1.21+,Java 8
  • 软挂钩:Vault / PlayerPoints / PlaceholderAPI / DecentHolograms / WarZExtract(全部缺席安全降级)
  • 调度全走 WarZLib SchedulerUtil + RegionUtil 区域投递,无一处裸 Bukkit 调度
后退
顶部 底部