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。
- 无需客户端模组。
ChestRefill
ChestRefill is a loot refill and randomization plugin for Minecraft servers (Arclight/Bukkit).
It refills nearby chests and barrels with configurable probabilities, random slot placement, strict per-container limits, and support for modded items plus exact chest item copy.
Compatible with:
- Arclight 1.21.1 (Bukkit/Spigot API)
What it does
- Scans loaded blocks only around the player in a range.
- Finds containers:
- Chests (single + double)
- Trapped chests
- Barrels
- Refills each container from a config loot pool:
- Weighted chance per entry (
chancePercent)
- Random slot placement (not sequential)
- Supports:
itemsPerContainer (separate chest/barrel)
maxPerItemPerContainer (default + overrides)
allowDuplicates
clearBeforeRefill (fresh refill) or fill only empty slots
- Optional random amount per stack (
amountMin/amountMax or global min/max)
New features
- Modded item support:
- Use namespaced ids like
modid:item_name in loot and lootMap.
- Unknown/invalid ids are skipped safely with console warnings.
- Exact chest item copy (
/savechest):
- Command:
/savechest <x> <y> <z>
- Reads that container and saves non-empty slots into
savedItems in config.
- Preserves exact
ItemStack data (meta/lore/enchants/custom NBT data carried by stack serialization).
- Slot index is 1-based (first slot = 1, fourth slot = 4).
- You can reference saved slots directly in loot:
item: 4
savedSlot: 32
item: saved:32
- Also supported in
lootMap:
4: 25
saved:32: 10
Commands
/chestrefill <range>: Refill nearby containers in range.
/chestrefill reload: Reload config safely.
/savechest <x> <y> <z>: Save exact container contents by slot into savedItems.
Permissions
chestrefill.use: use /chestrefill <range>
chestrefill.admin: use /chestrefill reload and /savechest
Important limits
- Does not scan the whole world.
- Does not force-load chunks.
- Scans only loaded chunks to reduce lag.
- Runs in batched scheduled ticks to avoid freezing.
- Loot output varies per run due to weighted random + limits.
Requirements
- Arclight server with Bukkit/Spigot plugin support.
- Java 21.
- No client mod required.
ChestRefill
ChestRefill es un plugin de refill de loot y aleatorización para servidores Minecraft (Arclight/Bukkit).
Rellena cofres y barriles cercanos con probabilidades configurables, slots aleatorios, límites estrictos por contenedor, y soporte para ítems de mods + copiado exacto de cofre.
Compatible con:
- Arclight 1.21.1 (API Bukkit/Spigot)
¿Qué hace?
- Escanea solo bloques cargados alrededor del jugador.
- Encuentra contenedores:
- Cofres (simples + dobles)
- Cofres trampa
- Barriles
- Rellena cada contenedor desde un loot pool en config:
- Probabilidad ponderada por entrada (
chancePercent)
- Colocación en slots aleatorios (no secuencial)
- Soporta:
itemsPerContainer (separado cofre/barril)
maxPerItemPerContainer (default + overrides)
allowDuplicates
clearBeforeRefill (vaciar y refill fresh) o solo slots vacíos
- Cantidades aleatorias por stack (
amountMin/amountMax o min/max global)
Novedades
- Soporte de ítems modded:
- Puedes usar ids con namespace como
modid:item_name en loot y lootMap.
- Si un id no existe, se ignora sin crashear y se muestra warning en consola.
- Copia exacta de ítems de cofre (
/savechest):
- Comando:
/savechest <x> <y> <z>
- Lee el contenedor y guarda los slots no vacíos en
savedItems dentro de la config.
- Conserva el
ItemStack exacto (meta/lore/enchants/NBT personalizado serializable).
- Los slots son 1-based (primer slot = 1, cuarto slot = 4).
- Puedes referenciar esos slots guardados en loot:
item: 4
savedSlot: 32
item: saved:32
- También en
lootMap:
4: 25
saved:32: 10
Comandos
/chestrefill <rango>: rellena contenedores cercanos.
/chestrefill reload: recarga config de forma segura.
/savechest <x> <y> <z>: guarda el contenido exacto del contenedor por slot en savedItems.
Permisos
chestrefill.use: usar /chestrefill <rango>
chestrefill.admin: usar /chestrefill reload y /savechest
Límites importantes
- No escanea el mundo completo.
- No fuerza carga de chunks.
- Solo escanea chunks ya cargados para minimizar lag.
- Usa escaneo por lotes por tick para evitar congelar el servidor.
- El loot varía según probabilidad ponderada y límites configurados.
Requisitos
- Servidor Arclight con soporte Bukkit/Spigot.
- Java 21.
- No requiere mod en cliente.
评论 0
登录后参与评分
还没有评论,来抢沙发吧