Chestless Player Shops
一个专为 Paper 1.21.1+ 设计的完全虚拟、基于 GUI 的玩家商店插件
由 Niko 制作
概述
Chestless Player Shops 允许玩家创建和管理自己的商店——无需实体箱子或告示牌。所有操作都通过清晰的分页 GUI 进行。玩家可以设置想要出售的物品、作为回报(支付)获得的物品,并虚拟管理库存。买家可以通过单一菜单浏览所有可用商店,并一键购买。
功能
- 虚拟商店 — 无需放置任何物理方块。商店完全存在于插件的数据库中。
- 自定义商店图标 — 每个商店都可以拥有在商店浏览器中可见的独特图标。
- 物品换物品交易 — 支付方式始终是物品,而非货币。精确设定你希望得到的回报。
- 库存管理 — 库存被精确追踪。当物品售罄时,库存显示为空。
- 收藏箱 — 收益安全地存储在虚拟收藏箱中,所有者可随时领取。
- 缺货提醒 — 当物品缺货时,所有者会在聊天中收到通知,包括实时和登录时。
- 安全的 GUI — 自定义库存锁定防止物品泄漏到菜单之外或从菜单中溢出。
- 多页支持 — 库存、收藏箱、物品列表和商店浏览器均支持分页。
安装
安装步骤
- 下载
ChestlessPlayerShops-1.0-SNAPSHOT.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 重启服务器。
命令
| 命令 |
描述 |
/stores |
打开商店浏览器(等同于 /stores view)。 |
/stores view |
浏览所有可用商店。 |
/stores manage |
打开你的商店管理器以创建和编辑商店。 |
/stores create <name> |
直接从命令行创建新商店。 |
/stores help |
在聊天中显示所有命令和使用指南。 |
所有子命令均支持 Tab 补全。
购买
- 输入
/stores 或 /stores view。
- 浏览商店列表——每个商店都会显示其名称和封面图标。
- 点击商店查看其商品。
- 悬停在物品上以查看其价格。
- 点击物品进行购买。如果你拥有足够的支付物品且背包空间充足,交易将立即完成。
商店设置
创建商店
- 使用
/stores manage 并点击 绿宝石块(Create New Shop),或者

- 直接在聊天中使用
/stores create <name>。
- 商店名称必须为 3–16 个字符,仅包含字母、数字和空格。
商店图标 (可选)
- 在商店管理器中,点击 物品展示框(
Change Shop Icon)。
- 跨越多页浏览所有可用的 Minecraft 物品。
- 点击任意物品将其设置为商店在浏览器中的图标。
添加物品
- 点击 Manage Items → Add New Item(绿色方块)。

库存
- 点击 Manage Stock → 选择你想要补货的物品。
- 在打开的库存箱子中:
- Shift+点击 背包中的物品以存入。
- 点击 漏斗 按钮(
Import from Inventory)一次性存入所有匹配物品。
- 左键点击 箱子中的物品以取回背包。
库存数量按数值追踪——该箱子是虚拟的,容量无限。

收益
- 在商店管理器中点击 Collection Bin。
- 点击任意物品堆栈将其领取至背包。
- 即使你离线,收益也会在此累积。
删除商店
- 在商店管理器中点击 Delete Shop。
- 你必须先清空收藏箱并移除所有列出的物品。
提醒
| 事件 |
通知方式 |
| 在线时某物品库存售罄 |
聊天警告 + 声音 |
| 登录时发现任何商店物品缺货 |
聊天摘要 + 声音 |

