Overview
A feature-rich Paper crate plugin built around the real workflow server owners actually need — from creation to placement, key distribution to live debugging.
What is BloodlineCrates?
BloodlineCrates is a Paper 1.21 crate plugin designed around a complete admin workflow rather than just a reward menu. Every part of the system — creation, key management, in-world placements, reward tuning, stats tracking, and live debug tracing — is accessible without leaving the game.
Whether you're building a simple loot system or a multi-crate economy with selectable rewards, pity systems, cooldowns, and leaderboards, BloodlineCrates provides the tooling to do it cleanly.
Features
Crate Types
Every crate is configured as one of two types:
- → Classic RNG opening flow
- → Weighted prize pools
- → Rare jackpot hits
- → Spin animations supported
- → Players choose their reward
- → Battle pass style claim menus
- → Premium reward selectors
- → Visual icon grids
Key Modes
Each crate uses exactly one key mode. You can switch the mode inside the in-game editor at any time.
Real inventory items given via /bc givekey. Players must have the item in their inventory to open the crate.
Stored in player data. Given via /bc givevirtualkey. No inventory slot required.
PlaceholderAPI
BloodlineCrates supports PlaceholderAPI with the following stat placeholders:
| Placeholder | Description |
|---|---|
| %bloodcrates_stats_total% | Total crate opens across all crates |
| %bloodcrates_stats_opens_<crateId>% | Opens for a specific crate |
| %bloodcrates_stats_rarest_<crateId>% | Rarest reward won from that crate |
| %bloodcrates_stats_rarest_chance_<crateId>% | Chance of that reward |
| %bloodcrates_stats_last_<crateId>% | Last reward won from that crate |