Chest Refill

插件

· 作者 zJuqni

ChestRefill 是一款用于 Minecraft 服务器的战利品补充与随机化插件。它允许你通过可配置的几率、随机槽位放置以及严格的每容器限制来补充附近的箱子和 barrels。由 zJuqni 创建

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.3 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

ChestRefill

ChestRefill 是一款适用于 Minecraft 服务器(Arclight/Bukkit)的战利品补充与随机化插件。
它会以可配置的概率、随机槽位放置、严格的单容器限制,并支持模组物品及精确复制战利品箱内容的方式,刷新附近的箱子和** barrels**。

兼容版本:

  • Arclight 1.21.1 (Bukkit/Spigot API)

功能说明

  • 仅扫描玩家周围范围内的已加载区块。
  • 识别以下容器:
  • 箱子(单格 + 双格)
  • 陷阱箱
  • 木桶 (Barrels)
  • 从配置好的战利品池中为每个容器补充物品:
  • 每项条目具有加权概率 (chancePercent)
  • 随机槽位放置(非顺序填充)
  • 支持配置项:
  • itemsPerContainer(分别针对箱子和木桶设置)
  • maxPerItemPerContainer(默认值 + 覆盖值)
  • allowDuplicates(是否允许重复)
  • clearBeforeRefill(清空后重新补充)或仅填充空槽位
  • 可选的每堆叠数量随机范围(amountMin/amountMax 或全局最小/最大值)

新功能

  • 模组物品支持:
  • 在 loot 和 lootMap 中使用命名空间 ID,格式如 modid:item_name。
  • 未知或无效 ID 将被安全跳过,并在控制台发出警告。
  • 精确复制战利品箱内容 (/savechest):
  • 命令:/savechest <x> <y> <z>
  • 读取指定坐标的容器,并将其非空槽位保存至配置文件的 savedItems 中。
  • 保留完整的 ItemStack 数据(包括元数据、描述文本、附魔以及通过序列化携带的自定义 NBT 数据)。
  • 槽位索引为从 1 开始计数(第一个槽位 = 1,第四个槽位 = 4)。
  • 你可以在战利品配置中直接引用已保存的槽位:
  • item: 4
  • savedSlot: 32
  • item: saved:32
  • lootMap 中也支持相同语法:
  • 4: 25
  • saved:32: 10

命令

  • /chestrefill <range>:刷新指定范围内的附近容器。
  • /chestrefill reload:安全重载配置文件。
  • /savechest <x> <y> <z>:按槽位保存容器的精确内容至 savedItems。

权限

  • chestrefill.use:使用 /chestrefill <range>
  • chestrefill.admin:使用 /chestrefill reload 和 /savechest

重要限制

  • 不会扫描整个世界。
  • 不会强制加载区块。
  • 仅扫描已加载的区块以减少延迟。
  • 采用分批计划任务执行,避免服务器卡顿。
  • 由于加权随机和限制条件,每次运行的战利品输出可能不同。

要求

  • 支持 Bukkit/Spigot 插件的 Arclight 服务器。
  • Java 21。
  • 无需客户端模组。

ChestRefill

ChestRefill 是一款用于 Minecraft(Arclight/Bukkit)服务器的战利品补充与随机化插件。
它使用可配置的权重、随机槽位、每个容器严格限制数量,并支持模组物品 + 精确复制箱子内容,来填充附近的箱子和木桶。

兼容:

  • Arclight 1.21.1(Bukkit/Spigot API)

功能说明

  • 仅扫描玩家周围的已加载区块。
  • 识别以下容器:
  • 普通箱子(单格 + 双格)
  • 陷阱箱
  • 木桶
  • 从配置中的战利品池为每个容器补充物品:
  • 基于条目权重的填充概率(chancePercent)
  • 将物品放置到随机槽位(非顺序排列)
  • 支持以下设置:
  • itemsPerContainer(分别针对箱子/木桶设定)
  • maxPerItemPerContainer(默认值及覆盖配置)
  • allowDuplicates(是否允许重复物品)
  • clearBeforeRefill(清空后重新填充新鲜战利品,或仅填充空槽位)
  • 每堆物品的数量随机(通过 amountMin/amountMax 或全局 min/max 控制)

更新内容

  • 支持模组物品:

  • 你可以在 loot 和 lootMap 中使用带有命名空间的 ID,例如 modid:item_name。

  • 如果某个 ID 不存在,系统将忽略它而不会崩溃,并在控制台中显示警告信息。

  • 精确复制箱子中的物品(/savechest):

  • 命令:/savechest <x> <y> <z>

  • 读取容器并将非空槽位保存至配置中的 savedItems 内。

  • 保留完整的 ItemStack(包括元数据、描述文本、附魔以及可序列化的自定义 NBT)。

  • 槽位编号从 1 开始(第一个槽位 = 1,第四个槽位 = 4)。

  • 你可以引用 loot 中保存的这些槽位:

  • item: 4

  • savedSlot: 32

  • item: saved:32

  • 在 lootMap 中也适用:

  • 4: 25

  • saved:32: 10

命令

  • /chestrefill <rango>:填充附近的容器。
  • /chestrefill reload:安全地重新加载配置。
  • /savechest <x> <y> <z>:将容器的每个槽位的精确内容保存到 savedItems 中。

权限

  • chestrefill.use:使用 /chestrefill <rango>
  • chestrefill.admin:使用 /chestrefill reload 和 /savechest

重要限制

  • 不会扫描整个世界。
  • 不会强制加载区块(chunks)。
  • 仅扫描已加载的区块,以最小化卡顿(lag)。
  • 使用每刻(tick)批量扫描,以避免服务器冻结。
  • 战利品(loot)会根据加权概率和设定的限制而变化。

要求

  • 支持 Bukkit/Spigot 的 Arclight 服务器。
  • Java 21。
  • 无需客户端模组。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源