PixelCrates

# PixelCrates

A standalone crate plugin for Paper with physical crates, keys, roulette animation, and generic **custom-item support**.

## ✨ Features
- **Physical crates** – players open crates by right-clicking a placed block
- **Roulette animation** on opening
- **Key system** with fully customizable key item
- **Full custom-item support** – use *any* item as a reward, including items from Nexo, ItemsAdder, MMOItems, CraftEngine, and other plugins (Base64-serialized, including NBT/PersistentDataContainer)
- **Key shop** via Vault economy
- **Daily crates** with configurable cooldown
- **"One per player" rewards** – limit specific rewards to a single win per player
- **Import from PhoenixCrates** – bring existing crates over
- **Player stats & history**
- **Configurable particle effects** at crate locations

## 📜 Commands
All admin commands require `pixelcrates.admin`:

| Command | Description |
|---|---|
| `/crate create <id>` | Create a new crate |
| `/crate setlocation <id>` | Set the block you're looking at as the crate's physical location |
| `/crate addreward <id> <chance> [rewardId]` | Add the item in your hand as a reward |
| `/crate removereward <id> <rewardId>` | Remove a reward |
| `/crate givekey <player> <id> [amount]` | Give a key |
| `/crate setprice <id> <price>` | Set the key's price for the shop |
| `/crate list` | List all crates |
| `/crate delete <id>` | Delete a crate |
| `/crate reload` | Reload the configuration |
| `/crate importphoenix <id\|all>` | Import from PhoenixCrates |

Players with `pixelcrates.use` (default: everyone) can open crates by right-clicking, provided they're holding the matching key.

## 🔧 Dependencies
- **Vault** (optional) – required for the key shop

## 📥 Importing from other plugins
PixelCrates can automatically import existing crates from **PhoenixCrates** (display name + rewards, including weighting).