✨ LexCase

LexCase is a highly configurable case & crate plugin for Paper/Purpur 1.21.11, built around flexible rewards, virtual keys, animated openings, long-term luck, player recovery tools, and a full in-game administration system.

Create cases with custom rarities and weighted rewards, tune every part of the opening experience, manage your entire setup through GUIs, and safely run LexCase on long-term public servers.

🚀 LEXCASE 1.6.0 — UPGRADER IS HERE

⚡ Risk your item. Choose your target. Spin the wheel.

LexCase 1.6.0 introduces a completely new Upgrader system.

Put an item into the Upgrader, choose what you want to turn it into, pay the required cost, and risk the item in a single ALL IN attempt.

🎯 Configurable success chances 💰 Money, item or free attempts 📈 Automatic upgrade targets based on item values 🎰 Player-only Roulette animation with accelerating and slowing spin 🔊 Speed-adaptive spin sounds 🟢 Clear WIN / LOSS zones ● Precision pointer with visual distance to the winning zone ⚙️ LOW / MEDIUM / HIGH particle detail presets

Open it with:

/upgrader or /lc upgrader

The actual result is determined before the animation starts. The Roulette is purely visual, meaning the animation never changes the configured probability.

🌟 Features

🎰 NEW — Upgrader

Turn one item into a more valuable target through a configurable risk/reward system.

The Upgrader is designed around an ALL IN mechanic:

Insert one input item
Select a target reward
See the exact success chance before starting
Review the required cost
Start one attempt
WIN → receive the selected result
LOSE → lose the input item

Every attempt is resolved independently.

Automatic upgrade targets

LexCase can automatically generate available upgrade targets from:

plugins/LexCase/upgraders_cost.yml

Instead of creating every possible upgrade recipe by hand, LexCase compares configured item values and generates higher-value targets automatically.

You can also create custom Upgrader definitions through the admin GUI for cases where you need specific inputs, results, chances, costs or animation settings.

Flexible costs

Each upgrade target can use:

FREE
MONEY via Vault
ITEMS

Costs are fully configurable per target.

Multipliers & filters

Upgrade targets can be grouped and filtered by configurable value tiers such as:

1.5x · 2x · 5x · 10x

Targets are organized by multiplier and success chance to make large upgrade pools easier to navigate.

🎰 Player-only Roulette

The Upgrader features a dedicated roulette-style animation visible only to the player performing the attempt.

The animation includes:

Multiple high-speed rotations
Acceleration and deceleration
A solid color-coded WIN / LOSS wheel
A precision pointer dot positioned on the outer edge
A visual pointer circumference around the wheel edge
A central display of the target item
Speed-adaptive spin sounds
Near-miss visual outcomes
Final WIN or LOSE result presentation
Configurable particle detail

The visual result is intentionally designed to show not only whether the player won, but also how close the pointer stopped to the winning zone.

⚙️ Particle detail presets

Particle density can be adjusted without changing the gameplay logic:

LOW · MEDIUM · HIGH

This allows server owners to choose between a lighter visual effect and a denser, more detailed roulette depending on the environment and player count.

🎁 Flexible Case System

Create, place and manage custom cases directly in-game.

Create and update cases with /lc setup
Configure opening behaviour and visual presentation
Configure holograms, chest timing and item reveals
Configure opening conditions and permissions
Test case rolls without consuming keys
Clone and manage case setups through admin tools
Edit cases directly with Shift + right-click when enabled

🎬 Animated Case Openings

LexCase gives server owners control over the entire opening sequence.

Configure:

Opening timing
Chest spawning and removal
Auto-opening intervals
Reward reveal delays
Hologram positions
Item presentation
Maximum opened chests
Opening timeout
Animation skipping permissions

The opening system is designed around configurable timings rather than a fixed visual sequence.

🎲 Weighted Rewards & Custom Rarities

Build loot systems from the ground up.

Each rarity can define:

Display name
Color
Tier
Weight / chance
Rewards
Legendary broadcast behaviour

Each reward can define:

Material
Display name
Amount
Chance
Value
Command

Reward commands support:

{player}

Rarity tiers are configurable and are not limited to the default four levels.

🍀 Luck & Tier Debt

LexCase includes an optional long-term luck system designed to influence future case rolls based on previous results.

Configure:

Luck balance
Balance limits
Per-tier boosts
Per-tier penalties
Rare bonus accumulation
Rare bonus decay
Tier debt accumulation
Tier debt decay
Bonus consumption and spending
Custom rarity tiers

The system can be tuned extensively or disabled completely.

🔑 Virtual Case Keys

Keys are stored digitally per player and per case.

Administrators can:

