LootGenerator

A flexible and configurable loot generation system for Spigot servers. This plugin allows you to create, manage, and control custom loot with precision using an intuitive GUI and chat-based editor.

---

Features

• Custom loot creation directly from in-game items
• Configurable chance (%) and weight
• World-based loot filtering
• Real vs theoretical drop statistics
• Smart loot selection using weighted random
• Fully interactive GUI system
• Chat-based editing system (no commands spam)
• Live reload support

---

Commands

Command	Description
/loot	Opens the loot menu
/loot list	Opens the loot list
/loot create	Creates a loot from the item in hand
/loot reload	Reloads all loot data

---

Permissions

Permission	Use
alc.admin	admin commands

---

How It Works

1. When a chest generates loot, the plugin:

   • Filters loot by world
   • Rolls chance for each loot
   • Collects valid entries
   • Picks one using weighted random

2. The selected loot is added to the chest.

---

Loot System

Each loot entry supports:

• Chance (%) → Probability of being considered
• Weight → Priority when multiple loots pass the chance
• Min/Max Amount → Stack size range
• World List → Where the loot can spawn

---

GUI System

The plugin includes multiple menus:

• Loot List Menu

  • View all loots
  • See stats (chance, weight, drops, averages)

• Loot Edit Menu

  • Edit chance, weight, amount
  • Manage worlds
  • Remove loot

• World Selector Menu

  • Enable/disable worlds per loot

---

Chat Editor

Certain actions use chat input instead of commands:

• Edit chance
• Edit weight
• Edit min/max amount

The next message you send will be captured and processed.

---

Demo Video

https://youtu.be/K5-chYHrkAA

---

Requirements

• Java 21+
• Spigot / Paper 1.20+
• AllianceUtils download here

---

Installation

1. Download the plugin .jar
2. Place it in your /plugins folder
3. Start the server
4. Use /loot to begin

---

License

This project uses the AllianceUtils license: https://github.com/Joseplay1012/Allianceutils/blob/master/LICENSE.txt

---

Credits

• Core API: https://github.com/Joseplay1012/Allianceutils

---

Notes

• The system uses a hybrid model (chance + weight), allowing fine-tuned balancing
• Real-time statistics help you understand actual drop behavior
• Designed for scalability and clean integration

---

Future Improvements

• Config file support (YAML)
• Multiple loot per chest
• Global drop limits
• GUI animations