Overview#
Lootr (Nobody Misses Out on Loot) is a revolutionary utility mod designed to solve the common multiplayer problem of 'looted' structures. In vanilla Minecraft, once a chest in a dungeon or temple is opened and emptied, it remains empty for all subsequent players. Lootr changes this by converting world-generated containers into instanced versions.
When a player opens a Lootr container, the mod generates a unique inventory specifically for that player based on the original loot table. This means every player who visits a structure will find a fresh set of loot, regardless of how many people have been there before. This encourages exploration and prevents the 'race to the loot' that often plagues public servers.
Visual Indicators#
Lootr containers use a color-coded system to help players identify their status at a glance. These textures are distinct from vanilla containers to ensure players know they are interacting with an instanced object.
| Color | Meaning | Description |
|---|---|---|
| Gold / Yellow | Unopened | The container has not been opened by the current player yet. |
| Silver / Gray | Opened | The container has already been looted by the current player. |
| Green | Refreshed | The container's loot has been regenerated (if the Refresh mechanic is enabled). |
| Blue | Special / Custom | The container was created using the /lootr custom command or is a special event container. |
Note: Players can toggle a client-side configuration to use vanilla textures, though this removes the ability to see if a chest has been opened.
Blocks and Entities#
Lootr automatically converts several types of containers upon world generation or when a player gets close to them.
Containers
- Lootr Chest: Replaces the standard vanilla chest. Double chests are converted into two individual Lootr chests.
- Lootr Trapped Chest: Replaces vanilla trapped chests while maintaining their redstone functionality.
- Lootr Barrel: Replaces vanilla barrels. These are often used in villages and shipwrecks.
- Lootr Shulker Box: Replaces shulker boxes found in End Cities.
- Lootr Inventory: A special block used for custom inventories created by administrators.
Archaeology (1.20.1+)
With the Archaeology update, Lootr now supports brushable blocks and decorative pots:
- Lootr Suspicious Sand & Gravel: These blocks can be brushed by every player to receive unique loot. Once brushed, they change to a 'hollowed out' texture for that player.
- Lootr Loot Pots: Replaces vanilla Decorated Pots. These can be broken or interacted with to receive loot and pottery sherds per player.
Entities
- Lootr Minecart with Chest: Replaces the vanilla chest minecart. Like blocks, these entities track which players have opened them and provide unique loot to each.
Items#
Lootr adds a unique reward for dedicated explorers.
Centennial Trophy (Lootr Trophy)
The Centennial Trophy is a decorative item awarded to players who reach the milestone of opening 100 unique Lootr containers. It serves as a badge of honor for explorers.
- Properties: Decorative block, can be placed on any solid surface.
- Acquisition: Automatically granted to the player upon opening their 100th unique container.
Core Mechanics#
Instancing
When a player interacts with a Lootr container, the mod checks the player's UUID against a list of players who have already opened that specific container. If the player is new, the mod triggers the associated loot table and creates a private inventory for them. This inventory is saved to the world data, ensuring that if the player returns, their items (or lack thereof) are exactly as they left them.
Break Prevention
By default, Lootr containers are indestructible. This prevents players from accidentally (or intentionally) destroying a chest and depriving others of their loot.
- To break a Lootr container, a player must Sneak + Break.
- Breaking a container will only work if it is empty for the player breaking it, or if the server configuration allows it.
Decay System
The Decay system is an optional mechanic where a container will self-destruct after a certain amount of time has passed since it was first opened. This is useful for cleaning up old structures in long-running worlds.
Refresh System
The Refresh system allows containers to regenerate their loot after a configurable period. Once a chest refreshes, its texture changes to Green, indicating to players that new loot is available even if they have opened it before.
Commands#
Lootr provides several commands for server administrators to manage loot and debug issues.
| Command | Description |
|---|---|
/lootr clear <player> |
Resets the 'opened' status for all chests for the specified player. |
/lootr undo <player> |
Undoes the very last chest opening for the specified player. |
/lootr custom |
Converts the vanilla chest the player is standing on into a Lootr Custom Inventory. |
/lootr id |
Displays the internal Lootr ID of the container the player is looking at. |
/lootr openers |
Lists all players who have opened the container the player is looking at. |
/lootr chest [loot_table] |
Spawns a Lootr chest at the player's location with the specified loot table. |
/lootr barrel [loot_table] |
Spawns a Lootr barrel at the player's location with the specified loot table. |
Configuration#
Lootr is highly customizable through its configuration file. Key options include:
- disable_break: (Boolean) If true, players cannot break Lootr containers even while sneaking.
- refresh_min / refresh_max: (Integer) The minimum and maximum time (in ticks) before a chest refreshes its loot.
- decay_min / decay_max: (Integer) The time (in ticks) before a chest decays and disappears after being opened.
- loot_table_blacklist: (List) A list of loot tables that should never be converted into Lootr containers.
- dimension_whitelist / blacklist: (List) Specific dimensions where Lootr should or should not operate.
- report_unresolved_tables: (Boolean) A debug tool that notifies admins if a container fails to find its loot table.
