
货架
管理商店和玩家商店的全新高级方式。ShopShelves与PlayerShelves
ShopShelves - 管理员商店与玩家自有商店
使用 Bukkit、Spigot、Paper 或 Purpur?
要获取服务器插件最准确的功能列表和常规信息,请访问 Spigot 网站:
👉 在 SpigotMC 页面查看插件版本
推荐的客户端配套模组
想要提升购物视觉体验?
👉 WIITS - 客户端购物模组
ShopShelves 将架子方块转变为灵活、对服务器友好的商店!这款强大的服务端 Fabric 模组允许管理员创建永久固定价格的商店,并让玩家能够搭建自己的、与箱子关联的“玩家架子”,可自定义价格,全部由可配置的游戏内经济系统驱动。
📷 图片说明
以下图片按顺序展示了游戏内的架子方块:
- 购买商店 | 出售商店 | 买卖商店 | 自定义标签 | 玩家商店
- 统计书 → 显示每个槽位物品的累计赚取 / 损失金额。
- 自定义价格 GUI → 潜行并右键点击架子,可为每个槽位设置自定义价格。
- 面向顾客的查看 GUI → 查看完整物品详情(药水、附魔、NBT 数据等)。

📦 必需依赖

必需模组: EcoBal 经济 API
✨ 功能
丰富的商店类型
- 管理员商店(购买 / 出售 / 双向): 管理员可以使用架子方块创建购买、出售或双向交易的持久商店。管理员商店不受世界白名单限制,并且无法通过正面物品槽位破坏。
- 玩家商店(PlayerShelves): 玩家可以通过潜行 + 放置架子方块并将其靠在箱子、木桶或铜箱上来创建自己的商店。
- 自动关联到容器(包括大箱子)以进行库存管理。
- 支持通过游戏内价格 GUI(潜行并右键点击架子)为每个槽位设置自定义价格。
- 可配置的单一类型模式:将玩家商店锁定为所有三个槽位均为同一物品并共享价格,或允许每个槽位放置不同物品。
- 可通过权限节点配置创建数量限制。
- 破坏关联容器时,会自动安全地将架子重置为普通原版架子,不会残留悬浮显示。
自定义商店标签
- 通过价格 GUI 为任意架子设置自定义悬浮标签。
- 支持旧版颜色代码(
&c、&l等)、十六进制颜色(&#RRGGBB)以及换行标记(\n或&n)。 - 自动清理换行符两侧的多余空白字符。
- 长度限制(
config.yml中的label_max_length,默认 64)仅计算可见字符。 - 括号格式可在
messages.yml中完全配置(按行切换或整块括号)。 - 在价格 GUI 中右键点击标签图标即可立即清除标签。
动态物品定价
- 全局定价(
pricing.yml): 为物品设置默认购买/出售价值——包括药水、附魔书、山羊角和玩家头颅。 - 自定义价格印章: 使用
/shops price为手持物品盖上自定义定价规则印章,以便即时配置架子。 - 灵活的数量比例: 按数量设置价格(例如 64 个方块 10 美元);单位价值会自动计算。
- GUI 内价格编辑: 潜行并右键点击任意架子,通过增减按钮或精确聊天输入来编辑价格。
- 即时价格重置: 直接在 GUI 内将槽位价格重置为默认值。
统计书
- 追踪管理员商店和玩家架子每个槽位的累计盈利与亏损。
- 所有盈利/亏损指标在服务器重启后仍会保留。
显示美学与技术
- 动态悬浮文本: 使用原版文本显示实体渲染,并与库存和价格更新实时同步。
- 缩放与距离调节: 完全可配置的渲染距离和文本缩放倍数(1–10)。
- 两种显示模式:
TRIPLEPRICE(每个槽位单独显示价格)和SINGLEPRICE(合并价格显示)。 - 本地化: 支持启动时获取的标准 Minecraft 语言文件(
en_us、de_de、fr_fr等)。
服务器保护与管理
- 破坏保护: 架子物品槽位(8×16 像素碰撞箱)忽略普通点击交互;破坏需要瞄准边框区域。
- 容器安全: 关联的存储不能被未授权玩家打开或破坏。
- 防爆: 架子和关联库存可抵御 TNT、苦力怕和凋灵伤害。
- 自动迁移: 自动更新配置文件并加入新引入的键,而不会覆盖现有设置。
- 实时重载: 通过
/shops reload即时刷新配置。
💻 命令
| 命令 | 权限 | 描述 |
|---|---|---|
/shops 或 /shopshelves |
shopshelves.command |
显示带有可交互命令的帮助菜单 |
/shops admin |
shopshelves.admin |
切换管理员模式以绕过限制 |
/shops reload |
shopshelves.reload |
重新加载所有配置和定价文件 |
/shops update |
shopshelves.update |
强制全局重新渲染文本显示 |
/shops mode [mode] |
shopshelves.mode |
设置消息目标(CHAT/ACTIONBAR)或价格样式 |
/shops itemprice |
shopshelves.itemprice |
查看手持物品的全局价格设置 |
/shops itemprice <price> <type> <amount> |
shopshelves.itemprice |
设置手持物品的全局价格 |
/shops price <price> <type> <amount> |
shopshelves.price |
为手持物品创建临时自定义价格印章 |
🔑 权限
shopshelves.command— 访问/shops帮助命令 (默认:所有人)shopshelves.admin— 访问/shops admin模式 (OP 等级 2)shopshelves.reload— 访问/shops reload(OP 等级 2)shopshelves.update— 访问/shops update(OP 等级 4)shopshelves.mode— 访问/shops mode(OP 等级 4)shopshelves.itemprice— 管理全局物品定价 (OP 等级 2)shopshelves.price— 创建自定义物品价格印章 (OP 等级 2)shopshelves.playershelf— 创建 PlayerShelves 的权限 (默认:所有人)shopshelves.playershelves.unlimited— 无限创建 PlayerShelf (OP 等级 4)shopshelves.playershelves.<number>— 设置自定义架子限制(例如shopshelves.playershelves.10)shopshelves.setlabel— 设置自定义悬浮商店标签 (OP 等级 2)shopshelves.setlabel.color— 在标签中使用颜色/十六进制格式 (OP 等级 4)
🛠️ 开发者 API
对于模组开发者,ShopShelves 通过 ShopshelvesApi 类暴露内部商店架子方法:
package me.andy.shopshelves.api;
import me.andy.shopshelves.logic.ShopHelper;
import me.andy.shopshelves.util.ShopShelf;
import net.minecraft.block.entity.BlockEntity;
import net.minecraft.block.entity.ShelfBlockEntity;
import org.jetbrains.annotations.Nullable;
import java.util.Optional;
import java.util.UUID;
public final class ShopshelvesApi {
private static final ShopshelvesApi INSTANCE = new ShopshelvesApi();
private ShopshelvesApi() {}
public static ShopshelvesApi getInstance() {
return INSTANCE;
}
// Checks if a given BlockEntity is an active ShopShelf.
public boolean isShopShelf(@Nullable BlockEntity blockEntity) {
if (!(blockEntity instanceof ShelfBlockEntity) || !(blockEntity instanceof ShopShelf shopShelf)) {
return false;
}
return shopShelf.getShopMode() != ShopHelper.ShopMode.NONE;
}
// Gets the current shop mode for a BlockEntity.
public Optional<ShopHelper.ShopMode> getShopMode(@Nullable BlockEntity blockEntity) {
if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
return Optional.of(shopShelf.getShopMode());
}
return Optional.empty();
}
// Gets the UUID of the shop owner.
public Optional<UUID> getShopOwner(@Nullable BlockEntity blockEntity) {
if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
return shopShelf.getOwner();
}
return Optional.empty();
}
}
💬 支持与联系政策
主要支持(Discord)
所有问题、错误报告和建议都应通过我们的**官方 Discord 服务器**提交,以便其他社区成员能够找到已有的解决方案。
紧急私信政策
私信仅限用于关键的生产环境紧急情况:
- 允许的原因: 由该模组直接导致的严重服务器崩溃或关键物品漏洞。
- 要求: 必须是服务器所有者/管理员。
- 时间: 中欧时间(布鲁塞尔时间)上午 10:00 – 晚上 10:00。
📜 整合包政策
- ✅ 欢迎将 ShopShelves 包含在公开或私有整合包中。
- ❌ 禁止直接重新分发或在付费墙后重新托管。
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。