# Lootr Plugin Documentation ## Overview Lootr is a specialized Minecraft server plugin that revolutionizes how loot is distributed in your world. In standard Minecraft, when a player finds a dungeon chest, they take the items, and the chest becomes empty for everyone else. Lootr solves this problem by creating "instanced" loot. When a player opens a Lootr chest, the plugin generates a unique inventory specifically for that player. Other players can open the same physical chest and will see their own unique set of items. This ensures that exploration remains rewarding for all players on a multiplayer server, regardless of who arrived at a structure first. ## Key Functionalities * Unique Loot for Every Player: Every player gets their own loot from every chest. * Automatic Conversion: The plugin automatically detects vanilla chests with loot tables (like those in dungeons, desert temples, and bastions) and converts them into Lootr chests. * Inventory Persistence: If a player leaves items in a Lootr chest, those items will be saved and waiting for them when they return. * Comprehensive Protection: Lootr chests are protected from being broken, moved by pistons, or looted by hoppers to prevent griefing and automation of rare loot. * Visual Indicators: Includes a particle system to highlight chests that a player hasn't looted yet, making exploration more intuitive. ## Installation Guide 1. Download the LootrPlugin.jar file. 2. Place the jar file into your server's 'plugins' folder. 3. Restart your server to generate the configuration files. 4. (Optional) Customize the settings in 'plugins/LootrPlugin/config.yml'. 5. Use '/lootr reload' to apply any changes made to the configuration. ## Version Support The plugin now targets the Paper API for version 26.1.2. What was changed: * Maven now compiles against `io.papermc.paper:paper-api:26.1.2.build.60-stable`. * `plugin.yml` now declares `api-version: '26.1.2'`. Compatibility note: * This codebase only uses stable Bukkit/Paper APIs and no NMS internals, so it is a strong candidate for running on later 26.x server builds. * Actual compatibility for future builds such as 26.2.x or 26.3.x still depends on Paper keeping those APIs binary-compatible. * The repository has been updated and validated against the currently published stable 26.1.2 Paper API. ## Patch Update - July 26, 2026 ### What changed in this patch This update expands Lootr’s container support and improves compatibility with newer server APIs. #### New container support * Lootr now supports chests, barrels, and minecart chests. * Opening these containers now uses the same per-player loot flow and protection logic as regular Lootr chests. #### Compatibility improvements * Added a compatibility layer for newer Paper/Bukkit API behavior. * Updated inventory creation and sound playback handling for better compatibility across modern server versions. * Improved loot-context handling so loot tables are generated more reliably. * Modernized admin command handling to avoid older deprecated lookup patterns. #### Build and manifest updates * The plugin package was verified successfully after these changes. * The project is now better aligned with modern Paper compatibility expectations while preserving existing functionality.

## Version Support The plugin now targets the Paper API for version 26.1.2. What was changed: * Maven now compiles against `io.papermc.paper:paper-api:26.1.2.build.60-stable`. * `plugin.yml` now declares `api-version: '26.1.2'`.

# Lootr Plugin Documentation ## Overview Lootr is a specialized Minecraft server plugin that revolutionizes how loot is distributed in your world. In standard Minecraft, when a player finds a dungeon chest, they take the items, and the chest becomes empty for everyone else. Lootr solves this problem by creating "instanced" loot. When a player opens a Lootr chest, the plugin generates a unique inventory specifically for that player. Other players can open the same physical chest and will see their own unique set of items. This ensures that exploration remains rewarding for all players on a multiplayer server, regardless of who arrived at a structure first. ## Key Functionalities * Unique Loot for Every Player: Every player gets their own loot from every chest. * Automatic Conversion: The plugin automatically detects vanilla chests with loot tables (like those in dungeons, desert temples, and bastions) and converts them into Lootr chests. * Inventory Persistence: If a player leaves items in a Lootr chest, those items will be saved and waiting for them when they return. * Comprehensive Protection: Lootr chests are protected from being broken, moved by pistons, or looted by hoppers to prevent griefing and automation of rare loot. * Visual Indicators: Includes a particle system to highlight chests that a player hasn't looted yet, making exploration more intuitive. ## Installation Guide 1. Download the LootrPlugin.jar file. 2. Place the jar file into your server's 'plugins' folder. 3. Restart your server to generate the configuration files. 4. (Optional) Customize the settings in 'plugins/LootrPlugin/config.yml'. 5. Use '/lootr reload' to apply any changes made to the configuration. ## Patch Update - May 5, 2026 ### Feature: Claim Protection Bypass This update introduces a major improvement to how Lootr interacts with land-claim and region-protection plugins such as GriefPrevention, WorldGuard, Lands, and Towny. #### Problem Solved Previously, if a Lootr chest was located inside a protected claim or region (such as a server spawn, a player's house, or a protected dungeon), protection plugins would cancel the interaction, preventing players from opening the chest even though Lootr is designed to be accessible to everyone. #### Solution Implemented * Dynamic Event Un-cancellation: The plugin now monitors for cancelled interactions at the highest priority. If it detects a player trying to open a Lootr chest in a protected area, it will override the cancellation. * Configurable Bypass: A new setting 'protection.bypass-protection' has been added to config.yml. When set to true, it enables this bypass logic. * Intelligent Filtering: The bypass logic automatically ignores shop chests (QuickShop, etc.) and containers with specific metadata or custom names to ensure that only legitimate Lootr chests are bypassed. * Performance Optimization: The chest verification logic has been refactored into efficient helper methods to ensure that high-traffic servers do not experience lag during interaction checks. #### Configuration Addition Add or update the following in your config.yml: ```yaml protection: bypass-protection: true ``` #### Technical Note This update ensures that the "Always Accessible" philosophy of Lootr is maintained across all claim plugins while still respecting "Break Protections"—meaning players can open the chests in claims, but they still cannot destroy them.

