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

```text /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

```text %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