ChestLootControl

📖 Introduction

ChestLootControl is a lightweight Fabric admin utility mod that gives you full control over the items inside all chests in the world through simple commands. Clear every container in one go, or randomly refill them with fully customizable items—including full NBT support. Perfect for map makers, server admins, and modpack testing.

✨ Features

One-click container clearing: Use /clearallchests to instantly remove all items from every loaded chest, trapped chest, barrel, and shulker box in the world.
Probability-based item filling: Use /fillchests to randomly fill containers with your choice of items at a custom probability.
Fully customizable items: Specify any vanilla item with a configurable quantity range (e.g., minecraft:diamond:1-3).
Full NBT support: Supports the same NBT format as the /give command—add enchantments, potion effects, custom names, and more.
Instant effect, no reloads: Commands take effect immediately; no server reload or chunk reloading required.
Low performance impact: Only iterates over currently loaded chunks, keeping things lightweight and efficient.

📋 Commands

Command	Parameters	Description
`/clearallchests`	None	Clears all items from every container in all loaded chunks
`/fillchests`	`<probability> <item list>`	Fills containers with random items at the specified probability

Permission required: Operator (level ≥ 2)

🎮 Usage

Clear all chests

text

/clearallchests

After execution, all loaded chests are emptied instantly. The chat will display the number of containers cleared.

Fill chests with items

Basic usage – plain items

text

/fillchests 0.8 minecraft:diamond:1-3, minecraft:iron_ingot:5-10

This means 80% of chests will randomly receive either diamonds (1–3) or iron ingots (5–10).

Advanced usage – items with NBT

text

/fillchests 0.5 minecraft:diamond_sword:1 {Damage:0,Enchantments:[{id:"minecraft:sharpness",lvl:3}]}, minecraft:potion:1 {Potion:"minecraft:strong_healing"}

This means 50% of chests will be filled with a Sharpness III diamond sword or an instant health II potion.

Parameter details

Probability: A float between 0.0 and 1.0

0.0 = no chests are modified
0.5 = roughly half of all chests
1.0 = every chest is filled

Item list format:

text

namespace:item_id:min-max [optional NBT]

Multiple items are separated by a comma ,
NBT follows the same syntax as the /give command
Quantities are rolled randomly within the given range

🎯 Use Cases

Adventure map creation – Quickly populate dungeon chests with loot
Server events – Refresh all chests across the server for limited-time events
Survival server management – Periodically clear public chests to prevent item hoarding
Modpack testing – Fill containers with test items without placing them manually
Minigame worlds – Randomize resource distribution for extra replayability

📦 Installation

Install Minecraft 1.20.1 and Fabric Loader 0.14.21 or newer
Install Fabric API
Place the mod's .jar file into your .minecraft/mods/ folder
Launch the game, enter a world, and use the commands

⚙️ Compatibility

Minecraft: 1.20.1
Mod loader: Fabric 0.14.21+
Required dependency: Fabric API
Dedicated server: ✅ Supported
Singleplayer: ✅ Supported (cheats must be enabled)

📝 Notes

Commands only affect containers in currently loaded chunks. Unloaded areas are not processed.
If the world contains a very large number of chests, consider running commands during low server activity to avoid brief lag.
/fillchests will clear the container's existing items before refilling it. Use with care.
When using NBT tags, make sure the format is correct; otherwise the item may fail to generate.

🖼️ Screenshots (Suggested)

Clear command feedback	Fill command feedback
[Screenshot 1: /clearallchests result]	[Screenshot 2: /fillchests result]
[Screenshot 3: Chest before/after clearing]	[Screenshot 4: Chest containing NBT items]

❓ FAQ

Q: Some chests weren't cleared/filled. Why?
A: The command only processes loaded chunks. Move closer to the chests to load their chunks, or use a world preloader mod on servers.

Q: Can I target only a specific area instead of the whole world?
A: The current version works globally. Area-specific targeting is planned for a future update.

Q: Does it support loot tables?
A: Currently, items are defined directly in the command. Loot table integration is on the roadmap.

🔗 Links

Fabric API: https://modrinth.com/mod/fabric-api

📄 License

This project is licensed under the MIT License. You are free to use, modify, and distribute it, as long as you retain the original author notice and release your modifications under the same license.