店主布料

店主布料

Fabric 1.21–1.21.11 的服务端玩家商店。库存箱子、管理员商店、原版交易界面、无法击杀的店主以及 LuckPerms 支持。无需客户端模组。非官方版本,并非 Shopkeepers 插件。

杂项

Shopkeepers Fabric

玩家经营自己的商店。放置一个箱子,选择一个生物,设定你的价格,其他所有人通过普通的村民交易界面购买。

适用于 所有 Minecraft 1.21 正式版,从 1.21 到 1.21.11。

⚠️ 这不是官方 Shopkeepers。 Shopkeepers Fabric 是一个独立的非官方模组,灵感来自经典的 Shopkeepers Bukkit 插件。它不是官方移植版,与插件不共享任何代码,也不是由插件作者制作、认可或支持的。请不要向他们报告此模组的问题。

🎮 无需客户端模组。你的玩家使用原版客户端加入。

Shopkeepers Fabric 是 100% 服务端模组。把它放进服务器的 mods/ 文件夹就完成了:无需整合包,无需启动器设置,玩家无需安装任何东西。交易界面是原版村民界面,商店编辑器是原版箱子界面,而商店主是普通的生物,因此任何原版客户端都已经知道如何显示这一切。

🏪 玩家商店

每个商店都链接到放置在旁边的库存箱(或木桶)。

  • 当有人购买时,物品会从箱子中取出,他们的付款会放入其中。
    * 一个商店可以混合出售(钻石换绿宝石)、收购(绿宝石换小麦)和交换(任意物品换任意物品),默认最多 45 个交易。
    * 箱子目前无法满足的交易(售罄,或没有空间放置付款)会显示原版的红色叉号,每次购买后列表都会更新。
    * Shift+点击结果项,可以一次性尽可能多地购买。
    * 每当有人从店主那里购买时,店主会收到一条聊天消息。

👑 管理员商店

无限库存,不保留任何收到的付款。 专为出生点市场、物品消耗和任务奖励而设计。

  • 使用 /shopkeeper admin [mob] 创建一个,或将 Shopkeeper 物品切换为管理员模式。
    * 可从控制台和命令方块使用:/execute positioned 0 64 0 run shopkeeper admin。
    * 只有工作人员可以编辑或删除它们。

🛠️ 设置商店

  1. 合成一个 Shopkeeper: 8 个绿宝石围绕一个箱子。它看起来像村民刷怪蛋(在 1.21–1.21.1 上是一本发光的书)。
    2. 右键点击你的箱子,用它将其选为库存。
    3. 右键点击空气来选择生物(可选)。
    4. 右键点击方块来放置商店。编辑器会立即打开。

编辑器

一个箱子界面,其中每一列就是一个交易:顾客获得的物品在上方,价格在下方,其下方是可选的第二价格。

  • 手持物品时: 左键放入整组,右键添加 1 个。拖动也可以。
    * 空手时: 左键取出物品,右键取出 1 个。
    * 编辑器只使用副本。 你的真实物品永远不会离开你的物品栏,因此其中的任何东西都不会丢失或复制。
    * 按钮用于翻页、重命名(在聊天中输入名称,& 颜色代码有效)、更改生物、村民职业和生物群系外观,以及删除商店(你会取回 Shopkeeper)。

有 25 种生物可供选择:村民、流浪商人、掠夺者、女巫、傀儡、狐狸、猫、熊猫、羊驼等等。该列表可配置。

🔒 为服务器打造(防破坏与防漏洞)

Shopkeepers 在设计时考虑到了服务器管理员。商店无法被杀死、抢劫或劫持。

  • 无法被杀死的商店: 商店生物免疫所有伤害、/kill @e、闪电(村民不会变成女巫)、虚空和自然消失。如果有任何东西移动了它们,它们会在一秒内弹回。
    * 锁定的库存箱: 只有店主可以打开或破坏商店的箱子。爆炸不会影响它,也没有人能用漏斗抽取它,或通过在旁边放置箱子组成大箱子来打开它。
    * 无法劫持箱子: 你只能使用你在过去 10 分钟内放置的容器作为库存,因此没有人能把你的箱子变成他们的商店并将你锁在外面。
    * 没有免费物品: 在取出物品的确切时刻会再次检查库存,因此交易中途清空箱子不会发出免费物品。
    * 商店限制: 默认每位玩家 10 个商店,玩家之间不能转让商店来绕过这一限制。
    * 防崩溃存储: 商店生物不会随世界保存。它们会在其区块每次加载时从商店数据重建,因此崩溃或意外的 /kill 永远不会丢失商店。
    * 干净卸载: 移除模组后,商店生物就会消失。不会留下游荡的村民,也不会留下损坏的实体。

