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