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

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

请登录后获取
版权类型
原创
插件中文名称
WarZ商街
插件英文名称
WarZMall
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
  3. Folia
  4. Purpur
  5. PufferFish
  6. Leaves
  7. 其他核心
语言支持
中文(简体)
前置组件
Vault / PlayerPoints 双轨货币定价与货款结算(可选,装任一即可)
PlaceholderAPI PAPI 变量(可选)
适配版本(Java)
  1. 1.12
  2. 1.13
  3. 1.14
  4. 1.15
  5. 26.x
  6. 最新版本
  7. 1.16
  8. 1.17
  9. 1.18
  10. 1.19
  11. 1.20
  12. 1.21
📖 《WarZMall 商业街 使用文档》
https://www.yuque.com/daqingtian-3ob8x/warz/warzmall

94157588a9552643a4e7f674f146d703_w2096_h9802_s3937.png


WarZMall v1.0.0

实体商业街不动产引擎 —— 划铺招租·押金租约·内置箱店·大区保护

兼容范围:Spigot / Paper / Purpur / Folia 1.12 - 1.21+ | 系列:WarZ Series Plugin

把一整条可以收租的商业街搬进服务器:管理员木锄划区立牌,玩家交押金+租金签约当店主,放槽上架、聊天定价、原子成交、成交抽税,货款与退回全进邮箱。商品 NBT 序列化入数据库、展示全是克隆体——结构上杜绝刷物品事故。租约状态机覆盖续租/退租/宽限/强制清退,退租退押金、清退还货、区域快照还原;招牌文本随状态自愈刷新,断档重启自动对账。破坏/放置/水桶/容器/活塞/爆炸十二类保护全开,非店主连门框都摸不到。Vault/PlayerPoints 双轨定价,Folia 原生、1.12-1.21+ 全版本。

核心标签:🏪 划铺招租不动产 · 📜 押金租约状态机 · 📦 商品入库零实体 · 💰 原子成交+抽税 · 📮 货款邮箱离线收 · 🛡️ 十二类大区保护 · 🔄 断档自愈对账 · 💱 money/points 双轨 · 🗲 Folia 原生支持

🏪 一句话说清楚
不止菜单点单——这是一条能收租的实体商业街。

商店玩法常见两种形态: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 —— 支持作者持续产出。
作者
Crazy_Jky
查看
5
首次发布
最后更新

评分

0.00 星 0 次评分

Crazy_Jky 的其他资源

最新更新

  1. v1.0.0

    新增(首发:租赁生命周期 + 内置箱店 + 大区保护) 摊位划区:选区木锄(pos1/pos2 粒子描边)+ /wzma create...
后退
顶部 底部