Cryo Series · Animated crate plugin
Pick, CSGO row, and roulette openings — keys, preview,
instant/bulk open, physical crates, and MiniMessage GUIs.
$9.99 USD · one-time · Paper / Spigot 1.8 – 1.26.x · Folia
================================================================================
OVERVIEW
================================================================================
CryoCrates is the Cryo Series crate plugin for Paper and Spigot. Three animation
styles, a player main menu, virtual keys, reward preview GUIs, instant open,
bulk open, per-crate open cooldowns, and world-placed physical crates with
particles and holograms — all in one jar. GUIs and chat use MiniMessage with
the Vertex palette. Optional PlaceholderAPI for scoreboards and menus.
3 animation types | 3 storage backends | Folia supported
YAML GUIs & locale | Hot reload | PlaceholderAPI (optional)
================================================================================
PLATFORMS
================================================================================
Paper · Spigot · Folia
Minecraft 1.8 through 1.26.x
Soft dependency: PlaceholderAPI
================================================================================
FEATURES
================================================================================
[Main menu] /crates hub — crate grid, live key counts, preview shortcuts,
instant-open toggle, bulk-open amount cycle, close button
[Animations] Three crate types per definition:
· pick — choose 1 of N weighted rewards (instant optional)
· csgo — horizontal item row, slow-down near win, win hold
· roulette — single-slot spin with slow-down and win hold
Close mid-animation → pre-rolled reward still grants
[Keys] Virtual keys per crate, stored per player (not physical items)
Give, take, balance check via commands
Keys consumed per open (respects keys-per-open per crate)
[Preview] Framed reward preview GUI — weighted prizes, chance % lore,
open-from-preview button, back to main menu
[Instant open] Per-player toggle in main menu — skips roll screens where
supported (pick crates grant immediately)
[Bulk open] Cycle amounts 1 / 2 / 5 / 10 from main menu — opens in sequence,
one key per open. Cooldown crates force bulk amount to 1
[Cooldowns] Per-crate open-cooldown-seconds (e.g. daily crate = 86400s)
Persisted in database · staff bypass permission per crate
[Physical] Bind crate types to world blocks — particle effects, floating
MiniMessage holograms (per-player on modern versions),
left-click open, right-click preview (configurable)
[Rewards] Weighted reward pools — command lists, optional broadcast
messages on win, custom display items (name/lore/material)
[Storage] SQLite (default), MySQL, or MongoDB — JDBC/Mongo drivers
download at runtime from Maven Central into libraries/
[Locale] Centralized messages.yml with MiniMessage — reload without
restart. Config versioning merges new keys on upgrade
[Sounds] Per-action sounds (menu, roll, win, no-keys, etc.) in config
================================================================================
EXAMPLE CRATES (shipped defaults)
================================================================================
vote type: pick permission: cryocrates.crate.vote
Pick 1 of 3 rewards · 1 key per open · no cooldown
premium type: csgo permission: cryocrates.crate.premium
CSGO row animation · 1 key per open · jackpot broadcast optional
daily type: roulette permission: cryocrates.crate.daily
Single-slot roulette · 1 key per open · 24h open cooldown
Bypass: cryocrates.crate.daily.bypass-cooldown
Custom crates: add under crates.definitions in config.yml — permission
defaults to cryocrates.crate.<id> unless overridden
================================================================================
COMMANDS
================================================================================
Aliases: /crates · /ccrates · /cryocrates
Player
/crates Open main crate menu (same as /cryocrates)
/cryocrates open Open main crate menu
/cryocrates keys List your key balances for all crates
Admin — keys
/cryocrates keys give <player> <crate> [amount]
Give virtual keys (default amount: 1)
/cryocrates keys giveall <crate> [amount]
Give keys to all online players
/cryocrates keys take <player> <crate> [amount]
Remove virtual keys
Admin — physical crates
/cryocrates physical set <id> <crate>
Bind looked-at block (within 5 blocks) as a
physical crate location with hologram + particles
/cryocrates physical remove <id>
Remove a saved physical crate location
/cryocrates physical list List all saved physical crate locations
Admin — maintenance
/cryocrates reload Reload config, locale, GUIs, crates, storage
================================================================================
PERMISSIONS
================================================================================
Base
cryocrates.use Base command access (default: true)
└─ cryocrates.open Open main menu (default: true)
Admin (cryocrates.admin — default: op, grants all below)
cryocrates.reload Reload plugin
cryocrates.keys.give Give keys to players
cryocrates.keys.giveall Give keys to all online players
cryocrates.keys.take Remove keys from players
cryocrates.physical.set Bind physical crate locations
cryocrates.physical.remove Remove physical crate locations
cryocrates.physical.list List physical crate locations
Per-crate (default config — customize per crate in config.yml)
cryocrates.crate.vote Open / see vote crate (default: true)
cryocrates.crate.premium Open / see premium crate (default: true)
cryocrates.crate.daily Open / see daily roulette crate (default: true)
cryocrates.crate.daily.bypass-cooldown
Bypass daily crate open cooldown (default: op)
Custom crates
cryocrates.crate.<id> Gate access to crate <id> (config default)
cryocrates.crate.<id>.bypass-cooldown
Bypass open cooldown for crate <id>
================================================================================
PLACEHOLDERS (PlaceholderAPI — optional)
================================================================================
Expansion identifier: cryocrates
%cryocrates_keys_<crate>% Virtual key count (e.g. %cryocrates_keys_vote%)
%cryocrates_crate_<crate>% Colored crate display name
%cryocrates_cooldown_<crate>% Remaining open cooldown (formatted time)
%cryocrates_instant_open% Player instant-open toggle (true / false)
%cryocrates_bulk_amount% Player bulk-open amount from main menu
================================================================================
CONFIG & FILES
================================================================================
plugins/CryoCrates/
config.yml Crate definitions, rewards, sounds, storage, physical
locale/en.yml MiniMessage chat messages
guis/main-menu.yml Main hub layout and controls
guis/preview.yml Reward preview GUI
guis/pick.yml Pick-crate selection GUI
guis/csgo.yml CSGO row animation GUI
guis/roulette.yml Roulette animation GUI
data/cryocrates.db SQLite player data (default storage)
libraries/ Runtime-downloaded JDBC / Mongo drivers
Storage types (config storage.type):
sqlite · mysql · mongodb
================================================================================
WHY CRYOCRATES? (highlights)
================================================================================
Full crate stack in one purchase vs typical plugin stacks:
+ Pick, CSGO, and roulette animations in one jar
+ Main menu with keys, preview, instant open, and bulk open
+ Physical crates with holograms and particles
+ Per-crate open cooldowns with bypass permissions
+ Vertex MiniMessage GUIs and locale — no faux styling drift
+ SQLite, MySQL, or MongoDB — drivers fetched at runtime
+ Optional PlaceholderAPI for keys, cooldowns, and settings
+ Paper/Spigot 1.8 → 1.26.x with Folia support
+ $9.99 one-time (not subscription)
================================================================================
SETUP (quick)
================================================================================
1. Drop CryoCrates-1.0.0.jar into plugins/ and restart
2. Edit crate definitions, rewards, and GUI YAML as needed
3. /cryocrates physical set spawn-vote vote (optional world crate)
4. /cryocrates keys give <player> vote 1
5. Players open with /crates
Reload live: /cryocrates reload
================================================================================
Cryo Series — CryoCrates · $9.99 one-time
================================================================================
Pick, CSGO row, and roulette openings — keys, preview,
instant/bulk open, physical crates, and MiniMessage GUIs.
$9.99 USD · one-time · Paper / Spigot 1.8 – 1.26.x · Folia
================================================================================
OVERVIEW
================================================================================
CryoCrates is the Cryo Series crate plugin for Paper and Spigot. Three animation
styles, a player main menu, virtual keys, reward preview GUIs, instant open,
bulk open, per-crate open cooldowns, and world-placed physical crates with
particles and holograms — all in one jar. GUIs and chat use MiniMessage with
the Vertex palette. Optional PlaceholderAPI for scoreboards and menus.
3 animation types | 3 storage backends | Folia supported
YAML GUIs & locale | Hot reload | PlaceholderAPI (optional)
================================================================================
PLATFORMS
================================================================================
Paper · Spigot · Folia
Minecraft 1.8 through 1.26.x
Soft dependency: PlaceholderAPI
================================================================================
FEATURES
================================================================================
[Main menu] /crates hub — crate grid, live key counts, preview shortcuts,
instant-open toggle, bulk-open amount cycle, close button
[Animations] Three crate types per definition:
· pick — choose 1 of N weighted rewards (instant optional)
· csgo — horizontal item row, slow-down near win, win hold
· roulette — single-slot spin with slow-down and win hold
Close mid-animation → pre-rolled reward still grants
[Keys] Virtual keys per crate, stored per player (not physical items)
Give, take, balance check via commands
Keys consumed per open (respects keys-per-open per crate)
[Preview] Framed reward preview GUI — weighted prizes, chance % lore,
open-from-preview button, back to main menu
[Instant open] Per-player toggle in main menu — skips roll screens where
supported (pick crates grant immediately)
[Bulk open] Cycle amounts 1 / 2 / 5 / 10 from main menu — opens in sequence,
one key per open. Cooldown crates force bulk amount to 1
[Cooldowns] Per-crate open-cooldown-seconds (e.g. daily crate = 86400s)
Persisted in database · staff bypass permission per crate
[Physical] Bind crate types to world blocks — particle effects, floating
MiniMessage holograms (per-player on modern versions),
left-click open, right-click preview (configurable)
[Rewards] Weighted reward pools — command lists, optional broadcast
messages on win, custom display items (name/lore/material)
[Storage] SQLite (default), MySQL, or MongoDB — JDBC/Mongo drivers
download at runtime from Maven Central into libraries/
[Locale] Centralized messages.yml with MiniMessage — reload without
restart. Config versioning merges new keys on upgrade
[Sounds] Per-action sounds (menu, roll, win, no-keys, etc.) in config
================================================================================
EXAMPLE CRATES (shipped defaults)
================================================================================
vote type: pick permission: cryocrates.crate.vote
Pick 1 of 3 rewards · 1 key per open · no cooldown
premium type: csgo permission: cryocrates.crate.premium
CSGO row animation · 1 key per open · jackpot broadcast optional
daily type: roulette permission: cryocrates.crate.daily
Single-slot roulette · 1 key per open · 24h open cooldown
Bypass: cryocrates.crate.daily.bypass-cooldown
Custom crates: add under crates.definitions in config.yml — permission
defaults to cryocrates.crate.<id> unless overridden
================================================================================
COMMANDS
================================================================================
Aliases: /crates · /ccrates · /cryocrates
Player
/crates Open main crate menu (same as /cryocrates)
/cryocrates open Open main crate menu
/cryocrates keys List your key balances for all crates
Admin — keys
/cryocrates keys give <player> <crate> [amount]
Give virtual keys (default amount: 1)
/cryocrates keys giveall <crate> [amount]
Give keys to all online players
/cryocrates keys take <player> <crate> [amount]
Remove virtual keys
Admin — physical crates
/cryocrates physical set <id> <crate>
Bind looked-at block (within 5 blocks) as a
physical crate location with hologram + particles
/cryocrates physical remove <id>
Remove a saved physical crate location
/cryocrates physical list List all saved physical crate locations
Admin — maintenance
/cryocrates reload Reload config, locale, GUIs, crates, storage
================================================================================
PERMISSIONS
================================================================================
Base
cryocrates.use Base command access (default: true)
└─ cryocrates.open Open main menu (default: true)
Admin (cryocrates.admin — default: op, grants all below)
cryocrates.reload Reload plugin
cryocrates.keys.give Give keys to players
cryocrates.keys.giveall Give keys to all online players
cryocrates.keys.take Remove keys from players
cryocrates.physical.set Bind physical crate locations
cryocrates.physical.remove Remove physical crate locations
cryocrates.physical.list List physical crate locations
Per-crate (default config — customize per crate in config.yml)
cryocrates.crate.vote Open / see vote crate (default: true)
cryocrates.crate.premium Open / see premium crate (default: true)
cryocrates.crate.daily Open / see daily roulette crate (default: true)
cryocrates.crate.daily.bypass-cooldown
Bypass daily crate open cooldown (default: op)
Custom crates
cryocrates.crate.<id> Gate access to crate <id> (config default)
cryocrates.crate.<id>.bypass-cooldown
Bypass open cooldown for crate <id>
================================================================================
PLACEHOLDERS (PlaceholderAPI — optional)
================================================================================
Expansion identifier: cryocrates
%cryocrates_keys_<crate>% Virtual key count (e.g. %cryocrates_keys_vote%)
%cryocrates_crate_<crate>% Colored crate display name
%cryocrates_cooldown_<crate>% Remaining open cooldown (formatted time)
%cryocrates_instant_open% Player instant-open toggle (true / false)
%cryocrates_bulk_amount% Player bulk-open amount from main menu
================================================================================
CONFIG & FILES
================================================================================
plugins/CryoCrates/
config.yml Crate definitions, rewards, sounds, storage, physical
locale/en.yml MiniMessage chat messages
guis/main-menu.yml Main hub layout and controls
guis/preview.yml Reward preview GUI
guis/pick.yml Pick-crate selection GUI
guis/csgo.yml CSGO row animation GUI
guis/roulette.yml Roulette animation GUI
data/cryocrates.db SQLite player data (default storage)
libraries/ Runtime-downloaded JDBC / Mongo drivers
Storage types (config storage.type):
sqlite · mysql · mongodb
================================================================================
WHY CRYOCRATES? (highlights)
================================================================================
Full crate stack in one purchase vs typical plugin stacks:
+ Pick, CSGO, and roulette animations in one jar
+ Main menu with keys, preview, instant open, and bulk open
+ Physical crates with holograms and particles
+ Per-crate open cooldowns with bypass permissions
+ Vertex MiniMessage GUIs and locale — no faux styling drift
+ SQLite, MySQL, or MongoDB — drivers fetched at runtime
+ Optional PlaceholderAPI for keys, cooldowns, and settings
+ Paper/Spigot 1.8 → 1.26.x with Folia support
+ $9.99 one-time (not subscription)
================================================================================
SETUP (quick)
================================================================================
1. Drop CryoCrates-1.0.0.jar into plugins/ and restart
2. Edit crate definitions, rewards, and GUI YAML as needed
3. /cryocrates physical set spawn-vote vote (optional world crate)
4. /cryocrates keys give <player> vote 1
5. Players open with /crates
Reload live: /cryocrates reload
================================================================================
Cryo Series — CryoCrates · $9.99 one-time
================================================================================