配置文件
配置文件位置:plugins/ChestlessPlayerShops/config.yml
max-shops-per-player: 3
messages:
shop-created: "&aShop &e{name} &acreated!"
shop-deleted: "&cShop &e{name} &cdeleted."
shop-limit-reached: "&cYou have reached the maximum number of shops!"
invalid-name: "&cInvalid name! Use 3-16 letters/numbers/spaces."
not-enough-payment: "&cYou don't have enough {item} to buy this!"
? 数据存储
所有商店数据均以 JSON 文件 形式存储在:
plugins/ChestlessPlayerShops/data/<player-uuid>.json
每个文件包含该玩家拥有的所有商店,包括物品、库存数量和收藏箱内容。每次交易后数据会自动保存。
? 兼容性
| 属性 |
值 |
| 服务端软件 |
Paper |
| Minecraft 版本 |
1.21.1+ |
| Java 版本 |
21+ |
| 依赖项 |
无 |
Chestless Player Shops — 由 Niko 制作
Chestless Player Shops
A fully virtual, GUI-driven player shop plugin for Paper 1.21.1+
Made by Niko
Overview
Chestless Player Shops lets players create and manage their own shops — no physical chests or signs required. Everything is handled through clean, paginated GUIs. Players set the item they want to sell, the item they want in return (as payment), and manage their stock virtually. Buyers browse all available shops from a single menu and purchase with one click.
Features
- Virtual Shops — No physical blocks needed. Shops exist entirely in the plugin's database.
- Custom Shop Icons — Each shop can have a unique icon visible in the shop browser.
- Item-for-Item Trading — Payment is always an item, never money. Set exactly what you want in return.
- Stock Management — Stock is tracked precisely. Items go out of stock when sold out.
- Collection Bin — Earnings are stored safely in a virtual collection bin for the owner to claim at any time.
- Out-of-Stock Alerts — Owners get notified in chat when an item goes out of stock, both live and on login.
- Safe GUIs — Custom inventory locking prevents items from leaking into or out of menus.
- Multiple Pages — Stock, collection bin, item list, and shop browser all support pagination.
Setup
Installation
- Download
ChestlessPlayerShops-1.0-SNAPSHOT.jar.
- Place it in your server's
plugins/ folder.
- Restart the server.
Commands
| Command |
Description |
/stores |
Opens the shop browser (same as /stores view). |
/stores view |
Browse all available shops. |
/stores manage |
Open your shop manager to create and edit your shops. |
/stores create <name> |
Create a new shop directly from the command line. |
/stores help |
Show all commands and a usage guide in chat. |
Tab completion is supported for all subcommands.
Buying
- Type
/stores or /stores view.
- Browse the list of shops — each shows the shop name and its cover icon.
- Click a shop to view its items.
- Hover over an item to see what it costs.
- Click an item to purchase it. If you have the payment item and enough inventory space, the trade happens instantly.
Shop Setup
Create Shop
- Use
/stores manage and click the Emerald Block (Create New Shop), or

- Use
/stores create <name> directly in chat.
- Shop names must be 3–16 characters, letters, numbers and spaces only.
Shop Icon (optional)
- In your shop manager, click the Item Frame (
Change Shop Icon).
- Browse through all available Minecraft items across multiple pages.
- Click any item to set it as your shop's icon in the browser.
Add Items
- Click Manage Items → Add New Item (green block).

Stock
- Click Manage Stock → select the item you want to restock.
- In the stock chest that opens:
- Shift-click items from your inventory to deposit them.
- Click the Hopper button (
Import from Inventory) to deposit all matching items at once.
- Left-click items in the chest to withdraw them back to your inventory.
Stock quantity is tracked numerically — the chest is virtual and has unlimited capacity.

Earnings
- Click Collection Bin in your shop manager.
- Click any item stack to collect it into your inventory.
- Earnings accumulate here even while you're offline.
Delete Shop
- Click Delete Shop in your shop manager.
- You must empty your Collection Bin and remove all listed items first.
Alerts
| Event |
Notification |
| An item's stock is sold out while you're online |
Chat warning + sound |
| You log in and any shop item is out of stock |
Chat summary + sound |

Config
Config file: plugins/ChestlessPlayerShops/config.yml
max-shops-per-player: 3
messages:
shop-created: "&aShop &e{name} &acreated!"
shop-deleted: "&cShop &e{name} &cdeleted."
shop-limit-reached: "&cYou have reached the maximum number of shops!"
invalid-name: "&cInvalid name! Use 3-16 letters/numbers/spaces."
not-enough-payment: "&cYou don't have enough {item} to buy this!"
? Data Storage
All shop data is stored as JSON files in:
plugins/ChestlessPlayerShops/data/<player-uuid>.json
Each file contains all shops owned by that player, including items, stock counts, and collection bin contents. Data is automatically saved after every transaction.
? Compatibility
| Property |
Value |
| Server Software |
Paper |
| Minecraft Version |
1.21.1+ |
| Java Version |
21+ |
| Dependencies |
None |
Chestless Player Shops — Made by Niko
评论 0
登录后参与评分
还没有评论,来抢沙发吧