Lootr 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.