BloodCrates

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