OmegaCrates is a premium virtual crate system built for servers that reward players with cosmetics — chat tags, chat colors, and any command-granted reward. It combines a polished roulette spin animation, per-player holograms with live key counts, a pity system, duplicate handling, limited global rewards, and performance-focused bulk opening with automatic reward stacking — all in one lightweight, license-protected plugin.

Core Features

Roulette Spin Animation — a smooth, decelerating scroll lands on the winning reward over ~5 seconds. Every detail is configurable: filler and marker materials, tick and land sounds, scroll steps, hold duration — or disable animation entirely per crate with Spin-Type: NONE.
Per-Player Holograms — built-in, no external hologram plugin required. Each player sees their own floating hologram above the crate showing their live key count. Holos appear on approach and disappear on leave.
Pity System — guarantee a reward tier after a configurable number of opens without hitting it. Separate thresholds for Rare, Epic, and Legendary.
Duplicate Handling — players who already own a cosmetic can REROLL (excluding owned), get their key refunded, receive money, or get nothing. Configurable per crate.
Limited Rewards — cap any reward to N winners worldwide. Once slots fill, the reward is marked SOLD OUT and excluded from rolls. Winner history shown in preview.
Mass Open & Bulk Open — open up to 64 crates at once via shift+left-click or the /ocrates user bulkopen command, with configurable max amount and cooldown.
Automatic Reward Stacking — during bulk opens, identical rewards are combined into a single command (eco give {player} 5000 ×5 becomes eco give {player} 25000). One command per unique reward per bulk open, eliminating command spam and lag on large opens. Per-reward opt-out available.
Scrollable Preview GUI — right-click any crate to browse rewards in a paginated GUI with automatic border framing (top row, bottom row, and side columns), navigation buttons, limited-stock indicators, and winner history. Full &#RRGGBB hex color support in titles, names, and lore.
Command-Based Rewards — every reward runs console or player commands with the {player} placeholder, so rewards work with any plugin that has commands. Custom Model Data supported for resource pack items.

Storage & Performance

YAML — zero setup, per-player files with auto-save
SQLite — single file, ideal for small and medium servers
MySQL — production-ready with connection pooling and configurable pool settings
Async data loading and saving — never blocks the main thread
Offline player support — give keys to players who aren't online
Smart caching with expiry and auto-save intervals

PlaceholderAPI

%omegacrates_keys% — total keys across all crates
%omegacrates_keys_<CrateId>% — keys for a specific crate
%omegacrates_opens_<CrateId>% — total opens for a crate
%keys_<CrateId>% — shorthand, works in any PlaceholderAPI plugin

Commands

/ocrates give <player> <crate> <amount> — give keys to a player
/ocrates giveall <crate> <amount> — give keys to every online player
/ocrates keys <player> <crate> <amount> — set a player's key balance
/ocrates set <crate> — bind the block you're looking at to a crate
/ocrates remove — unbind a crate from a block
/ocrates open <player> <crate> — force-open a crate for a player
/ocrates reload — reload all configuration files
/ocrates reset <player> — reset a player's data
/ocrates user open <crate> — open a crate with a key
/ocrates user bulkopen <crate> <amount> — bulk open with keys

Permissions

omegacrates.admin — full admin access (default: op)
omegacrates.admin.give / giveall / keys / set / remove / open / reload / reset — individual admin nodes
omegacrates.user.open / omegacrates.user.bulkopen — player usage (default: true)
omega.crate.<CrateId> — per-crate access

Requirements

Spigot or Paper 1.20+ (Java 17+)
PlaceholderAPI (optional — for placeholders)
Vault (optional — for money duplicate rewards)

Licensing: OmegaCrates uses EdLicense for secure activation. Only config.yml generates until your license is verified — add your key, restart, and all files generate automatically. Join the Discord to claim your license key.

IMAGES/GIFS

https://youtu.be/sOxKHhmdQEM?si=4cXqvL3UuW3cSXg1

OmegaCrates

About