Give case-specific keys
Remove case-specific keys
Check player key balances
Manage keys independently for each case

Case openings use exact key consumption:

all required keys are consumed, or none are.

This prevents partial key consumption when an opening cannot start.

🧰 Full Admin GUI

LexCase provides an in-game workflow for managing the plugin without constantly editing YAML by hand.

Available tools include:

Case browser
Case editor
Loot table editor
Reward editor
Rarity editor
Visual editor
Conditions editor
Upgrader manager
Upgrader editor
Upgrader option editor
Upgrader cost editor
Test mode
Import / export tools
Backup / restore tools
Runtime dashboard
Health diagnostics

Most changes are saved immediately.

🛡️ Reward Recovery

LexCase can persist rewards that could not be delivered immediately.

Pending rewards can occur when:

The player is offline
The inventory cannot accept the item reward
A reward command fails
A temporary delivery issue occurs

Players can manage them with:

/lc rewards

Pending rewards can also be retried automatically when the player joins.

📜 Case History

Successful case openings can be stored in persistent history.

Players can use:

/lc history

or:

/lc history <case-id>

History can include:

Case
Rarity
Reward
Amount
Timestamp
Total opening count

📊 Runtime Diagnostics

Administrators can quickly inspect the current state of LexCase.

/lc status

Shows a compact runtime overview including:

Cases
Rarities
Rewards
Keys
Pending rewards
Active sessions
Storage mode
Upgraders

/lc health

Checks the main plugin subsystems and reports their current state.

💾 Storage & Data Safety

LexCase uses YAML storage by default and supports SQLite for supported player data.

Built-in data safety features include:

Atomic writes
Automatic backup copies
Async backup and import/export operations
Backup and restore tools
Migration support
Schema protection
Locale migration
Progress feedback for long-running admin operations

The plugin is designed to keep existing server data intact during supported upgrades.

🔄 Safe Reloads & Upgrades

/lc reload

does not normally interrupt active case sessions.

If active sessions are running, a normal reload is blocked until they finish.

Administrators can explicitly use:

/lc reload force

to finalize active sessions before reloading.

LexCase also performs in-place data migrations for supported version upgrades and creates migration backups before changing important data layouts.

🌍 Localized UI

LexCase supports YAML-based localization.

Bundled locales:

en_US
ru_RU

Custom translations are preserved during locale updates while missing bundled keys can be restored automatically.

🔌 PlaceholderAPI

When PlaceholderAPI is installed, LexCase provides placeholders for case, player and runtime information.

Examples:

%lexcase_keys_<case>%
%lexcase_case_opens_<case>%
%lexcase_total_keys%
%lexcase_player_total_opens%
%lexcase_history_total%
%lexcase_player_luck_bonus%
%lexcase_player_luck_balance%
%lexcase_player_luck_tier_debt%
%lexcase_pending_rewards%
%lexcase_pending_reward_count%
%lexcase_active_sessions%
%lexcase_case_count%
%lexcase_rarity_count%
%lexcase_reward_count%

Perfect for:

Scoreboards
TAB
Holograms
Menus
Custom HUDs
Other PlaceholderAPI-supported plugins

⌨️ Commands

Player

Command	Description
`/upgrader`	Open the LexCase Upgrader
`/lc upgrader`	Open the LexCase Upgrader
`/lc keys [ID]`	View stored case keys
`/lc rewards`	Retry and claim pending rewards
`/lc history [ID]`	View recent case history
`/lc help`	Show available LexCase commands

Administrator

Command	Description
`/lc setup`	Create or update a case at your current location
`/lc admin`	Open the LexCase admin GUI
`/lc status`	Show runtime statistics
`/lc health`	Check core subsystem health
`/lc reload [force]`	Reload configuration and data
`/lc delete`	Remove the case setup at your current location
`/lc givekey <ID> <player> <amount>`	Give case-specific keys
`/lc removekey <ID> <player> <amount>`	Remove case-specific keys

⚙️ Configuration

LexCase is heavily configurable.

Case system

Configure:

Opening timing
Chest behaviour
Holograms
Item presentation
Opening timeout
Maximum opened chests
Conditions and permissions
Animation skipping

Rewards

Configure:

Rarity weights
Custom rarity tiers
Reward chances
Reward amounts
Names and lore
Reward values
Commands
Legendary broadcasts

Luck

Configure:

Balance
Boosts
Penalties
Rare bonus
Tier debt
Decay
Consumption rules

Upgrader

Configure:

Enabled / disabled state
Animation type
Roulette duration
Number of rotations
Particle detail
Wheel radius
Pointer position
Pointer visibility
Pointer circumference
Spin sound cadence
Result hold time
Near-miss behaviour
Final wobble
Target margin