🔑 LuckPerms 支持

每条命令和操作都有自己的权限节点,并且可以设置按组的商店限制作为 LuckPerms meta。可与 LuckPerms 及任何其他 Fabric 权限模组配合使用,无需额外安装。如果没有权限模组,则回退到原版 OP 等级。

  • 仅限 VIP 的商店:/lp group default permission set shopkeepers.create false
    * 为捐赠者提供更大的限制:/lp group vip meta set shopkeepers.max-shops 25
    * 可以管理任何商店的版主:/lp group mod permission set shopkeepers.bypass true

你设置的节点始终优先于默认值,双向皆然:你可以给普通玩家一项管理员权限,也可以从 OP 那里收回一项权限。

默认所有人拥有

  • shopkeepers.trade — 与商店交易。
    * shopkeepers.create — 使用 Shopkeeper 物品创建玩家商店。
    * shopkeepers.command.list — /shopkeeper list(你自己的商店)。
    * shopkeepers.command.edit — /shopkeeper edit。
    * shopkeepers.command.remove — /shopkeeper remove。
    * shopkeepers.command.transfer — /shopkeeper transfer。

默认 OP 拥有

  • shopkeepers.command.list.others — /shopkeeper list <player|admin|all>。
    * shopkeepers.command.give — /shopkeeper give。非 OP 时,使用玩家名称而非像 @a 这样的选择器。
    * shopkeepers.command.remote — /shopkeeper remote。
    * shopkeepers.command.tp — /shopkeeper tp。
    * shopkeepers.command.reload — /shopkeeper reload。
    * shopkeepers.admin — 创建、编辑和删除管理员商店。
    * shopkeepers.bypass — 编辑、移除和转让任何人的商店,并打开或破坏他们的库存箱。(默认情况下,仅当配置中的 opsBypassProtection 开启时 OP 才会获得此权限,除非你更改,否则它是开启的。)
    * shopkeepers.bypass.limit — 拥有超过限制的商店。
    * shopkeepers.bypass.container — 使用任何箱子作为库存,而不仅仅是你过去 10 分钟内放置的箱子。

Meta

  • shopkeepers.max-shops — 玩家或组可以拥有多少个商店(-1 = 无限)。替换配置中的默认值 10。

潜行 + 右键点击你自己的商店以及编辑器的删除按钮无需命令节点即可使用。

📊 玩家命令(所有人)

省略 [id] 以使用你正在查看的商店。

  • /shopkeeper list — 你的商店,及其 id 和位置。
    * /shopkeeper edit [id] — 从任何地方打开商店的编辑器。
    * /shopkeeper remove [id] — 删除你的一个商店并取回 Shopkeeper。
    * /shopkeeper transfer [id] <player> — 将商店给予另一位玩家。
    * /shopkeeper help — 仅显示你有权使用的命令。

🛠️ 管理员命令(OP,或匹配的权限)

  • /shopkeeper list <player|admin|all> — 任何人的商店、管理员商店或服务器上的每个商店。
    * /shopkeeper give [players] [amount] — 分发 Shopkeeper 物品。
    * /shopkeeper admin [mob] — 在你站立的位置创建一个管理员商店。
    * /shopkeeper remote <id> — 从任何地方打开任何商店的交易界面。
    * /shopkeeper tp <id> — 传送到一个商店。
    * /shopkeeper reload — 无需重启服务器即可重新读取配置文件。

管理员还可以编辑、移除和转让任何玩家的商店,并打开任何库存箱。

⚙️ 配置

config/shopkeepers.json 在首次运行时以默认值写入:商店限制、商店与其箱子之间允许的距离、交易页数、允许的生物、店主交易通知,以及箱子保护、爆炸保护和管理员绕过的开关。编辑它并运行 /shopkeeper reload,无需重启。缺失的键会回退到默认值,因此你的配置在更新后仍然有效。

📦 要求

  • Minecraft 1.21 – 1.21.11(任何 1.21 正式版)
    * Fabric Loader 0.16.0+
    * Fabric API
    * Java 21

一个 jar 适用于所有 1.21 正式版。 将其与 Fabric API 一起放入 mods/,它会自行选择适合你的 Minecraft 版本的构建。更新 Minecraft?保留同一个 jar。商店按世界存储在 world/shopkeepers.dat 中,其交易中的物品会随你世界的其余部分一起升级。

在 1.21 和 1.21.1 上,Shopkeeper 物品是一本发光的知识之书,因为这些版本无法让物品具有刷怪蛋的外观。


如果你需要任何帮助,请在我的 discord 服务器中联系我