KayoCrates

KAYOCRATES

Next-Gen Modular Crates, Portable Lootboxes & Progressive Pity Engine

Natively built for Paper, Purpur & Spigot [1.20.x - 1.21.x] | English & Portuguese (PT-BR) Built-in

[](discord.gg/2fxXhpmCgm)

[](github.com/KayoPlugins/KayoCrates/releases)

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✦ ABOUT THE PROJECT

KayoCrates is a modern, ultra-optimized crate and reward engine designed for high-performance
1.20+ and 1.21+ servers. Say goodbye to bloated legacy plugins, heavy tick loops, and laggy armor stand hacks. KayoCrates brings clean GUI roulettes, virtual inventory management, native TextDisplay floating holograms, and zero-TPS-impact async caching!

In-Game Showcase (GUI Roulette, Virtual Crates & 3D Vault Drop):

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✦ FREE EDITION FEATURES

• Smooth GUI Roulette: Classic inventory roulette opening with authentic sounds, deceleration curve, premature-close protection, and instant delivery.
• Up to 5 Registered Crates: Deploy and manage up to 5 physical block crates simultaneously with fast, transactional SQLite storage (crates.db).
• ️ Virtual Crate Menu (/crates): Clean virtual GUI allowing players to view crates, check keys, inspect drop chances, and open crates directly from anywhere.
• Physical & Virtual Keys: Full support for physical keys (with CustomModelData) and database-backed virtual keys.
• ⚡ Shift + Right-Click Key Storing: Players can sneak and right-click in the air with physical keys in hand to deposit the entire stack directly into their virtual balance!
• ️ Full Inventory Protection (/crate claim): Rewards never vanish if a player's inventory is full or if they disconnect — items are safely stored in pending storage.
• ✨ Native TextDisplays & Ambient VFX: Clean floating 3D text displays over crate blocks with continuous orbital particle rings.
• Built-in Bilingual Support: Defaults natively to English (en_US) with built-in Portuguese (pt_BR) support via config.yml.
• Async PlaceholderAPI Cache: PAPI expansion with a 5-second asynchronous TTL cache for 0 MSPT impact on fast scoreboards.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✦ COMMANDS & PERMISSIONS

Player Commands:

• /crates (aliases: /crate, /caixas, /c) — Opens the virtual crates GUI.
• /crate balance — Displays your virtual key balance for each crate in chat.
• /crate preview <crate> — Opens the preview menu showing rewards, rarities, and percentages.
• /crate claim — Claims any pending rewards stored due to a full inventory.
• Permissions: kayocrates.use (default: true), kayocrates.preview (default: true).

Admin Commands:

• /kayocrates setcrate <id> — Binds the target block you are looking at as a physical crate.
• /kayocrates removecrate — Unlinks and deletes the physical crate block you are looking at.
• /kayocrates givekey <player> <crate> <amount> [physical|virtual] — Grants physical or virtual keys to a player.
• /kayocrates givebox <player> <crate> <amount> — Gives portable lootbox capsules.
• /kayocrates list — Lists all registered crates and their world coordinates.
• /kayocrates cleardisplays — Emergency purge of orphan display entities.
• /kayocrates reload — Reloads configurations, translations, and crate files without restarting.
• Admin Permission: kayocrates.admin (default: op)
• Aliases: /cratesadmin, /kcrates, /caixasadmin

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✦ INSTALLATION

• Download KayoCrates-Free-v1.0.0.jar.
• Drop it into your server's plugins/ folder.
• Start your server to automatically generate config.yml, messages_en.yml, messages.yml, and default crates.
• Aim at any block and type /kayocrates setcrate comum to deploy your first crate!

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

UNLOCK CINEMATIC 3D ANIMATIONS WITH KAYOCRATES PREMIUM

Designed for networks and competitive servers that demand unforgettable reward experiences.

Premium Edition Exclusives:
✔ 3D Vault Drop & Spatial Animations (Monumental bank safe drops from the sky, ground shockwave, titanium wheel unlocking, and opening door)

✔ Unlimited Registered Crates (Bypass the 5-crate cap)

✔ Progressive Pity System (Anti-bad-luck engine guarantees high-tier drops after X unlucky openings)

✔ Multi-Roll Rewards (Configure dynamic reward ranges: rolls: min: 1, max: 3)

✔ Cross-Server MySQL & HikariCP (Instant key sync across BungeeCord & Velocity networks)

✔ 100% White-Label & Custom Menus (Fully customize menus/virtual.yml size: AUTO, 27, 45, 54, custom lores, and remove branding)

✔ Paginated Drop History GUI (Displays winner player heads, rarities, and timestamps)

✔ Opening Milestones (Automatic server broadcasts and console commands upon reaching crate milestones)

Get your lifetime copy with dedicated support on our Discord:

CLICK HERE TO JOIN KAYOPLUGINS DISCORD

⚠ Please do not report bugs in the Reviews section. For technical support (EN/PT-BR), open a ticket on our official Discord.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✦ PLACEHOLDERAPI EXPANSION

The plugin natively registers the
%kayocrates_...% identifier:

• %kayocrates_keys_<crate>% — Total keys owned by player (Virtual balance + Physical keys in inventory).
• %kayocrates_keys_virtual_<crate>% — Only virtual database keys for the specified crate.
• %kayocrates_keys_physical_<crate>% — Only physical keys held in the player's inventory.
• %kayocrates_pending% — Total unclaimed rewards waiting in /crate claim.
• %kayocrates_opened_total% — Lifetime total crates opened by the player. (Premium)
• %kayocrates_pity_<crate>% — Current progress toward the guaranteed pity drop. (Premium)
• %kayocrates_pity_max_<crate>% — Pity threshold required for the guaranteed drop. (Premium)