Chest Refill

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.