✨ LexCase

LexCase is a Paper 1.21.11 plugin for Minecraft that adds a customizable case/crate system with virtual keys, animated openings, weighted rewards, and optional luck balancing. 🎁

Built for released server use — not for source-code documentation.

---

🌟 Features

• 🎯 Custom case setup with /lc setup
• 🔑 Virtual keys stored per player
• 🎬 Animated opening sequence with holograms and surrounding reward chests
• ⚖️ Weighted rarities and weighted rewards
• 🧩 Reward commands with {player} placeholder support
• 🍀 Optional luck system for long-term reward balancing
• 📣 Legendary broadcast support
• 🌍 Localized text files
• 💾 YAML-based persistence for setups, keys, and luck data

---

📌 Requirements

• Paper 1.21.X
• Java 21

---

🚀 Installation

1. Download the latest release.
2. Put the .jar file into your server’s plugins folder.
3. Start or restart the server.
4. Use /lc setup to create your first case.

---

⌨️ Commands

Command	Description	Permission
/lc help	Show the plugin help menu	None
/lc setup	Create or update a case at your current location	lexcase.admin
/lc reload	Reload config, locales, keys, luck data, and case setups	lexcase.admin
/lc delete	Remove the case setup at your current location	lexcase.admin
/lc givekey <player> <amount>	Give virtual keys to a player	lexcase.givekey
/lc removekey <player> <amount>	Remove virtual keys from a player	lexcase.givekey

---

🎲 How it works

A case is placed at a single block location and becomes the center of the setup. Players use keys to open it and receive rewards based on the configured rarity pools and drop weights.

Each reward can also run a console command, and the {player} placeholder will be replaced with the player’s name.

---

⚙️ Configuration

LexCase uses YAML configuration files to control its behavior.

Case settings

The main plugin settings include:

• animation timings
• hologram height and offsets
• chest spawn and removal delays
• open timeout
• maximum opened chests
• item rise and reveal behavior

🍀 Luck system

LexCase includes an optional luck system that changes future reward chances based on previous results. It uses:

• balance values
• rare bonus tracking
• tier debt tracking
• per-roll decay and gain values

🎁 Rewards

Rewards are organized by rarity. Each reward can define:

• item material
• display name
• amount
• chance weight
• value
• command
• lore

---

🌐 Locales

LexCase supports localized messages through language files.

Available locale files:

• en_US
• ru_RU

---

💾 Data files

The plugin stores its data in YAML files inside the plugin folder, including:

• case setups
• player keys
• luck profiles

---

🛠️ Support

For questions, bug reports, or feature requests, please use the project’s official support channels on Modrinth or GitHub.

---

📄 License

Released under the project’s license.