## **Lootr Plugin 1.2.2** Fix Some Know Issue Where Some chest Is not opening.

# Changelog All notable changes to LootrPlugin will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [1.0.0] - 2026-02-09 ### 🎉 Initial Release #### ✨ Added - **Core Functionality** - Per-player unique loot system for structure chests - Automatic detection of vanilla loot table chests (temples, dungeons, ancient cities, etc.) - Virtual inventory system — each player has isolated loot - Persistent data storage (YAML-based) - Auto-save system (configurable interval, default 5 minutes) - **Protection System** - Break protection with admin double-confirm (must break twice within 3 seconds) - Explosion protection (creeper, TNT, bed, respawn anchor) - Hopper extraction protection - Piston push/pull protection - **Visual Features** - Particle effects on unopened chests (configurable type) - Option to show particles only on unlooted chests - Sound effects on chest open/close - **Admin Tools** - `/lootr help` — Command list - `/lootr reload` — Hot-reload config and data - `/lootr info` — View chest information (look at chest) - `/lootr stats` — Plugin statistics (uptime, chests, player entries) - `/lootr clear <player|all>` — Clear loot data - `/lootr reset` — Reset specific chest (everyone gets fresh loot) - `/lootr list [page]` — Paginated list of all registered chests - Tab completion for all commands - **Configuration** - 20+ configurable options in `config.yml` - Per-world disable system - Customizable messages (all chat messages editable) - Adjustable particle types and behavior - Configurable protection features (individually toggleable) - Bypass permission for admins - **Permissions** - `lootr.admin` — Full access - `lootr.break` — Break chests with double-confirm - `lootr.bypass` — See vanilla chest behavior - `lootr.use` — Use Lootr chests (default: true) - **Data Persistence** - `chests.yml` — Stores registered chest locations and loot table info - `playerdata/<uuid>.yml` — Individual player loot data - Async auto-save to prevent lag - Safe shutdown handling #### 🛠️ Technical Details - **Package:** `com.fetal.lootr` - **API Version:** 1.20+ - **Java Version:** 17+ - **Dependencies:** None (standalone) - **File Structure:**

# Lootr **Per-player loot chests for Paper servers. No more loot stealing!** Inspired by the [Lootr Mod](https://modrinth.com/mod/lootr). Every player gets their own unique loot from structure chests. ## Features - 🎁 **Per-player loot** - Same chest, different loot for each player - 🏛️ **Structure support** - Dungeons, temples, mansions, and more - 📦 **Datapack compatible** - Works with custom structure datapacks - 🔒 **Protected** - Anti-break, anti-hopper, anti-explosion - 🛡️ **Gamemode protection** - Survival/Adventure players cannot break chests - ⚡ **OP Double-break** - OP/Admins must break twice to confirm destruction - ⚡ **1.18 - 1.21** - Full Paper compatibility ## How It Works 1. Find a chest in any structure 2. Open it → Get unique loot 3. Other players open same chest → Get their own loot 4. For you, it becomes a normal chest after first open 5. Chest stays protected so other players can still use it ## Commands | Command | Permission | Description | |---------|------------|-------------| | `/lootr` | `lootr.admin` | Main admin command | | `/lootr reload` | `lootr.admin` | Reload config and datapacks | | `/lootr convert` | `lootr.admin` | Convert nearby chests to Lootr | | `/lootr custom` | `lootr.admin` | Create custom Lootr chest | | `/lootr debug` | `lootr.admin` | Debug datapack loot tables | | `/customchest` | `lootr.custom` | Shortcut to create custom chest | ## Permissions - `lootr.admin` - Full admin access - `lootr.custom` - Create custom chests - `lootr.break` - Break Lootr chests - `lootr.bypass` - Bypass all restrictions ## Config ```yaml settings: auto-convert: true particles: true sounds: true loot: refresh-hours: 0 # 0 = one time per player protection: prevent-break: true # Prevent breaking in Survival/Adventure require-permission-to-break: false op-double-break: true # OP must break twice to confirm prevent-hopper: true # Prevent hopper extraction prevent-explosion: true # Prevent explosion damage messages: break-warning: "&c&l[!] &eThis chest is instanced per-player. You cannot break it!"

# Lootr **Per-player loot chests for Paper servers. No more loot stealing!** Inspired by the [Lootr Mod](https://modrinth.com/mod/lootr). Every player gets their own unique loot from structure chests. ## Features - 🎁 **Per-player loot** - Same chest, different loot for each player - 🏛️ **Structure support** - Dungeons, temples, mansions, and more - 📦 **Datapack compatible** - Works with custom structure datapacks - 🔒 **Protected** - Anti-break, anti-hopper, anti-explosion - ⚡ **1.18 - 1.21** - Full Paper compatibility ## How It Works 1. Find a chest in any structure 2. Open it → Get unique loot 3. Other players open same chest → Get their own loot 4. For you, it becomes a normal chest after first open ## Commands | Command | Permission | Description | |---------|------------|-------------| | `/lootr reload` | `lootr.admin` | Reload config | | `/lootr convert` | `lootr.admin` | Convert nearby chests | | `/lootr custom` | `lootr.admin` | Create custom chest | | `/lootr debug` | `lootr.admin` | Debug loot tables | ## Config ```yaml settings: auto-convert: true particles: true loot: refresh-hours: 0 # 0 = one time per player protection: prevent-break: true prevent-hopper: true