ChestRefiller
Keeping your Minecraft server’s loot fresh and unpredictable is a constant challenge. Whether you run a survival world, a custom adventure map, or a modded RPG experience, players quickly memorize chest locations and their contents. ChestRefiller solves that by intelligently refilling nearby containers with randomized loot, configurable probabilities, and even exact copies of custom items. It’s a lightweight Bukkit/Spigot plugin designed for Arclight servers, bringing dynamic loot management without lag or chunk loading headaches.
What Makes ChestRefiller Stand Out?
Unlike basic refill plugins that simply restock chests with the same items, ChestRefiller gives you full control over every aspect of the loot table. You can define weighted chances, limit how many of a specific item can appear per container, and decide whether to clear existing contents or only fill empty slots. The plugin works with vanilla chests, trapped chests, and barrels, scanning only loaded chunks around the player to keep performance smooth.
Smart Refill Logic
The core of ChestRefiller is its batched, tick-scheduled scanning system. When a player or admin triggers a refill, the plugin checks containers within a configurable range—but only in chunks that are already loaded. It never force-loads chunks or scans the entire world, so server TPS stays stable. Each container is refilled from a loot pool where every entry has a chancePercent weight. Items are placed in random slots, not sequentially, making every chest feel genuinely discovered. You can set global or per-item stack size ranges (amountMin/amountMax), enforce maxPerItemPerContainer limits, and even allow or disallow duplicates.
Modded Item Support
For servers running modpacks on Arclight 1.21.1, ChestRefiller fully supports namespaced IDs like modid:item_name in both the loot and lootMap configurations. If a modded item isn’t recognized, the plugin safely skips it and logs a console warning—no crashes, no corrupted containers. This makes it a perfect companion for heavily customized modded environments where vanilla loot tables just don’t cut it.
Exact Chest Copying with /savechest
One of the most powerful features is the ability to save an entire container’s contents as a reusable template. Using /savechest <name>, you can capture every non-empty slot—including custom NBT data, lore, enchantments, and item meta—into a savedItems section in the config. Slots are 1-based, so you can later reference them in loot entries with item: 4, savedSlot: 32, or even item: saved:32. This is ideal for quest rewards, dungeon restocking, or preserving hand-crafted items that need to reappear exactly as designed.
How to Install ChestRefiller for Minecraft
Getting started with ChestRefiller is straightforward. First, ensure your server runs on Arclight (or any Bukkit/Spigot-compatible core) with Java 21. No client-side mods are required—this is purely a server-side plugin. Simply download ChestRefiller from your preferred Minecraft plugin repository and place the JAR file into your server’s plugins folder. Restart the server or run a reload command, and the plugin will generate a default configuration file. If you’re using the foxygame.net launcher, you can find ChestRefiller in its curated add-on catalog and install it with a single click, automatically matching the correct version for your server setup. The launcher also keeps ChestRefiller updated, so you’ll always have the latest features without manual file replacements.
Commands and Permissions
ChestRefiller keeps its command set simple but effective:
/chestrefill <range>– Refills all valid containers within the specified block radius around the command sender. Requireschestrefill.usepermission./chestrefill reload– Reloads the configuration from disk without restarting the server. Requireschestrefill.adminpermission./savechest <name>– Saves the exact contents of the targeted container into the plugin’s saved items list. Requireschestrefill.adminpermission.
These permissions can be assigned to player groups or individual operators, giving you fine-grained control over who can trigger refills and manage loot templates.
Why Server Owners Love ChestRefiller
Many loot plugins either overcomplicate the setup or cause performance issues by scanning massive areas. ChestRefiller strikes a perfect balance. Its configurable itemsPerContainer limits (separate for chests and barrels) and clearBeforeRefill option let you decide whether to wipe containers clean or only top off empty slots. The weighted random system ensures variety, while the strict per-item caps prevent overpowered loot stacking. For modded servers, the ability to reference exact saved items means you can restock custom weapons, tools, or quest items with all their NBT data intact—something few other plugins handle gracefully.
Optimizing Your Loot Tables
To get the most out of ChestRefiller, start by editing the generated config.yml. Define your loot pool under the loot section with item IDs and their chancePercent. Use the lootMap for quick weighted entries like diamond: 15 or saved:32: 10. Adjust itemsPerContainer to control how many different item types can appear, and set maxPerItemPerContainer to avoid flooding a chest with a single resource. The plugin’s console warnings will alert you to any invalid item IDs, so you can fine-tune your list without guesswork.
Final Thoughts
ChestRefiller transforms static container loot into a dynamic, replayable experience for your Minecraft server. Its focus on loaded-chunk scanning, modded item compatibility, and exact item preservation makes it a standout choice for both vanilla and modded environments. Whether you’re running a small community server or a large Arclight network, this plugin delivers reliable, lag-free loot randomization. Download ChestRefiller today and give your players a reason to keep exploring every chest and barrel they find.