✨ 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_USru_RU
🛠️ Support
For questions, bug reports, or feature requests, use the project's support channels on Modrinth or GitHub. 💬
