A Crate Paper Plugin w/Editor, Selectable Rewards, Virtual Keys & More!
Overview
| Stage | Action |
|---|---|
| Create | Define crate / use editor |
| Configure | Rewards, chances, limits, pity |
| Test | Preview + open with keys |
| Deploy | Place crates in-world |
| Monitor | Track stats |
| Debug | Trace issues live |
Features
| System | Details |
|---|---|
| Crates | Random + Selectable |
| Keys | Physical + Virtual |
| Editor | In-game GUI |
| Rewards | Items, commands, economy |
| Control | Cooldowns, pity, limits |
| Stats | Per-player tracking + GUI |
| Debug | /bc debug tracing |
Core Structure
| Component | Role |
|---|---|
| Crates | Define rewards + behavior |
| Keys | Control access |
| Placements | In-world interaction |
Example Flow
/bc editor
→ configure crate
/bc preview <id>
→ test rewards
/bc givekey <id> <player>
→ simulate usage
/bc setcrate <id>
→ place
/bc debug on <player>
Systems
| Type | Description |
|---|---|
| RANDOM | Weighted RNG rewards |
| SELECTABLE | Player chooses reward |
| Key Mode | Description |
|---|---|
| PHYSICAL | Item keys |
| VIRTUAL | Stored keys |
Stats / Debug
| Feature | Command |
|---|---|
| Stats (chat) | /bc stats |
| Stats (GUI) | /bc stats gui |
| Debug on | /bc debug on [player] |
| Debug off | /bc debug off |
| Status | /bc debug status |
Placeholders
%bloodcrates_stats_total%
%bloodcrates_stats_opens_<crateId>%
%bloodcrates_stats_rarest_<crateId>%
%bloodcrates_stats_rarest_chance_<crateId>%
%bloodcrates_stats_last_<crateId>%
Summary
Structured crate system with:
- in-game workflow
- controlled rewards
- stats + debugging built-in
