BloodCrates

A Minecraft plugin for custom reward crates with keys, animations, and configurable loot.

Загрузки: 88
Подписчики: 0
Обновлён: 24 апреля 2026 г.
Лицензия: MIT

Опубликован 24 апреля 2026 г.

Исходный код

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

Ченджлог

1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 24 апреля 2026 г.

📦 Changelog

➕ Added

Phase 15: Player stats system
- Per-player stat tracking
- /bc stats chat command
- GUI stats viewer
- PlaceholderAPI stat placeholders
Phase 14: Debug tracing
- /bc debug on [player]
- /bc debug off
- /bc debug status

🔄 Changed

Player open counts moved to shared stats-backed player data → Keeps limits, broadcasts, pity, and stats fully aligned
server_stats.yml writes are now batched with leaderboard saves → Prevents excessive disk writes on every crate open

📝 Notes

Build passes successfully
2 existing deprecation warnings remain in:
- GUIManager
- BroadcastManager