Lootr Mod — Guide

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.

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.