
MaxiShop
在告示牌上输入 [shop] → 你的商店就开张了。就是这么简单。
无需学习命令,也没有设置向导。只需在一个箱子上放置告示牌,写上 [shop],设定价格,即可开始售卖。其余一切自动处理:你的库存受到保护,买家无法偷窃,你会自动收到款项。
⚡ 10 秒上手指南
- 放置一个箱子并在其上放置告示牌。
- 在第一行写入
[shop]。
- 点击告示牌,选择物品,并在聊天栏中输入价格。
✔ 商店已激活。 一个悬浮、发光且缓慢旋转的物品图标会出现在箱子上方,玩家即可开始购买。
购买同样简单:点击商店告示牌,然后点击 [Buy 1]、[Buy 16]、[Buy 64] 或 [Buy max],或者在聊天栏中输入你想购买的数量。
单个箱子可打开双人箱的 GUI。这意味着一个箱子商店仅占用双人箱一半的空间,却拥有相同的容量!
✨ 功能一览
- ? 一键设置。 告示牌上写
[shop] 即可。
- ?️ 聊天栏点击菜单。 所有按钮均可点击,无需记忆任何命令。
- ? 在聊天栏输入数量和价格。
64、all、125.50、1.5k 和 10G 均有效。
- ? 防盗窃。 即使插件未运行,商店也无法被抢劫(详见下文)。
- ✨ 吸睛展示。 每个商店上方都会悬浮、发光、上下浮动并缓慢旋转的物品图标。
- ?️ 商店名称。 商店会自动命名(如“Diamond Ore Shop #2”),玩家也可自行重命名。
- ? 支持任意货币符号。 G、€、£、$ 或自定义符号,可位于金额前或后。
- ? 店主统计数据。 已售出物品数、收入、最佳商店以及你离线期间的销售汇总。
- ?
/mshop find <item> 列出出售指定物品的最近开放商店及其价格。
- ? 干净卸载。 一条命令即可将所有物品归还给原主。
- ? 轻量级。 无需数据库、数据包库或下载依赖。Vault 是唯一的依赖项。
?? 店主专区
点击你的告示牌以打开商店菜单:
Diamond Ore Shop
物品: Diamond Ore · 库存: 128
价格: 50.00 $ 每件 · 状态: ● 营业中
已售: 412 件 · 收入: 20,600.00 $ · 上次售出: 3 分钟前
[Set price] [Rename] [Stock] [Notifications: ON]
[Close shop] [Stats] [Delete shop]
- 补货: 右键点击箱子以打开库存窗口。仅允许放入商店对应的物品;其他物品会被退回。
- 更换物品: 清空库存窗口并放入新物品,或点击 [Use item in hand]。
- 暂停售卖: [Close shop] 会在告示牌上显示 CLOSED。使用
/mshop closeall 可一次性暂停所有商店。
- 销售通知: 每笔交易都会收到消息,或可为每个商店单独关闭通知。
- 离开服务器? 重新上线时你会收到摘要:“在你离开期间:14 笔交易,+3,250 G”。
- 删除: 会先弹出确认窗口,剩余库存将全部返还给你。
? 买家专区
点击任意商店告示牌即可查看所有者、物品(悬停预览)、库存和价格,以及购买按钮。
你无法购买超过商店库存、超出你支付能力或超出你背包容量的数量。无债务风险,不会丢失物品。如果发生无法放入背包的情况,使用 /mshop claim 可将物品安全保留给你。
? 为什么 MaxiShop 无法被抢劫
许多商店插件将物品存储在真实的箱子内部,并依赖插件阻止他人打开箱子。如果该插件加载失败(依赖损坏、数据库错误、更新不当),所有箱子会变回普通箱子,而告示牌看起来仍像商店。任何人都可以走进去将它们清空。
MaxiShop 采用“故障即锁闭”设计。 如果出现问题,商店会锁定而非打开。
| 防护层级 |
如果 MaxiShop 损坏或被移除会发生什么 |
| 虚拟库存。 物品存储在 MaxiShop 的数据文件中,物理箱子始终为空 |
箱子里没有东西可偷 |
| 原版容器锁,使用生存模式中不存在的密钥 |
即使完全移除插件,箱子也无法打开 |
| 涂蜡告示牌 |
无人能编辑告示牌文本 |
| 商店标记 保存在箱子和告示牌方块数据中 |
即使商店数据条目丢失,商店仍受保护,工作人员会收到警报 |
| 悬浮物品不保存至世界文件 |
如果插件宕机,物品会消失,让你能看到出了问题 |
| 数据在加载失败后不会被覆盖 |
损坏的数据文件会从最新备份恢复。如果备份也失败,MaxiShop 进入锁定模式:所有内容保持锁定,无任何数据被覆盖 |
| 无数据库或数据包库 |
减少出错环节。如果没有 Vault,商店保持锁定,购买暂停 |
内置的完整性检查每分钟运行一次,自动修复已加载商店中缺失的告示牌、锁或标记。
? 自定义
所有配置均在 config.yml 中,并使用 MiniMessage 颜色代码(<green>、<#ff8800>、<bold> …)。通过 /mshopadmin reload 应用更改。
悬浮物品显示
display:
enabled: true
height: 1.2
scale: 0.55
glow: true
glow-color: "#FFD700"
full-bright: true # 夜间/黑暗房间中可见
bob: true
bob-height: 0.1
spin: true
spin-seconds: 6 # 完整旋转一圈 360°
货币符号。 可在配置文件中设置,或在游戏中通过一条命令设置:
/mshopadmin currency G after → 125.00 G
/mshopadmin currency € before → €125.00
不同状态下的告示牌文本(营业中、缺货、关闭、设置中),支持占位符 <owner> <stock> <item> <price> <name>。
其他选项:
- 允许的容器(箱子、陷阱箱、 barrels)
- 物品黑名单
- 最低和最高价格,以及小数位数
- 每个玩家的商店数量限制
- 每次购买的最大物品数量
- 交互距离
- 库存窗口的大小
- 销售税(一种货币回收机制)
- 自动保存间隔
- 备份
? 命令
点击显示所有命令
玩家: /mshop(别名 /maxishop, /cshop)
| 命令 |
描述 |
/mshop list |
列出你的带有库存和状态的商店 |
/mshop stats |
已售物品、收入、最佳商店、买入物品 |
/mshop manage <id> |
打开所有者菜单 |
/mshop price <id> [price] |
设置价格(或在聊天中输入) |
/mshop rename <id> [name|reset] |
重命名商店 |
/mshop notify <id> [on|off] |
销售通知开关 |
/mshop close|open <id> |
暂停或恢复单个商店 |
/mshop closeall|openall |
暂停或恢复你所有的商店 |
/mshop stock <id> |
打开库存窗口(需靠近商店) |
/mshop sethand <id> |
出售你手中的物品 |
/mshop delete <id> |
删除商店(需确认) |
/mshop find <item> |
查找出售某物品的最近商店 |
/mshop claim |
领取未能放入背包的物品 |
管理员: /mshopadmin(别名 /msa)
| 命令 |
描述 |
status |
健康报告:经济状况、数据、备份、问题 |
freeze [reason] / unfreeze |
所有商店的紧急停止 |
list [player] · info [id] · tp <id> |
查找和检查商店 |
close|open <id> |
管理员强制关闭(所有者无法重新开启) |
closeall|openall <player> |
同上,针对某玩家的所有商店 |
delete <id> · setowner <id> <player> |
移除或转移商店所有权 |
stock <id> |
查看或编辑任何商店的库存(已记录日志) |
stats [player] |
全服或按玩家统计 |
currency <symbol> [before|after] |
更改货币符号 |
repair · backup · reload |
维护操作 |
unlock |
移除你当前注视方块上的遗留锁 |
claims <player> [take] |
查看或发放等待领取给某玩家的物品 |
uninstall / uninstall status |
彻底清除所有商店 |
? 权限
点击显示所有权限
| 权限 |
默认值 |
描述 |
maxishop.use |
everyone |
购买和使用 /mshop |
maxishop.create |
everyone |
创建商店 |
maxishop.limit.<n> |
– |
每等级每个玩家的最大商店数(例如 maxishop.limit.50) |
maxishop.limit.unlimited |
false |
无商店数量限制 |
maxishop.admin |
OP |
所有管理员命令、绕过限制、接收管理员警报 |
?️ 数据、日志和备份
- 自动备份每小时一次以及每次启动时进行(保留最新的 30 份)。
- 交易日志。 每笔销售记录都会保存到
logs/transactions-YYYY-MM.csv,可用 Excel 打开。
- 每 60 秒自动保存,且在每次销售后立即保存。
? 彻底卸载
由于库存是虚拟的且箱子被锁定,请不要直接删除 jar 文件。 请运行 /mshopadmin uninstall:
- 所有商店将被移除,所有箱子将被解锁。
- 所有库存将归还给其所有者。在线玩家会将其放入背包;离线玩家将在登录时自动获得。
- 完整报告将保存到
uninstall-report.txt。
/mshopadmin uninstall status 会告诉你何时可以安全地移除插件。
? 从其他商店插件迁移
- 让所有者清空他们旧的商店箱子。
- 移除旧插件。
- 安装 MaxiShop。
- 玩家破坏旧的告示牌并放置新的
[shop] 告示牌。当商店创建时,持有单一物品类型的箱子会自动转换为库存。
- 检查
/mshopadmin status。它应显示“未检测到任何问题”。
? 依赖项
- Paper 26.2 (Java 25)
- Vault(或 VaultUnlocked)以及一个经济插件
ℹ️ 须知
- 商店仅支持出售:玩家向其他玩家出售物品。
- 商店适用于单个箱子、陷阱箱和 barrels。不支持双箱子。

MaxiShop
Type [shop] on a sign → your shop is open. That's it.
No commands to learn and no setup wizard. Put a sign on a chest, write [shop], pick a price, and you're selling. Everything else happens on its own: your stock is protected, buyers can't steal from you, and you get paid automatically.
⚡ How it works in 10 seconds
- Place a chest and put a sign on it.
- Write
[shop] on the first line.
- Click the sign, choose your item, and type your price in chat.
✔ Shop active. A floating, glowing item appears above your chest and players can start buying.
Buying is just as simple: click a shop sign, then click [Buy 1], [Buy 16], [Buy 64] or [Buy max], or type how many you want in chat.
A single chest opens up the GUI of a double chest. Meaning a chest shop takes half the space of a double chest, yet has the same capacity!
✨ Features at a glance
- ? One-word setup.
[shop] on a sign is all you need.
- ?️ Click-to-use menus in chat. Every button is clickable and nobody has to remember a command.
- ? Type amounts and prices in chat.
64, all, 125.50, 1.5k and 10G all work.
- ? Theft-proof. Shops can't be robbed, even when the plugin isn't running (more on that below).
- ✨ Eye-catching displays. The item floats, glows, bobs and slowly spins above every shop.
- ?️ Shop names. Shops are named automatically ("Diamond Ore Shop #2"), or players can rename them.
- ? Any currency. G, €, £, $ or your own symbol, before or after the amount.
- ? Stats for shop owners. Items sold, revenue, best shops and a summary of sales made while you were away.
- ?
/mshop find <item> lists the nearest open shops that sell an item, with prices.
- ? Clean uninstall. One command returns every item to its owner.
- ? Lightweight. No database, no packet libraries and no downloads. Vault is the only dependency.
?? For shop owners
Click your sign to open your shop menu:
Diamond Ore Shop
Item: Diamond Ore · Stock: 128
Price: 50.00 $ each · Status: ● Active
Sold: 412 items · Revenue: 20,600.00 $ · Last sale: 3m ago
[Set price] [Rename] [Stock] [Notifications: ON]
[Close shop] [Stats] [Delete shop]
- Restock: right-click your chest to open the stock window. Only your shop's item fits; anything else bounces back.
- Change item: empty the stock window and put a new item in, or click [Use item in hand].
- Pause selling: [Close shop] shows CLOSED on the sign.
/mshop closeall pauses all your shops at once.
- Sale notifications: get a message for every sale, or turn them off per shop.
- Away from the server? When you log back in you get a summary: "While you were away: 14 sales, +3,250 G".
- Delete: a confirmation window opens first, and all remaining stock comes back to you.
? For buyers
Click any shop sign to see the owner, item (with a hover preview), stock and price, plus buy buttons.
You can never buy more than the shop has in stock, more than you can afford, or more than fits in your inventory. No debt, no lost items. If something ever doesn't fit, /mshop claim keeps it safe for you.
? Why MaxiShop can't be robbed
Many shop plugins keep the items inside the real chest and rely on the plugin to stop people opening it. If that plugin fails to load (a broken dependency, a database error, a bad update), every chest turns back into a normal chest while the signs still look like shops. Anyone can walk in and empty them.
MaxiShop is built to fail closed. If something breaks, shops lock instead of opening.
| Protection layer |
What happens if MaxiShop is broken or removed |
| Virtual stock. Items are stored in MaxiShop's data file, and the physical chest is always empty |
There is nothing in the chest to steal |
| Vanilla container lock with a key that doesn't exist in survival |
The chest won't open, even with the plugin completely removed |
| Waxed signs |
Nobody can edit the sign text |
| Shop marker saved in the chest and sign block data |
Shops stay protected even if their data entry goes missing, and staff are alerted |
| Floating items aren't saved to the world |
If the plugin is down, the items vanish, so you can see something is wrong |
| Data is never overwritten after a failed load |
A damaged data file is restored from the newest backup. If that fails too, MaxiShop goes into lockdown: everything stays locked and nothing is overwritten |
| No database or packet libraries |
Fewer things that can break. Without Vault, shops stay locked and buying pauses |
A built-in integrity check also runs every minute. It repairs missing signs, locks or markers on loaded shops automatically.
? Customization
Everything is in config.yml and uses MiniMessage colors (<green>, <#ff8800>, <bold> …). Apply changes with /mshopadmin reload.
Floating item display
display:
enabled: true
height: 1.2
scale: 0.55
glow: true
glow-color: "#FFD700"
full-bright: true # visible at night / in dark rooms
bob: true
bob-height: 0.1
spin: true
spin-seconds: 6 # one full 360° turn
Currency. Set it in the config, or in game with one command:
/mshopadmin currency G after → 125.00 G
/mshopadmin currency € before → €125.00
Sign text per state (active, out of stock, closed, setting up) with the placeholders <owner> <stock> <item> <price> <name>.
Other options:
- Allowed containers (chest, trapped chest, barrel)
- Item blacklist
- Minimum and maximum price, and decimal places
- Shops per player
- Maximum items per purchase
- Interaction distance
- Size of the stock window
- Sales tax (a money sink)
- Autosave interval
- Backups
? Commands
Click to show all commands
Players: /mshop (aliases /maxishop, /cshop)
| Command |
Description |
/mshop list |
Your shops with stock and status |
/mshop stats |
Items sold, revenue, best shops, items bought |
/mshop manage <id> |
Open the owner menu |
/mshop price <id> [price] |
Set a price (or type it in chat) |
/mshop rename <id> [name|reset] |
Rename a shop |
/mshop notify <id> [on|off] |
Sale notifications |
/mshop close|open <id> |
Pause or resume one shop |
/mshop closeall|openall |
Pause or resume all your shops |
/mshop stock <id> |
Open the stock window (when nearby) |
/mshop sethand <id> |
Sell the item in your hand |
/mshop delete <id> |
Delete a shop (with confirmation) |
/mshop find <item> |
Find the nearest shops selling an item |
/mshop claim |
Collect items that didn't fit in your inventory |
Staff: /mshopadmin (alias /msa)
| Command |
Description |
status |
Health report: economy, data, backups, problems |
freeze [reason] / unfreeze |
Emergency stop for all shops |
list [player] · info [id] · tp <id> |
Find and inspect shops |
close|open <id> |
Staff close (the owner can't reopen it) |
closeall|openall <player> |
Same, for all shops of a player |
delete <id> · setowner <id> <player> |
Remove or transfer a shop |
stock <id> |
View or edit any shop's stock (logged) |
stats [player] |
Server-wide or per-player stats |
currency <symbol> [before|after] |
Change the money symbol |
repair · backup · reload |
Maintenance |
unlock |
Remove a leftover lock from the block you're looking at |
claims <player> [take] |
See or hand out items waiting for a player |
uninstall / uninstall status |
Remove all shops cleanly |
? Permissions
Click to show all permissions
| Permission |
Default |
Description |
maxishop.use |
everyone |
Buy and use /mshop |
maxishop.create |
everyone |
Create shops |
maxishop.limit.<n> |
– |
Max shops per player, per rank (e.g. maxishop.limit.50) |
maxishop.limit.unlimited |
false |
No shop limit |
maxishop.admin |
OP |
All staff commands, bypass limits, staff alerts |
?️ Data, logs and backups
- Automatic backups every hour and at every startup (the newest 30 are kept).
- Transaction log. Every sale goes to
logs/transactions-YYYY-MM.csv, which opens in Excel.
- Autosave every 60 seconds and right after every sale.
? Uninstalling cleanly
Because stock is virtual and chests are locked, don't just delete the jar. Run /mshopadmin uninstall instead:
- Every shop is removed and every chest is unlocked.
- All stock goes back to its owner. Online players get it in their inventory; offline players get it automatically when they log in.
- A full report is saved to
uninstall-report.txt.
/mshopadmin uninstall status tells you when it's safe to remove the plugin.
? Switching from another shop plugin
- Have owners empty their old shop chests.
- Remove the old plugin.
- Install MaxiShop.
- Players break their old signs and place new
[shop] signs. A chest holding a single item type is turned into stock automatically when the shop is created.
- Check
/mshopadmin status. It should say "No problems detected".
? Requirements
- Paper 26.2 (Java 25)
- Vault (or VaultUnlocked) plus an economy plugin
ℹ️ Good to know
- Shops are sell-only: players sell items to other players.
- Shops work on single chests, trapped chests and barrels. Double chests aren't supported.
评论 0
登录后参与评分
还没有评论,来抢沙发吧