✨ LexCase

LexCase is a Minecraft 1.21+ plugin for building a fully configurable case/crate system with virtual keys, weighted rewards, optional luck/debt balancing, localized UI, and a modern admin workflow. 🎁

It is designed for public server use with safe migration paths, strong configuration control, and a focus on reliable long-term maintenance. 🛡️

🌟 Highlights

• 🎯 Custom case setup with /lc setup
• 🧭 Admin GUI for browsing, editing, importing, exporting, and restoring cases
• ✏️ Direct case editor access with Shift + right-click
• 🔑 Case-specific virtual keys stored per player
• 🎬 Animated opening sequence with holograms, reward chests, and visual effects
• ⚖️ Weighted rarities and weighted rewards
• 🧩 Reward commands with {player} placeholder support
• 🍀 Optional luck/debt balancing for long-term reward tuning
• 🌍 Localized messages with safe migration for translated text
• 💾 YAML storage by default, with SQLite available as an opt-in storage mode
• ⏳ Async backup, import, export, and restore with progress feedback
• 🧱 Case templates, preset transfer tools, and admin audit logging
• 🔌 PlaceholderAPI support for dynamic server placeholders
• 📊 Performance tools for session, storage, and case-health diagnostics

✨ What makes version 1.4.0 special

Version 1.4.0 focuses on stability, performance, and safer public-server upgrades. 🚀 It keeps YAML as the default storage path for existing servers while introducing SQLite as a controlled option. 🔄 Locale migration is now resilient, so user customizations survive updates while missing keys are backfilled automatically. 🌍 Visual rendering was also optimized, with lighter holograms and better handling for busy servers. 🎭

📌 Requirements

• Paper/Purpur 1.21.X
• Java 21

⌨️ 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 admin	Open the admin GUI	lexcase.admin.gui
/lc reload	Reload config, locales, storage, and case setups	lexcase.admin
/lc delete	Remove the case setup at your current location	lexcase.admin
/lc givekey <ID> <player> <amount>	Give case-specific virtual keys to a player	lexcase.givekey
/lc removekey <ID> <player> <amount>	Remove case-specific virtual keys from a player	lexcase.givekey

⚙️ Configuration

LexCase uses YAML configuration files by default. The plugin also supports controlled migration paths for runtime storage, locale files, backup/restore flows, and admin tooling.

🎮 Case system

The main case workflow includes:

• animation timings
• hologram height and offsets
• chest spawn and removal delays
• open timeout
• maximum opened chests
• item rise and reveal behavior
• optional player conditions for opening a case
• case templates for cloning full setups

🍀 Luck system

LexCase includes an optional luck system that adjusts 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. The locale migration system is designed to preserve custom user edits while backfilling new bundled keys. 🌍

Available locale files:

• en_US
• ru_RU

🛠️ Support

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