Example:

upgrader-settings:
  enabled: true
  animation: ROULETTE

  roulette:
    duration-ticks: 105
    turns-min: 5
    turns-max: 7
    redraw-interval-ticks: 3

    # LOW / MEDIUM / HIGH
    particle-detail: MEDIUM

    radius: 1.55

    pointer-offset: 0.02
    pointer-depth-offset: 0.14
    pointer-scale: 1.60

    pointer-ring:
      enabled: true
      radius-offset: 0.11
      outer-border: 0.035

    spin-sound:
      enabled: true
      fast-interval-ticks: 1
      slow-interval-ticks: 5
      reference-speed-deg-per-tick: 18.0
      volume-min: 0.20
      volume-max: 0.34

    center-distance: 4.0
    vertical-offset: 0.10
    result-hold-ticks: 14

    target-margin-degrees: 1.35
    near-miss-max-degrees: 4.5

    wobble:
      enabled: true
      amplitude-degrees: 1.15
      damping: 6.0
      frequency: 4.2

🧩 Upgrader Example

A custom Upgrader can look like this:

upgraders:
  iron-upgrader:
    enabled: true

    input:
      material: IRON_INGOT
      amount: 1

    animation: ROULETTE

    options:
      - result:
          material: GOLD_INGOT
          amount: 1
        chance: 35.0
        multiplier: 1.5
        cost-type: MONEY
        cost-amount: 250

      - result:
          material: DIAMOND
          amount: 1
        chance: 5.0
        multiplier: 5.0
        cost-type: ITEMS
        cost-items:
          - material: GOLD_INGOT
            amount: 3
          - material: EMERALD
            amount: 2

📦 Requirements

Minecraft Java Edition 1.21.11
Paper or Purpur
Java 21

Optional integrations:

PlaceholderAPI — placeholders
Vault — money-based Upgrader costs

📁 Data & Backups

LexCase keeps its runtime data inside:

plugins/LexCase/

Important data can include:

Case configuration
Player keys
Luck data
Case history
Pending rewards
SQLite database
Backups
Migration records
Locale files
Upgrader configuration
Upgrader item values

🚀 What's Next?

LexCase is actively evolving, and 1.6.0 is only the beginning. More improvements and new features are planned for future updates.

🎰 Upgrader Improvements

Command rewards — use commands as Upgrader results for deeper server-side integrations
Custom & modified items — support custom items with unique names, lore, model data, enchantments and other modifications
Expanded Upgrader mechanics — more flexible upgrade rules, options, costs and outcome systems
Improved UI/UX — cleaner interfaces, better navigation and a more polished Upgrader experience

⚙️ Plugin Improvements

Performance & optimization across the plugin
Improved administration experience with more convenient tools and workflows
Improved player experience across cases, rewards, keys and Upgrader
More customization options for server owners
Additional integrations and quality-of-life features
Continuous bug fixing, refinement and polishing

And, of course, much more is planned as LexCase continues to grow.

📜 License

LexCase is released under the MIT License.

🛠️ Support

For bug reports, feature requests, questions and development discussion, use the project's GitHub, Modrinth issue tracker, wiki or Discord.

When reporting a problem, include:

LexCase version
Minecraft version
Paper/Purpur version
Relevant console errors
Configuration section related to the issue

❤️ Built for servers that want more than a basic crate plugin.

Cases for your economy. Luck for long-term progression. An Upgrader for high-risk decisions.

LexCase | UPGRADER UPDATE

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

✨ LexCase

🚀 LEXCASE 1.6.0 — UPGRADER IS HERE

⚡ Risk your item. Choose your target. Spin the wheel.

🌟 Features

🎰 NEW — Upgrader

Automatic upgrade targets

Flexible costs

Multipliers & filters

🎰 Player-only Roulette

⚙️ Particle detail presets

🎁 Flexible Case System

🎬 Animated Case Openings

🎲 Weighted Rewards & Custom Rarities

🍀 Luck & Tier Debt

🔑 Virtual Case Keys

🧰 Full Admin GUI

🛡️ Reward Recovery

📜 Case History

📊 Runtime Diagnostics

💾 Storage & Data Safety

🔄 Safe Reloads & Upgrades

🌍 Localized UI

🔌 PlaceholderAPI

⌨️ Commands

Player

Administrator

⚙️ Configuration

Case system

Rewards

Luck

Upgrader

🧩 Upgrader Example

📦 Requirements

📁 Data & Backups

🚀 What's Next?

🎰 Upgrader Improvements

⚙️ Plugin Improvements

📜 License

🛠️ Support

❤️ Built for servers that want more than a basic crate plugin.