货架

货架

管理商店和玩家商店的全新高级方式。ShopShelves与PlayerShelves

ShopShelves - 管理员商店与玩家自有商店

使用 Bukkit、Spigot、Paper 或 Purpur?
要获取服务器插件最准确的功能列表和常规信息,请访问 Spigot 网站:
👉 在 SpigotMC 页面查看插件版本


推荐的客户端配套模组

想要提升购物视觉体验?
👉 WIITS - 客户端购物模组

WIITS Banner


ShopShelves 将架子方块转变为灵活、对服务器友好的商店!这款强大的服务端 Fabric 模组允许管理员创建永久固定价格的商店,并让玩家能够搭建自己的、与箱子关联的“玩家架子”,可自定义价格,全部由可配置的游戏内经济系统驱动。


📷 图片说明

以下图片按顺序展示了游戏内的架子方块:

  • 购买商店 | 出售商店 | 买卖商店 | 自定义标签 | 玩家商店
  • 统计书 → 显示每个槽位物品的累计赚取 / 损失金额。
  • 自定义价格 GUI → 潜行并右键点击架子,可为每个槽位设置自定义价格。
  • 面向顾客的查看 GUI → 查看完整物品详情(药水、附魔、NBT 数据等)。
Buy Shop Sell Shop Dual Shop Custom Label Player Shop Stats Book Price GUI Viewer GUI Display Overview

📦 必需依赖

EcoBal
必需模组: 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 包含在公开或私有整合包中。
  • ❌ 禁止直接重新分发或在付费墙后重新托管。