LemonyDeadSystem

LemonyDeadSystem is a high-performance and fully configurable
death & loot management plugin developed for PvP-focused
Minecraft servers.

When a player is killed, the victim’s entire inventory
(including armor and offhand) is processed safely and
losslessly according to the selected loot system.

Optimized to prevent duplication bugs, item loss,
and performance issues.


==============================
GENERAL FEATURES
==============================

• 3 different loot systems (selectable via config)
• Fully collects the killed player’s:
- Inventory
- Armor
- Offhand item

• GUI-based Killed Chest system
• Single and multiple chest support
• Permission-based chest limits
• Stable performance with high player counts
• PlaceholderAPI support
• ProtocolLib compatibility
• Detailed language & prefix system with HEX color support
• Secure against dupe exploits


==============================
LOOT SYSTEMS
==============================

[System 1] Direct Inventory Transfer
• All items of the killed player are transferred to the killer’s inventory
• If the inventory is full, excess items drop on the ground


[System 2] Single Chest System
• A single chest accessed via the /killedchest command
• Default size: 45 slots (configurable)

Operation Modes:
• When a new player is killed:
- The existing chest is cleared
- New loot is added

• When continuing with the same chest:
- If the chest is full, remaining items drop on the ground


[System 3] Multiple Chest System
• A separate chest is created for each killed player
• GUI title displays the killed player’s name
• Access via /killedchest, /killedchest 2, /killedchest 3, etc.
• Chest limits:
- Config-based
- Permission-based


==============================
COMMANDS
==============================

/killedchest
/kchest
/deathloot
→ Opens loot chests of players you have killed

/lemonydead reload
/lemonydead see <player>
→ Admin management commands


==============================
PERMISSIONS
==============================

lemony.use
→ Permission to use the plugin (default: enabled)

lemony.limit.bypass
→ Bypass chest limits in System 3

lemony.admin
→ Admin commands (reload, see)


==============================
PERFORMANCE & SECURITY
==============================

• Async-safe event handling
• No unnecessary scheduler usage
• Minimal item duplication handling
• Tested on real PvP servers


==============================
USE CASES
==============================

Ideal for PvP, FFA, Duels, BoxPvP, and Survival servers.