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:

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, and this project adheres to Semantic Versioning.

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

Permissions

• lootr.admin - Full admin access
• lootr.custom - Create custom chests
• lootr.break - Break Lootr chests
• lootr.bypass - Bypass all restrictions

Config

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!"