🎲 LootEngine

Advanced custom loot drop system for Paper 1.21+ Minecraft servers.

Features

• Custom mob drops — Configure unique items to drop from any mob
• Rarity system — Common, Uncommon, Rare, Epic, Legendary tiers
• Custom items — Display names, lore, enchantments
• Visual effects — Particles and sounds on rare drops
• Legendary broadcasts — Server-wide announcements for legendary drops
• GUI preview — In-game inventory GUI to browse loot tables
• Multi-language — English, Russian, Spanish, German (easily extendable)
• Permission multipliers — VIP/MVP players get bonus drop chances
• World blacklist/whitelist — Control where loot drops work
• Hot reload — Reload config without restarting the server
• Tab completion — Full tab-complete support for all commands
• Extensible config — Detailed config.yml with all settings documented

Commands

Command	Description	Permission
/loot reload	Reload configuration	lootengine.admin
/loot preview <mob>	Open loot table GUI	lootengine.admin
/loot give <mob>	Roll and receive loot	lootengine.admin
/loot stats	View your drop statistics	lootengine.admin

Multi-Language Support

LootEngine supports multiple languages out of the box. Set your language in config.yml:

language: en  # Available: en, ru, es, de

All messages, GUI labels and broadcasts are fully translatable. Add your own language by creating a new file in plugins/LootEngine/lang/.

Configuration

All loot tables are defined in loot.yml:

tables:
  zombie:
    - item: DIAMOND
      chance: 5.0
      amount: 1
      rarity: LEGENDARY
      display-name: "&b&lZombie's Diamond"
      lore:
        - "&7Dropped from a zombie"
        - "&7with a 5% chance"
      enchantments:
        SHARPNESS: 3
      effects:
        particles: true
        sound: ENTITY_PLAYER_LEVELUP

Entry options

Field	Type	Description
item	Material	Bukkit material name
chance	Double	Drop chance (0-100%)
amount	Int or Range	Amount like 1 or 1-3
rarity	Rarity	COMMON, UNCOMMON, RARE, EPIC, LEGENDARY
display-name	String	Custom item name (supports & color codes)
lore	List	Item lore lines
enchantments	Map	Enchantment name → level
effects.particles	Boolean	Show particles on drop
effects.sound	String	Bukkit sound name to play

Installation

1. Download the latest release from Releases
2. Place the .jar in your server's plugins/ folder
3. Start/restart the server
4. Edit plugins/LootEngine/loot.yml to configure drops
5. Use /loot reload to apply changes

Requirements

• Paper 1.21+ (or any Paper fork like Purpur)
• Java 21+

Building

mvn clean package

The compiled jar will be in target/LootEngine-1.0.0.jar

License

MIT License — feel free to use, modify and distribute.