- 版权类型
- 原创
- 插件中文名称
- WarZ商街
- 插件英文名称
- WarZMall
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- Vault / PlayerPoints 双轨货币定价与货款结算(可选,装任一即可)
PlaceholderAPI PAPI 变量(可选)
- 适配版本(Java)
- 1.12
- 1.13
- 1.14
- 1.15
- 26.x
- 最新版本
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
https://www.yuque.com/daqingtian-3ob8x/warz/warzmall
WarZMall v1.0.0
兼容范围:Spigot / Paper / Purpur / Folia 1.12 - 1.21+ | 系列:WarZ Series Plugin
把一整条可以收租的商业街搬进服务器:管理员木锄划区立牌,玩家交押金+租金签约当店主,放槽上架、聊天定价、原子成交、成交抽税,货款与退回全进邮箱。商品 NBT 序列化入数据库、展示全是克隆体——结构上杜绝刷物品事故。租约状态机覆盖续租/退租/宽限/强制清退,退租退押金、清退还货、区域快照还原;招牌文本随状态自愈刷新,断档重启自动对账。破坏/放置/水桶/容器/活塞/爆炸十二类保护全开,非店主连门框都摸不到。Vault/PlayerPoints 双轨定价,Folia 原生、1.12-1.21+ 全版本。
核心标签:
不止菜单点单——这是一条能收租的实体商业街。
商店玩法常见两种形态:GUI 菜单点单和实体箱店。
WarZMall 走的是第三条路——把商店做成服务器不动产:管理员划出一块块实体摊位立上招租牌,玩家真金白银付押金+租金签约经营,商品数据全部入库不落箱子,展示一律是克隆体。租约到期有宽限、强退有快照还原、货款退回全走邮箱。
它卖的不是'又一个商店',而是一整套商业街运营权:谁当店主、租金多少、违约怎么清退,全由你定规则。
签约 · 续租 · 退租 · 宽限 · 清退,一条龙状态机
- 划铺招租:管理木锄点两下角,pos1/pos2 粒子描边实时预览;/wzma create 一键划铺,注视墙面自动放墙牌、没墙脚下立牌兜底,招牌自带 [wzm] 手写重绑兜底。
- 押金+租金签约:玩家右键招牌进签约页:租期±1天调节、总价实时算(押金+租金),确认一次扣清——钱货两讫才过户,绝不先给铺后收钱。
- 续租与退租:管理页一键续租顺延;主动退租二次确认后,在售商品全部退回邮箱、押金按约退还——好聚好散。
- 宽限与强制清退:到期进 GRACE 宽限(时长可配),宽限内续租原地复活;宽限耗尽自动清退:商品退邮箱、押金没收、展示清除、区域快照还原,摊位当天就能再次招租。到期前 24h 还有上线提醒去重。
商品入 DB 不落箱,从根上免疫刷物品
- 放槽上架+聊天定价:店主把商品拖进上架槽、聊天框敲个价就成单:'100' 走金币,'100p' 走点券——money/points 双轨由卖家自选。上架费、定价超时退物都可配。
- 原子成交防双买:购买走 SQL 状态机原子抢占(ON_SALE→SOLD),两人同时点只有一人成交,败者自动退款——高并发摆摊也不撕单。
- 成交抽税+货款邮箱:成交按 trade-tax 抽税,净额自动进店主 ClaimBox 邮箱——店主下线照样收钱,上线弹待领提示,原子领取防重领。
- 克隆展示零风险:商品 NBT 序列化入 SQLite/MySQL,货架上的 ItemFrame 全是不可交互克隆体,价签全息悬浮——没有任何真实物品存在于世界,dupe 从物理上不可能。
十二类保护全开,店主之外的谁都别想动
- 方块级保护:破坏/放置/点火/火焰蔓延/水桶倾倒全拦;门、按钮、拉杆、压力板、绊线等交互统一拒绝。
- 容器与展示保护:箱子/漏斗/发射器全部锁死;画框、盔甲架、展示实体不可被非店主触碰;摊位招牌连店主自己都不能直拆(防误拆丢铺)。
- 机械与爆炸保护:活塞推入/拉出双向拦截,TNT 与实体爆炸清单一律过滤摊位范围方块——商业街不怕熊孩子带炸药逛街。
- 实体换方块拦截:羊吃草、末影人搬方块、兔子啃萝卜……EntityChangeBlock 全覆盖;wzmall.admin.bypass 给管理组留后门。
重启不丢摊,招牌不错乱,孤儿实体零残留
- 启动对账:onEnable 全表重载:摊位状态、商品、邮箱、流水全回;招牌文本与实际状态自动纠偏,异常断电也不卡'待租'。
- 孤儿展示三层清扫:启动清扫 + 区块加载对账 + 周期慢扫——崩服残留的展示实体、价签盔甲架,三层兜底一个不留。
- 区域快照还原:签约时把摊位区域序列化存档,清退/退租后一键还原原貌,店面永远以出厂状态交给下一位租客。
- 流水全留痕:签约/续租/成交/退租/清退全写 TradeLog,管理页可查可审计,玩家纠纷有据可依。
玩家逛街一套命令,管理运营一套工具链
- /wzm browse — 商业街浏览页(店铺/营收榜/邮箱) · wzm.play
- /wzm my — 我的摊位面板 · wzm.play
- /wzm list — 摊位列表 · wzm.play
- /wzm tp <摊位> — 传送至摊位 · wzm.play
- /wzm top — 营收排行榜 · wzm.play
- /wzm claim — 邮箱领取 · wzm.play
- /wzma wand — 选区木锄 · wzm.admin
- /wzma create <名> <租> <押> — 划铺创建 · wzm.admin
- /wzma set-rent/set-deposit/set-owner — 改租金/押金/店主 · wzm.admin
- /wzma set-display — 调整展示位 · wzm.admin
- /wzma lock — 锁定/解锁摊位 · wzm.admin
- /wzma forcertire <名> — 强制清退 · wzm.admin
- /wzma remove/info/tp/debug — 拆除/详情/传送/诊断 · wzm.admin
- /wzma reload — 热重载配置 · wzm.admin
双轨货币 · 软挂全息 · WarZ 全家桶联动
- 货币双轨:Vault 经济 / PlayerPoints 点券反射软挂,双货币可并存:租铺收 A、货款结 B,配置随你组合。
- 全息双实现:价签优先走 DecentHolograms(支持物品行),无 DH 自动回退 Marker 盔甲架——零硬依赖,装上即用。
- Folia 原生 + 全版本:调度全走 WarZLib SchedulerUtil/RegionUtil,Java 8 编译,版本敏感 API 全反射隔离,1.12-1.21+ 通吃。
- WarZ 生态闭环:邮箱可配置转发 WarZExtract ClaimBox,与线上跳蚤市场构成'实体商业街+线上交易所'双市场;PAPI 五变量、三个 API 事件开放二开。
WarZ 系列持续更新中
- 技术交流群:QQ群 398893720 —— 安装、配置、兼容问题直接来问。
- 定制开发:QQ 1285988665 —— 摊位竞拍、转让、店员分红等扩展方向均可定制。
- 爱发电:https://afdian.com/a/sunjood —— 支持作者持续产出。