LexCase

LexCase is a plugin for Paper 1.21.11 that adds a fully featured crate system to your server with virtual keys, holograms, opening animations, and an intelligent luck balancing system.

🎲 Every crate is a mini-game with visual effects, balanced probabilities, and a fair reward system.

Features

• Easy setup — place a crate anywhere in the world with a single command.
• Virtual keys — stored per player and never take up inventory space.
• Beautiful opening animation — crates appear with holograms and rising reward items.
• Configurable rarity system — customize the weight of every rarity (Common, Epic, Mythic, Legendary, and more).
• Smart Luck / Debt System — smooths out extreme winning and losing streaks so players don't get excessively lucky or unlucky.
• Global announcements — broadcast a message whenever a top-tier rarity is obtained.
• Console command rewards — rewards can be given as items or through console commands (such as /give, /eco, etc.).
• YAML storage — all player data, keys, and luck profiles are stored in clean, human-readable YAML files.

Commands

/lc setup — Create a crate at your current location

/lc givekey <player> <amount> — Give virtual keys to a player

/lc removekey <player> <amount> — Remove virtual keys from a player

/lc delete — Remove the crate at your current location

/lc reload — Reload the plugin configuration and data

Players simply right-click the placed crate block to open it (as long as they have at least one key).

Permissions

lexcase.admin — Allows administration of the plugin.

Configuration

All settings are located in plugins/LexCase/config.yml.

The configuration consists of two main sections:

• Crate appearance and animation
• Rarities and rewards

Crate Appearance (case section)

case:
  name: '&6&lLexCase'
  center-hologram-height: 1.00
  open-hologram-height: 1.00
  item-rise-height: 0.00
  chest-close-delay-ticks: 35
  chest-remove-step-ticks: 5
  chest-spawn-step-ticks: 5
  auto-open-step-ticks: 5
  final-reveal-delay-ticks: 60
  open-text: '&2OPEN'
  case-item-text-offset: 0.50

These settings allow you to customize hologram heights, chest animation speed, delays between animation stages, and the text displayed on the OPEN button.

Rarities & Rewards (rarities section)

Example configuration with three rarities:

rarities:
  rare:
    display: '&aRare'
    color: '&a'
    chance: 55
    drops:
      - material: DIAMOND
        name: '&aDiamond'
        amount: 1
        chance: 50
        value: 12
        command: 'give {player} diamond 1'
  epic:
    display: '&bEpic'
    color: '&b'
    chance: 30
    drops:
      - material: EXPERIENCE_BOTTLE
        name: '&bExperience'
        amount: 16
        chance: 70
        value: 25
        command: 'give {player} experience_bottle 16'
  legendary:
    display: '&6&lLegendary'
    color: '&6&l'
    chance: 3
    broadcast-legendary: true
    drops:
      - material: NETHER_STAR
        name: '&6&lNether Star'
        amount: 1
        chance: 60
        value: 260
        command: 'give {player} nether_star 1'

Field Descriptions

• chance — Relative weight of a rarity (higher values make it more likely to be selected).
• drops — List of possible rewards within that rarity. Each reward has its own weighted chance.
• value — Reward value used by the Luck/Debt system. Higher values have a stronger influence on future rolls.
• command — Console command executed after the reward is given. Supports the {player} placeholder.
• broadcast-legendary — If set to true, a global announcement will be sent whenever this rarity is won.

In-Game Preview

1. A player right-clicks a placed crate.
2. A chest appears with a floating hologram displaying OPEN.
3. After clicking the hologram, the opening animation begins:
   • the chest closes,
   • reward items rise out of the chest,
   • after a short moment, one item is highlighted as the winning reward.
4. The player receives the reward (either directly or via a console command), and their personal Luck profile is updated, affecting future crate openings.

Installation

1. Download the plugin .jar file.
2. Place it inside your server's plugins/ folder.
3. Restart your server (or use /reload if appropriate).
4. Stand where you want the crate to be placed and execute /lc setup.
5. Configure the plugin to your liking and reload it using /lc reload.