VirtualCrates is a lightweight virtual crate key system for Paper servers. Players store keys per crate type and spend them through a clean GUI or on physical crate blocks — no physical key items to lose, dupe or clutter inventories. Every crate is a single YAML file, so you can add as many crates as you want with zero code.
Highlights
- Virtual keys — keys are stored per player and per crate, with give / take / set management and live key counts displayed in menus, lore and holograms.
- Chance-based rewards — each key rolls one reward from a weighted chance table. Rewards run configurable console commands and support %player%, %crate% and %amount%.
- Smart bulk opening — open up to 5,000 keys at once (configurable) via the Drop key in the GUI or sneak + right-click on a placed crate. Identical wins are merged and %amount% is multiplied per reward, so a 5,000-key open runs one command per reward type instead of thousands. Results arrive as one tidy multi-line chat message.
- Fully custom GUIs — the main crates menu, each crate's reward preview, and every item in them are defined in YAML: layouts, slots, fillers, pagination icons, names, lore and materials.
- Per-crate preview GUIs — each crate file defines its own preview title, size, scrollable slots (ranges, lists or single slots), filler, back button and previous/next page icons, including dedicated first-page / last-page items.
- Physical crates — place a crate block with /crates place, open or preview by clicking, and remove it with sneak + break. Each crate defines its own block material and place item.
- Holograms — per-crate DecentHolograms holograms above placed crates with configurable lines, offset and the %crates_<crate>% key placeholder.
- PlaceholderAPI support — %crates_<crate>% exposes every player's key count anywhere placeholders work (scoreboard, chat, tab, menus).
- Everything is configurable — messages, prefix, sounds and command usage are all in messages.yml and config.yml. No hardcoded strings.
Commands
- /crates — open the crates menu
- /crates give <player> <crate> <amount>
- /crates take <player> <crate> <amount>
- /crates set <player> <crate> <amount>
- /crates place <crate> — get a placeable crate block
- /crates reload — reload all configs
Permissions
- virtualcrates.use — open the GUI and open crates (default: true)
- virtualcrates.give / take / set / place / reload — admin management (default: op)
- virtualcrates.admin — all of the above (default: op)
Requirements
- Paper 1.20+
- Optional: PlaceholderAPI and DecentHolograms for placeholders and holograms